Configurator (GUI)

Wayscriber has a native configurator for editing settings without touching the config file.

Launch

• Press F11 inside the overlay
• Or run wayscriber-configurator

If the configurator is not installed, install wayscriber-configurator or point to it with WAYSCRIBER_CONFIGURATOR.

Search and navigation

The search field is meant for direct keyboard use:

• Start typing after launch to filter settings.
• Press Ctrl+F to focus search again.
• Press Escape in search to clear it and keep typing.
• Search matches tabs, sections, saved sessions, boards, render profiles, presets, and keybinding names.
• Scoped searches work, for example ui toolbar blur, session lecture, keybinding capture, or preset red.

When a result belongs to a nested settings page, selecting it opens the matching tab or subtab.

What you can change

• Drawing defaults: color, thickness, marker opacity, fill, font family/weight/style, text background, drag tool bindings
• Arrow settings: length, angle, head placement
• Performance: buffer count and vsync
• UI: status bar toggle/position/style, help overlay styling, click highlight settings (including highlight ring), frozen badge, context menu
• UI toolbar: layout mode, section visibility (pages, presets, actions, step controls), marker opacity slider, preset toasts, per-item visibility, and saved toolbar order
• History: undo/redo delay playback and Step control defaults
• Board modes (legacy): enable, default mode, board colors, auto adjust pen color
• Capture: enable, save directory, filename template, format, clipboard behavior, exit after capture
• Session: per mode persistence, restore tool state, per output, storage mode, size limits, compression, backups, and named-session catalog management
• Presets: edit slot definitions and defaults
• Keybindings: edit all shortcuts by category

Note: full multi-board setup lives under [boards] in config.toml and currently needs manual editing (or the in-app board picker with boards.persist_customizations = true).

Toolbar editing

The UI tab controls broad toolbar behavior such as layout mode, pinned startup state, icon-only mode, section toggles, context-aware UI, offsets, and force-inline mode.

The UI -> Toolbar Visibility subtab controls individual toolbar items. Checked means shown. Uncheck an item to remove it from toolbar sizing, drawing, and hit testing. Existing mode presets and section toggles can still hide checked items.

Order controls are available for:

• Top tools
• Top controls
• Side sections

Use the up/down controls to move an item within its group, or reset a group back to the built-in order. The same saved order is written to ui.toolbar.items.order in config.toml.

Overlay toolbar customization

The overlay also has toolbar customization from the side toolbar:

• Open the Settings drawer, then use Customize toolbar or the Customize tab.
• Pick a group such as Top tools, Top controls, Side sections, Actions, Pages, Boards, Presets, Tool options, or Sessions.
• Toggle items to show/hide them.
• Move supported Top tools, Top controls, and Side sections up/down or drag rows to reorder them.
• Reset hidden items or reset an order group when you want the defaults back.

The side toolbar also has a Sections tab for section-level toggles, and side sections can be collapsed from their headers while working.

The screenshot toolbar button is hidden by default. Enable top.utility.screenshot from Toolbar Visibility or remove it from ui.toolbar.items.hidden in TOML to show it.

Session catalog

The Session tab manages both default persistence settings and the named-session catalog. Named sessions are recorded when they are opened or saved from the CLI, daemon, or overlay Session panel. See Sessions and Session Manager for the full workflow.

Catalog actions:

• Save Name changes only the display label.
• Reveal File opens the session file location.
• Forget removes catalog metadata without deleting the files.
• Duplicate copies an inactive session to a new named target.
• Move relocates an inactive session file and its non-lock sidecars.
• Clear Saved Data removes saved data for that catalog entry.

Duplicate, Move, and Clear are disabled while an overlay, manually started daemon, or background service is active. Stop the overlay or service before doing offline file maintenance from the configurator.

Workflow

• Reload: re-read the config from disk
• Defaults: load built-in defaults without saving
• Save: validate inputs and write the config with a backup