-
-
Notifications
You must be signed in to change notification settings - Fork 113
Configuration: Switch Events
github-actions[bot] edited this page Oct 18, 2024
·
1 revision
Switch event bindings are declared in the switch-events {}
section of the config.
Here are all the events that you can bind at a glance:
switch-events {
lid-close { spawn "bash" "-c" "niri msg output \"eDP-1\" off"; }
lid-open { spawn "bash" "-c" "niri msg output \"eDP-1\" on"; }
tablet-mode-on { spawn "bash" "-c" "gsettings set org.gnome.desktop.a11y.applications screen-keyboard-enabled true"; }
tablet-mode-off { spawn "bash" "-c" "gsettings set org.gnome.desktop.a11y.applications screen-keyboard-enabled false"; }
}
The syntax is similar to key bindings.
Currently only the spawn
action are supported.
Note
In contrast to key bindings, switch event bindings are always executed, even when the session is locked.
These events correspond to closing and opening of the laptop lid.
You could use them to turn the laptop internal monitor off and on (until niri gets this functionality built-in).
switch-events {
lid-close { spawn "bash" "-c" "niri msg output \"eDP-1\" off"; }
lid-open { spawn "bash" "-c" "niri msg output \"eDP-1\" on"; }
}
These events trigger when a convertible laptop goes into or out of tablet mode. In tablet mode, the keyboard and mouse are usually inaccessible, so you can use these events to activate the on-screen keyboard.
switch-events {
tablet-mode-on { spawn "bash" "-c" "gsettings set org.gnome.desktop.a11y.applications screen-keyboard-enabled true"; }
tablet-mode-off { spawn "bash" "-c" "gsettings set org.gnome.desktop.a11y.applications screen-keyboard-enabled false"; }
}