OdyTTY█

Compatibility Tests

Unit and integration tests cover parser state, terminal behavior, settings, themes, keybindings, graphics placement, mouse protocols, cross-platform-safe harness paths, and CLI introspection. A retained compatibility corpus, pinned conformance runner, and bounded real-application matrix keep unavailable, skipped, unsupported, and executed surfaces distinct.

Smoke And Fuzz Tiers

PTY smoke, pixel smoke, GPU composite smoke, transcript smoke, protocol fuzz, and ignored deep fuzz tiers are available for the paths that need real process, rendering, or randomized evidence, and CI runs the matrix on every push.

Performance Evidence

cargo bench --bench perf tracks parser/feed/reflow/geometry behavior. The app also carries optimized resize, retained-frame, reusable vertex storage, and lazy scrollback paths. Dated implementation measurements are not presented as cross-terminal product comparisons.

Saved Layouts & Restore

Save All Workspaces as Layout captures the whole application — every workspace, tab, split, working directory, and host binding — while Save Workspace as Layout… saves just one workspace on its own; both are reachable from the rail's right-click menu, the terminal content menu, and the palette. Open a saved layout later with Replace (tear down the current workspaces and install the saved set) or Add (append it beside the current ones). With restore_workspaces on (off by default), launching odytty reopens the previous window shape automatically. The first window owns restore and autosave; secondary windows run independently and neither restore nor overwrite that primary saved state. A companion shell_exit_closes setting picks what happens when a shell exit would empty a workspace — close that workspace (the default, matching the cascade) or quit OdyTTY — so pairing "quit closes the app" with "next launch restores everything" is a two-knob configuration. Snapshots record structure only: fresh shells at their directories, never replayed output.

Remote Terminals

Ctrl+Shift+S opens the connection manager: quick-connect saved hosts via the system ssh (keys stay with your agent), bind a workspace to a host, or edit OdyTTY-owned entries in hosts.conf. Opt-in OpenSSH ~/.ssh/config host-name import is read-only and name-only (imported rows can be connected to but not edited). Opt-in knobs carry shell integration onto the remote, reuse one authenticated connection across tabs on Unix clients (Windows authenticates each connection independently), persist it in tmux, hold a dropped tab open with a reconnect prompt, and confirm-first paste an image up to the host.

Command Palette

Ctrl+Shift+P opens a fuzzy command palette over actions, settings, shell history, recent directories, workspace and layout commands, and saved hosts. A presentation-only overlay — it never blocks or intercepts the PTY.

Settings Without Hand Editing

Ctrl+Shift+, opens Settings. Rows live-apply, / filters, and Ctrl+S writes changed keys back to odytty.conf while preserving comments, blank lines, unknown keys, and ordering. Invalid values are refused with diagnostics rather than silently replacing the active resolved setting.

Pickers And Builders

The theme picker, font picker, keybinding editor, and theme builder are native overlays. The theme builder can clone, tweak, live-preview, and save user themes through the same dependency-free .theme format as the built-ins.

Prompt-Aware Actions

OSC 133 prompt marks power command navigation, clear editable input, context-menu actions, and a per-command command-status gutter that colors each command's left rail by its exit status in single, split, and nested pane layouts. A core range helper exists for selecting one command's output, but no UI action exposes it yet. Shell integration and the gutter are on by default. Clicking in the typed command line moves the shell cursor there (rune-precise, on by default), and deleting a selection inside the prompt edits the real command line — exact with the bundled zsh integration, conservatively clamped elsewhere. On graphical Unix launches without SHELL, OdyTTY resolves the effective user's login shell through passwd/NSS before its final /bin/sh fallback, so the appropriate integration still loads. OdyTTY never sends edit bytes it cannot justify. OdyTTY injects integration for Bash, Zsh, Fish, and Windows PowerShell/pwsh; cmd.exe has no supported OSC 133 hook surface, while Nushell users configure its native OSC 133/7/2 and Kitty-protocol support in Nushell itself.

Tab And Workspace Menus

