Overlay vs Daemon
Overlay (one shot)
- Starts immediately and exits when you close it
- Simple and predictable
- Best for quick annotations
- Can open a named session with
--session-file
Command:
wayscriber --active
wayscriber --active --session-file ~/Documents/lecture-04.wayscriber-session
Daemon (background)
- Runs in the background and keeps your drawings between toggles
- Faster to access during presentations
- Works well with a keybind
- Can be targeted by named-session toggle requests
Command:
wayscriber --daemon
wayscriber --daemon-toggle
wayscriber --daemon-toggle --session-file ~/Documents/meeting.wayscriber-session
If installed, the systemd user service is the most reliable way to keep the daemon running. Use only one compositor/global toggle binding; duplicate bindings can fire twice and immediately undo the toggle.
Overlay UI
The side toolbar is where most runtime UI management lives:
- Canvas drawer: pages, boards, actions, zoom, and tool-specific controls.
- Session drawer: Open, Save As, Info, Clear, recent sessions, and Manager. See Sessions and Session Manager for named-session workflows.
- Settings drawer: status/toolbar toggles, config file/configurator shortcuts, and toolbar customization.
- Sections tab: quick section-level toggles for side toolbar blocks.
- Customize tab: show/hide individual toolbar items and reorder supported groups.
Side toolbar sections can be collapsed from their headers while working. Toolbar
customization changes are saved to config.toml, so the next overlay or daemon start
keeps the same visible items and order.