diff --git a/docs/wiki/FAQ.md b/docs/wiki/FAQ.md index 9134fc7c..e8235566 100644 --- a/docs/wiki/FAQ.md +++ b/docs/wiki/FAQ.md @@ -109,3 +109,18 @@ To fix this, you can: - Use `focus-follows-mouse max-scroll-amount="0%"`, which will prevent `focus-follows-mouse` from triggering when it would cause scrolling. - Set `prefer-no-csd` which will generally cause clients to remove those resizing margins. + +### How do I recover from a dead screen locker / from a red screen? + +When your screen locker dies, you will be left with a red screen. +This is niri's locked session background. + +You can recover from this by spawning a new screen locker. +One way is to switch to a different TTY (with a shortcut like CtrlAltF3) and spawning a screen locker to niri's Wayland display, e.g. `WAYLAND_DISPLAY=wayland-1 swaylock`. + +Another way is to set `allow-when-locked=true` on your screen locker bind, then you can press it on the red screen to get a fresh screen locker. +```kdl +binds { + Super+Alt+L allow-when-locked=true { spawn "swaylock"; } +} +```