Multi Monitor Tips

What this feature is for

• Keep one annotation workflow while moving focus between displays.
• Preserve per-display canvas/session state when session.per_output = true.
• Keep toolbar + status UI aligned with the output you are actively drawing on.

Default shortcuts

• Previous output: Ctrl+Alt+Shift+ArrowLeft
• Next output: Ctrl+Alt+Shift+ArrowRight
• Command palette: Ctrl+K, then search monitor or display

Config knobs

• ui.multi_monitor_enabled = true enables output focus cycling.
• ui.active_output_badge = true shows current output in the status bar.
• session.per_output = true keeps separate session files per monitor.
• ui.preferred_output = "eDP-1" (optional) pins GNOME fallback to a target monitor.

GNOME / xdg fallback

• Output naming is compositor-dependent. Use ui.preferred_output (or env override) when startup monitor choice is not what you want.
• Env override: WAYSCRIBER_XDG_OUTPUT=<output-name>

Quick test checklist

1. Start on monitor A and draw a few strokes.
2. Press Ctrl+Alt+Shift+ArrowRight to move output focus to monitor B.
3. Confirm toolbar/status now render on monitor B.
4. Draw on monitor B, then switch back with Ctrl+Alt+Shift+ArrowLeft.
5. Confirm monitor A canvas is intact and monitor B canvas is unchanged.

Troubleshooting

• Output switch does not trigger: verify ui.multi_monitor_enabled = true.
• Wrong display on GNOME: set ui.preferred_output or WAYSCRIBER_XDG_OUTPUT.
• Unexpected cross-monitor canvas restore: confirm session.per_output is set the way you want.