First Run and Keybinds
Wayscriber has two run modes:
One shot mode
Start the overlay immediately and exit when you are done.
wayscriber --active
Good for quick callouts or testing.
Daemon mode
Run in the background and toggle the overlay when needed.
wayscriber --daemon
If you have the user service installed:
systemctl --user enable --now wayscriber.service
Add a keybind that sends SIGUSR1 to toggle the overlay:
bind = SUPER, D, exec, pkill -SIGUSR1 wayscriber
Default keys you should know
- F1 opens help (F10 is the alternative)
- Shift+F1 opens the quick reference
- F2 or F9 toggles the toolbars
- F11 opens the configurator (if installed)
- F4 toggles the status bar (F12 is the alternative)
- Ctrl+Shift+F freezes/unfreezes the screen
- Ctrl+Shift+M toggles presenter mode
- Ctrl+Shift+H toggles click highlights
- Ctrl+K opens the command palette
- Ctrl+Shift+B opens the board picker
- Ctrl+Alt+Shift+Left/Right moves overlay focus to previous/next output
- V toggles the selection tool
- Hold Alt and drag to select/move shapes
- Ctrl+D duplicates selected shapes
- Delete removes selected shapes
- Escape or Ctrl+Q exits the overlay
Guided tour and quick help
- First launch shows a short guided tour. Space/Enter advances, Backspace goes back, Escape skips.
- Replay it from the command palette: Ctrl+K, then search for “Replay Tour”.
- For output actions, open the command palette and search for “monitor” or “display”.
- The full help overlay supports search; just start typing to filter shortcuts.