Lock screen
[lock] and its subtables set what the lock screen shows.
The screen locks when you ask it to, for example with loginctl lock-session or from the session menu, and before the computer sleeps. If its password checks fail, it refuses to lock and warns you instead. To lock after a period of inactivity, add a listener to [idle].
Lock screen
[lock]backgroundtableYour lock screen's background image and color.
Its settings are listed under [lock.background].
notificationstableNotifications received while the screen is locked.
Its settings are listed under [lock.notifications].
The password-checking rules for your lock screen, from /etc/pam.d/<name>.
The monitor you enter your password on, by connector name such as eDP-1. Use focused to follow your current monitor.
statustableWeather, battery, keyboard layout, Bluetooth and network on your lock screen.
Its settings are listed under [lock.status].
[lock.background]Your lock screen's background image and color.
How much you blur your background, in pixels; 0 leaves it sharp.
The background color you see when an image is missing or doesn't fill your screen.
How much the background is darkened, from 0 (untouched) to 1 (black).
Overrides dim under the dark color scheme.
How your image fits the screen.
"cover""contain""fill""center"Center your image without stretching it.
Your lock screen's background image. If you leave both this and image-dark unset, it uses your wallpaper.
The background image under the dark color scheme. Falls back to image when unset.
Without image or image-dark here, the lock screen uses the wallpaper's images, so it matches your desktop. The background is a solid color while the image decodes, so the picture can appear shortly after the lock screen.
The selected theme's lock.css styles the lock screen. See Write a theme.
[lock.clock]The time and date on your lock screen.
{day} is the day of the month with its ordinal suffix, e.g. "3rd".
Show the clock on your lock screen.
A strftime pattern for the time, e.g. %H:%M or %-I:%M %p.
glimpsectl config validate does not check the clock formats, background colors, image paths, or pam-service. An invalid time-format hides the time. Only {day} is replaced in date-format; an unknown placeholder is printed as typed.
[lock.status]Weather, battery, keyboard layout, Bluetooth and network on your lock screen.
Show this item on your lock screen.
Turning off this table hides the status island but leaves the session button.
[lock.notifications]Notifications received while the screen is locked.
Show notifications on your lock screen.
How much you reveal about notifications: count shows a total, and apps also shows the senders. Message text stays hidden.
"count"A notification count only."apps"A count and application names.
Only notifications that arrive after the lock starts appear. "apps" shows one icon with a count for each app; the app's name is the icon's tooltip and accessible name. Apps without an icon use a generic bell, and groups are ordered critical first, then newest. "count" shows one icon with the total. Neither mode shows a summary or a body.
[lock.media]Playback controls on your lock screen.
Show this item on your lock screen.
The track title and artist are visible to anyone. The pause and next buttons work without a password; turn this table off to hide both the information and the controls.
[lock.session]Power options on your lock screen.
actionslist, each one ofThe power actions you offer on your lock screen. Actions your system doesn't allow stay hidden.
["suspend", "reboot", "power-off"]"suspend"Put your computer to sleep."reboot"Restart your computer."power-off"Power the system off.
Show power options on your lock screen.
Every session action asks for confirmation. Logind decides whether it is available: yes shows the action, no, na, and challenge hide it, and inhibited, inhibitor-blocked, or challenge-inhibitor-blocked shows it disabled with the blocker's reason when available.
PAM
The lock screen checks your password through the PAM service named by pam-service, which it reads once when it starts. The packages install /etc/pam.d/glimpse-lock. Give the bare file name, not a path. Point pam-service somewhere else only if that file exists in /etc/pam.d. If it is missing or unsafe, the lock screen refuses to lock and posts a "Screen not locked" notification. glimpse-lock check tells you what is wrong. If the session is already locked when the daemon starts, it re-acquires the lock even if the checks fail and shows instructions for using a text console.