Lock screen draws the password box on one monitor only and the others are blank
The diagnosis and the main fix are correct and well sourced. The quoted line "monitor is available for all widgets and can be left empty for 'all monitors'" is verbatim from the hyprlock wiki, which also confirms monitor defaults to empty on background, image, shape, input-field and label, that it takes the same string as the Hyprland monitor config including desc:, and that path = screenshot is valid. hyprlock.conf is indeed still hyprlang while Hyprland moved to Lua, so "do not convert it" is right. The Omarchy 4 section checks out: the lock screen is the Quickshell Omarchy shell configured through ~/.config/omarchy/shell.json, omarchy-shell lock status is the real subcommand (omarchy-restart-shell calls exactly that and parses .secure / .requested), omarchy-debug-idle exists, and omarchy-restart-shell does refuse while the session is genuinely locked and secure. The defect is the test step: hyprlock --immediate is not a valid flag. The documented argument list is -v/--verbose, -q/--quiet, -c/--config, --display, --grace, --immediate-render, --no-fade-in, -V/--version, -h/--help. --immediate will be rejected and hyprlock will not start, and even the real --immediate-render only skips waiting for background resources, so it was never the flag that makes a test safe. The record's own safety advice (open a TTY first) is the right instinct, but the command it pairs with is wrong and --grace is the flag that actually gives you an escape hatch.
A broken hyprlock config is a locked-out-of-your-machine failure: hyprlock fails safe by staying locked. Always have a second TTY logged in before testing lock-screen changes, and never migrate hyprlock.conf/hypridle.conf to Lua. The hypr* tools deliberately stayed on hyprlang after Hyprland 0.55 deprecated it, so a Lua rewrite of these files will fail to parse and leave you with a lock screen that cannot authenticate you.
Symptom
hyprlock locks the session but the clock, avatar and password field only render on the laptop panel. The two external monitors are just a flat colour, or still showing a frozen image of my desktop, with no indication of where to type. I have to guess which screen has focus. On a triple-monitor desk it looks like the lock screen half-crashed.
Cause
hyprlock puts a session-lock surface on every output, but the *widgets* drawn on those surfaces are filtered by each widget's monitor field. The wiki states: *"monitor is available for all widgets and can be left empty for 'all monitors'."* Most shared configs and theme drops pin monitor = eDP-1 (or a desc: string) on the background, input-field and label blocks, often copied from someone's single-laptop setup, so every other output gets a bare surface with nothing on it. A background block pinned to one monitor likewise leaves the others on the fallback color.
Fix
Everything else in the record stands: leave monitor = bare on background, input-field and label, use grep -n 'monitor' ~/.config/hypr/hyprlock.conf to find pinned widgets, add an empty-monitor catch-all if you want per-screen backgrounds, keep input-field unpinned, and prefer desc: over connector names. Only the test step is wrong.
**Test without locking yourself out.** --immediate does not exist. hyprlock's flags are -v/--verbose, -q/--quiet, -c/--config FILE, --display NAME, --grace SECONDS, --immediate-render, --no-fade-in, -V/--version, -h/--help. Use --grace, which gives you a window to dismiss the lock without authenticating:
hyprlock --grace 30
Still open a second TTY *first* (Ctrl+Alt+F2, log in there and leave it) before you run it, so you have a way back if the widgets render but authentication misbehaves. From that TTY:
pkill hyprlock
To iterate on a config without touching your real one:
hyprlock -c /tmp/hyprlock-test.conf --grace 30 --no-fade-in
(--immediate-render is the flag the record was reaching for by name, but it only starts drawing widgets before background resources finish loading. It is a rendering option, not a safety net.)
Verify
Lock the session with a second TTY open as an escape hatch. Every monitor should show the background and the password field, and typing should register no matter which screen you look at.
Sources
- https://raw.githubusercontent.com/hyprwm/hyprland-wiki/main/content/Hypr%20Ecosystem/hyprlock.md
- https://raw.githubusercontent.com/hyprwm/hyprland-wiki/main/content/Configuring/Basics/Monitors.md
- https://raw.githubusercontent.com/basecamp/omarchy/quattro/bin/omarchy-restart-shell
- https://raw.githubusercontent.com/basecamp/omarchy/quattro/bin/omarchy-debug-idle
- https://raw.githubusercontent.com/basecamp/omarchy/quattro/manual/13-toggles-idle-screensaver.md