Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Release Notes

These docs track the latest source. Current source version: v0.9.23.

v0.9.23 highlights

  • Runtime UI preferences now live in runtime-ui.toml, while config.toml remains the authored configuration. Saves preserve comments and formatting, write only the setting that changed, detect races and external edits, and keep rollback and recovery paths safe.
  • The annotation workspace has a new top-strip layout with configurable status-bar contents, Focus Mode, persistent chrome controls, a layout-cycle button, discoverable hidden controls, improved popover navigation, and a zoom-control surface.
  • Text tools now support Wayland IME input, key repeat, caret editing, selection, and clipboard operations. The configurable input HUD can show keystrokes and clicks during presentations.
  • Drawing tools gained tapered arrows, blur-redaction styles, a spotlight tool, RGBA colors, and persistent recent colors.
  • About and update notices are more useful and privacy-conscious, with opt-out controls and diagnostics. Release binaries now embed GTK4 layer-shell support, with Nix packaging parity checks and broader daemon, capture, and event-loop reliability improvements.

About window and update notices

  • The About window was rebuilt: themed chrome that follows [ui] theme, an icon header with version and build metadata, keyboard-navigable link rows (Tab/Enter/Esc), and a “Copy diagnostics” button that puts build, install source, desktop, and compiled features on the clipboard in one paste. The window now sizes itself to its content.
  • Links point only at wayscriber.com — website, documentation, release notes, and update instructions. The GitHub link is gone.
  • Wayscriber can now tell you that a newer release exists. It never installs anything: the notice appears as a card in the About window, an item in the tray menu, and at most one desktop notification per release (suppressed while the overlay is active), each opening the Updating instructions for your install method.
  • The check is one HTTPS request for a static file, made through the system curl/wget, with no Wayscriber or user identifier; the HTTP client’s version is suppressed too. Configure it under [updates], disable it per run with WAYSCRIBER_DISABLE_UPDATE_CHECK=1, or compile it out entirely with WAYSCRIBER_NO_UPDATE_CHECK=1.
  • wayscriber --check-update runs the check on demand and prints the result.
  • About is reachable from the overlay itself now: a chrome button on the top strip (hideable from Customize), an entry in the overflow’s Settings… popover, a clickable pill in the F1 help overlay footer, and a command-palette entry. The bindable action is open_about, unbound by default. Opening About closes the overlay, since About is a normal window and the overlay draws above those.

Interface overhaul

  • The default UI is now a set of detached top-strip islands with a contextual style pill instead of a permanent side palette. The pill follows the active tool and hosts color, size, opacity, fill, text, eraser, and selected-object controls.
  • A 3–5-slot presets island sits between Tools and History. Filled slots apply saved profiles; empty slots save the current profile. Quick colors now live only in the style pill.
  • The status bar is an interactive chip HUD: board/page, color, tool, and Help segments open their corresponding surfaces. Frozen, zoom, pan, and editing states stack above it as badges.
  • F2 cycles the top strip full → micro chip → hidden. F9 directly toggles toolbar visibility. Idle islands fade after four seconds and respect reduced motion.
  • Clear moved into overflow: click for a brief Undo action, or Shift+click to clear immediately. Canvas, Session, and Settings open from overflow popovers. Canvas contains Boards, Pages, Advanced, Zoom, and Step Undo/Redo sections.
  • A persistent bottom-right zoom chip shows the live percentage with zoom-out, zoom-in, Fit, and (while zoomed) Lock controls. It follows the existing show_zoom_actions toggle, so no new config key is required.
  • side_layout = "panel" temporarily restores the deprecated four-pane side palette; layout_mode remains the independent Simple/Regular/Advanced complexity setting. Panel users receive a once-per-session map to every replacement surface.

Runtime UI preferences

  • Direct overlay preferences now survive restarts without broad config.toml rewrites. Toolbar pin/minimized state, the active legacy pane and collapsed sections, individual item visibility/order, and board pins live in generated $XDG_DATA_HOME/wayscriber/runtime-ui.toml state; configured values remain the authored startup defaults.
  • Runtime-state writes detect external file changes, symlink/path retargeting, and uncertain write outcomes instead of overwriting blindly. The overlay blocks further runtime preference changes when recovery is required.
  • Overlay Settings shows the complete state and recovery-artifact paths and provides retry, adopt-disk, reset, and invalid/unsupported-file recovery flows. Newer formats stay read-only, and destructive reset requires confirmation after preserving the original bytes.

Faster tool selection

  • The radial menu is now an eight-direction fixed compass. Hold middle-click, flick toward a tool, and release to commit; a center release cancels.
  • The opened menu includes tool glyphs and live shortcut badges, a catalog-backed shape sub-ring, recent colors, and a draggable outer size ring.
  • An optional ink-preview cursor shows the current color and width, active tool glyph, and an automatic contrast outline.

Finding features and shortcuts

  • The command palette adds action icons, category headers, fuzzy matching, shortcut editing, Save Preset 1–5 actions, responsive query updates, and recents persisted across restarts.
  • The Help overlay is fuzzy-searchable, clickable, and limited to one or two columns. Its footer can replay the guided tour.
  • The tour reads current keybindings instead of hard-coded shortcuts and now teaches color/thickness changes, radial flicking, and Boards & Pages. Staggered later-session hints introduce the status-bar picker, Canvas popover, and zoom chip. A rate-limited shortcut coach can offer occasional hints afterward.
  • Notifications now prioritize critical warnings and undo actions over routine info and hints, with deduplication and rate limits.

Appearance and accessibility

  • Overlay and toolbar chrome share one accent and token-driven dark/light theme.
  • [ui] reduced_motion = "on" disables UI animation. auto is reserved for future system-preference detection and currently leaves motion enabled.
  • Swatches, keycaps, popovers, panels, and selection states use shared visual primitives across the GTK4 and builtin Cairo toolbar frontends.

Other recent additions

  • The screen eyedropper samples the displayed desktop through a magnified pixel loupe. Press I, use the contextual color controls, or search the command palette.
  • Light passthrough defaults to F6 while the overlay has focus; compositor/global wayscriber --light-* commands remain the reliable way to control it after input is passing through.
  • Default builds use GTK4 toolbars on supported layer-shell compositors and fall back to the builtin Cairo frontend where that path cannot run.

Release history is maintained on GitHub: