FAQ: Mention how to escape from a dead screen locker

This commit is contained in:
Ivan Molodetskikh
2025-09-24 08:30:07 +03:00
parent 3850739e44
commit e837e39623

View File

@@ -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 <kbd>Ctrl</kbd><kbd>Alt</kbd><kbd>F3</kbd>) 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"; }
}
```