Right-click a tab for New Tab, Rename Tab, Duplicate Tab (clones the focused tab's shell and cwd; also a bindable duplicate-tab action), Close Other Tabs, Connect to Host… (opens a saved SSH host in a new tab), Replace with Host… (opens it in-place, confirming first if a program is running), Move to Workspace… when more than one workspace exists, and New Window. Right-click a rail slot for new, duplicate, rename, close, Move Up / Move Down, bind/unbind host, layout-save, and Settings actions. Bindable actions can be remapped in the keybinding editor; layout, host-binding, and reorder actions remain palette- or menu-driven.

Text Pipeline

Bundled Victor Mono ships as the default at 20 logical pixels, with JetBrains Mono also bundled and selectable. Users can select system font families, direct font files, weight variants, line height, synthetic styles, text gamma, stem darkening (on by default at 0.7), and optional RGB/BGR subpixel AA with grayscale fallback. Color composes in linear light before glyph coverage is applied. Programming ligatures are on by default: the bundled font's ASCII contextual alternates render through OpenType shaping while the grid stays one logical cell per character, so copy, selection, search, and cursor placement are unchanged; a font without them — or ligatures = off / ODYTTY_LIGATURES=off — falls back to the plain per-cell renderer.

Glyph And Symbol Handling

The dynamic atlas uses bearing-aware glyph quads, HiDPI-aware rebuilds, wide-cell handling, procedural box/block/shade, Braille, Powerline, and sextant/octant rendering, box-thickness tuning, bundled Nerd Font v3/v2 symbol fallback, host fallback, and per-range symbol_map overrides. Decomposed clusters — a base letter plus a zero-width combining accent — draw the accent over the base cell and keep it when copied from scrollback and live selection alike (up to four marks per cell, where the font provides them).

Color Emoji

Color emoji use swash and a dedicated premultiplied-RGBA atlas. Noto Color Emoji CBDT/CBLC works on Linux and Windows when installed in a searched system or per-user font directory, and Apple Color Emoji sbix works on macOS, with flags, keycaps, skin tones, variation selectors, and common ZWJ clusters. Stock Windows uses the monochrome fallback because Segoe UI Emoji is not discovered or rasterized by the current path. OdyTTY does not bundle Noto Color Emoji on Windows. Emoji pixels are not SGR-tinted.

Cursor, Motion & Effects

The cursor is OdyTTY's v0.9 signature, and its motion ships on by default. Fresh profiles open a blinking Block cursor that glides between adjacent cells and snaps instantly on large jumps, resizes, and scrollback navigation. A jump beyond the short glide range sends one cursor-shaped follower that stretches toward the target and settles, under a subtle / balanced / expressive profile (cursor_trail_strength, balanced by default) with a brief fading trail. Blinking yields to typing — keyboard and IME activity hold it visibly on, blinking resumes after a short quiet period, and it parks solid when idle so nothing keeps redrawing. A restrained shape-aware glow traces the actual Block, Bar, or Underline geometry in the resolved cursor color; its strength is adjustable on an independent cursor_glow_intensity scale (0.0–1.0, default 0.5), separate from the whole-scene bloom. An unfocused Block cursor becomes a hollow outline, and in a split every part of this runs only in the focused pane and never wakes an idle one. All of it is presentation-only: the logical cursor, selection, copy, and terminal input reach their destination immediately. reduced_motion = on is one explicit switch that snaps the cursor slide, trail, glow, blink fade, and new-output fade to static without overwriting their saved settings — a config setting, not an OS preference, and it leaves cursor blinking, smooth scrolling, and ligatures untouched.

Bloom, CRT, retro, curvature, padding, borders, and backgrounds are settings-backed too. The retro preset keeps its scanlines, bloom, and vignette but does not force curvature: crt_curvature = 0.0 is the flat default and is exposed only through config or ODYTTY_CRT_CURVATURE, not the Settings panel. Scrollback uses an animated glide between wheel notches (default on, six rows per notch) with a pixel-precise continuous lane for touchpads and high-resolution wheels; the glide follows split panes at sub-cell precision, and copy across the full selection works cleanly across the scrollback. A bundled "Dark Waves" background image ships behind the grid by default — set background_treatment = color to turn it off. Window transparency (window_transparency + window_opacity, translucent down to 20% opacity) makes the background translucent while text, the cursor, selection, and every overlay stay fully opaque (window_transparency = on and window_opacity = 80 by default; needs a compositing window manager, and a configured background image composes over the desktop too). render_quality = plain bypasses post-processing and visual treatments.

When wheel_zoom is enabled and the running application has not claimed mouse reporting, effective Ctrl+wheel steps show the current font size in the same static, bounded readout used for terminal dimensions. Repeated steps replace the value; the readout clears without an animation phase or idle wakeup.

Kitty Graphics & Sixel

The supported Kitty APC still-image surface (chunking, image and placement ids, crop, scaling, pixel offsets) and a complete Sixel data language, with hard caps of 10,000 × 10,000 pixels or 40 million total pixels. The exact action / transport / placement matrix is in protocols.

Draw Order

Render order follows the Kitty model: cell backgrounds, negative-z images, glyphs and decorations, color emoji, then non-negative-z images. Primary and alternate screens maintain independent placement scenes.

File Transport Safety

Kitty direct and chunked-inline transfers are always available. The named file, temp-file, and POSIX shared-memory transports are off by default behind kitty_named_transports — a local host-I/O authority grant to enable only when the whole PTY session, including SSH output, is trusted; with the gate off they are rejected before any file or shared-memory I/O. When enabled on Unix they stay confined by a temp-directory allowlist, reject symlinks (O_NOFOLLOW) and non-regular objects, require the protocol marker with delete-before-decode for temp files, validate shared-memory objects before shm_unlink, and cap size before decode. Windows applies the corresponding final-component reparse-point rejection. Full rationale is in OdyTTY's docs/graphics.md.

In-App Image Viewer

Separate from the wire protocols: Ctrl/Cmd+click opens a file (path:line:col jumps an editor), right-click adds “Open With…” / Copy Path / Reveal, and Ctrl/Cmd+click a resolved png/jpg/jpeg/webp path (or pick “Open in OdyTTY”) and it opens in a presentation-only lightbox drawn above the CRT/bloom post-pass, so effects never touch the photo. Decode is bounded before it runs; Esc or a click outside dismisses. Opt-in, behind the interactive_paths gate; clicking bare URLs is governed by the separate interactive_urls knob (on by default).