Environment Variables

Wayscriber supports optional environment overrides.

Core overrides

WAYSCRIBER_NO_TRAY=1 disables the system tray in daemon mode.
WAYSCRIBER_TRAY_FORCE_PIXMAP=1 disables themed tray icons (useful for Noctalia/Quickshell).
WAYSCRIBER_RESUME_SESSION=1/0 forces session resume on or off for the current run.
WAYSCRIBER_CONFIGURATOR=/path/to/wayscriber-configurator sets the configurator path.

WAYSCRIBER_ENABLE_PORTAL_SHORTCUTS=1 opts the daemon into KDE/portal global shortcut handling.
WAYSCRIBER_PORTAL_SHORTCUT=Meta+Shift+D stores the shortcut label used by the portal setup.

WAYSCRIBER_LOG_FILE=/path/or/dir writes overlay logs to a specific file or directory.
WAYSCRIBER_LOG_MAX_SIZE_MB=10 caps each log file before rotating to a new one.

WAYSCRIBER_XDG_OUTPUT=NAME selects a preferred output by name.
WAYSCRIBER_XDG_FULLSCREEN=1 requests fullscreen overlay.
WAYSCRIBER_XDG_FULLSCREEN_FORCE=1 forces fullscreen even if GNOME warns about opacity.

WAYSCRIBER_FORCE_INLINE_TOOLBARS=1 forces inline toolbars.
WAYSCRIBER_TOOLBAR_DRAG_PREVIEW=0 disables inline toolbar drag preview.
WAYSCRIBER_TOOLBAR_POINTER_LOCK=1 enables pointer-lock drag path (experimental).
WAYSCRIBER_TOOLBAR_DRAG_THROTTLE_MS=12 throttles toolbar drag updates; set 0 to disable throttling.
WAYSCRIBER_TOOLBAR_DRAG_HANDOFF_MS=250 controls the drag handoff timeout.
WAYSCRIBER_DEBUG_DAMAGE=1 enables debug damage output.
WAYSCRIBER_DEBUG_TOOLBAR_DRAG=1 enables toolbar drag logging.
WAYSCRIBER_DEBUG_TOOLBAR_COLOR=1 enables toolbar color-picker logging.
RUST_LOG=info enables Rust logging (use wayscriber=debug for app-level logs).