add lockscreen support

This commit is contained in:
Henry Hiles 2026-11-17 20:11:17 -05:00
commit 79d36e01be
Signed by: Henry-Hiles
SSH key fingerprint: SHA256:VKQUdS31Q90KvX7EkKMHMBpUspcmItAh86a+v7PGiIs

View file

@ -22,6 +22,10 @@ It's also the notification server. New notifications pop up under the bar for a
until you dismiss them if they're urgent. Swipe one up to put it away early. Swipe a notification
sideways to dismiss it, in the sheet or as a popup, and tap it to open it.
And it's the lockscreen. It locks as soon as it starts, when logind asks it to (before
suspending, or with `loginctl lock-session`), and with `qs ipc call lock lock`. The lockscreen
has the clock, a password field and your notifications.
## Using it
The flake has a `quadshell` package, and an overlay that adds it to nixpkgs:
@ -36,11 +40,17 @@ Then start it with niri, in your niri config:
spawn-at-startup "quadshell"
```
To have your wallpaper blurred behind the lockscreen, use
`pkgs.quadshell.override { wallpaper = ./background.jpg; }`. It sets `QUADSHELL_WALLPAPER`,
which you can also set yourself, or before `nix run .#phone` to a path on the phone.
It brings `nmcli`, `mmcli`, `nmgui` and `adw-bluetooth` with it. The system needs:
- niri, NetworkManager and ModemManager running
- systemd-logind, which the flashlight uses to set the LED without root
- The `login` PAM service, which checks the lockscreen's password
- The Papirus-Dark icon theme and the Inter font
- An on-screen keyboard that uses text-input-v3, like Stevia, to type the password
- No other notification daemon, like swaync or mako, as only one can run at a time
## Developing