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.

What you can change

• Drawing defaults: color, thickness, marker opacity, fill, font family/weight/style, text background
• 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
• 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
• 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).

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