Compositor Guides
Hyprland
Daemon mode with a toggle keybind:
exec-once = wayscriber --daemon
bind = SUPER, D, exec, wayscriber --daemon-toggle
Reload Hyprland with hyprctl reload.
Define the toggle binding only once. If Hyprland does not resolve wayscriber from PATH, use the absolute path from command -v wayscriber.
GNOME
Use Settings -> Keyboard -> Custom Shortcuts.
Choose one of these commands:
- One shot:
wayscriber --active - Daemon toggle:
wayscriber --daemon-toggle(run the daemon first)
If you want fullscreen on GNOME, set WAYSCRIBER_XDG_FULLSCREEN=1. If GNOME renders fullscreen as opaque, leave it off or force it with WAYSCRIBER_XDG_FULLSCREEN_FORCE=1.
To target a specific monitor, set WAYSCRIBER_XDG_OUTPUT to a matching output name.
KDE
Use System Settings -> Shortcuts -> Custom Shortcuts.
Choose one of these commands:
- One shot:
wayscriber --active - Daemon toggle:
wayscriber --daemon-toggle(run the daemon first)