Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v2.0.13 (2026-11-11), so it may lag behind newer releases.
Thanks. The report went to osfeed, and the line gets checked against the repository.
Replace Omarchy's lock screen with one of dozens of themed designs or one you build, and unlock with a password, fingerprint, face or FIDO2 security key.
This page covers Lock Screen Explorer up to v2.0.13. GitHub has v2.0.14 (), not published here yet. Maintainer? Publish it with your agent.
What you can do with Lock Screen Explorer
Browse lock screen designs, preview them full size and switch the lock screen to one.
Since v1.4.0
Good to know
Replaces Omarchy's own lock service while enabled.
Unlock the screen with a FIDO2 security key, with or without its PIN.
Since v1.7.7
Good to know
Needs pam_u2f and the setup script, which writes one root-owned PAM file. After three PIN attempts in one lock it falls back to the password. A key enrolled without a PIN unlocks for whoever holds it.
Resume now lights the lock screen and skips the wake typing delay, including panels turned off by hypridle. With no activity, the screen still blanks again after `blankMs`.
Behavior changedAffects: Users resuming a locked session from suspend
The reader pauses after five consecutive misses; any key, click or pointer movement restarts it. An errored round counts once, and a match from a round begun before blanking still unlocks.
Behavior changedAffects: Fingerprint users with the lock screen lit, including Never and HDMI keep-on modes
Reapply the snapshot boot screen with the monitors connected to generate and install the per-monitor captures; an already installed snapshot does not gain them merely by updating the plugin.
Action requiredInferredAffects: Users with an older snapshot boot screen applied on monitors of different shapes
Update to v2.0.8 and restart the shell for the authentication-bypass fix in v2.0.4, plain-text revealed passwords in v2.0.7, and protection against cover art exhausting shell memory in v2.0.8.
`omarchy-shell lock setKeepDisplayOn on` now actually enables the setting; `off`, `true`/`false` and `1`/`0` are accepted. Other values return `invalid-value` and leave the setting unchanged.
Behavior changedAffects: Users or scripts calling setKeepDisplayOn
Accept the one-time password prompt on first unlocked startup to remove an old rotation helper. Canceling defers removal until a later start; `omarchy-shell lock removeBootRotationHelper` removes it manually.
Action requiredAffects: Users who previously installed the passwordless boot-rotation helper
The password can no longer be selected, cut or copied, even while revealed. Terminal and Keycode now render revealed text literally rather than interpreting markup.
Behavior changedAffects: Users revealing or selecting a lock-screen password
Music, the media strip and designer album art accept only local files or HTTPS PNG, JPEG, WebP or GIF covers up to 8 MiB. Failed processing shows a placeholder instead of the cover.
Behavior changedAffects: Users displaying media cover art
Rename custom boot layouts to 1–64 ASCII letters, digits, underscores or hyphens; names outside this pattern are now rejected by layout loading and saving.
Action requiredInferredAffects: Users with manually named boot layouts outside the accepted pattern
Since v1.9.8, single-line plugin fields support neither Paste, Undo nor input-method composition. Type directly; the fields no longer read clipboard changes.
The source editor and designer snippet box no longer paste from the clipboard, including middle-click or dropped text. Use `Ctrl+O` in the source editor to paste in an external editor; typed edits, undo and redo remain.
Action requiredAffects: Users who paste QML into either built-in code editor
`omarchy-shell lock explore` opens the side panel on new installs; upgrades retain the full explorer. Choose with `setOpenAs panel` or `setOpenAs full`.
Behavior changedAffects: New installations and users changing the picker preference
Pick your boot screen again in the explorer so it is rebuilt with the per-display layout, then reboot; a boot screen applied before updating keeps the old layout.
Action requiredInferredAffects: Users with a boot screen applied on two displays of different shapes
Update to v1.9.5 or later: while root copied a staged boot screen directory, a subdirectory swapped for a symlink mid-copy could pull root-only files into the world-readable theme directory; the theme now reaches root as one archive that is checked and unpacked in a root-owned directory first.
Action requiredAffects: Users of the boot screen on v1.9.4 or earlier
Turn rotation on again and accept its one-time setup, which rewrites the root helper for the archive spool; until then each rotation asks for your password through pkexec.
Action requiredAffects: Users who set up boot screen rotation before v1.9.5
Restart or shut down from the lock screen on Omarchy 4.5.
Details
Power buttons use `omarchy-system reboot` and `omarchy-system shutdown`, with the old commands retained as fallback. The explorer loads when first opened or needed for a pending request.
Also: Shell startup no longer waits for the full explorer window to be built before it is needed.
v2.0.13 for Omarchy 4; update with `omarchy plugin update io.github.sirjul1337.lock-explorer` then `omarchy restart shell`. Power buttons must be enabled in Settings.
Now works: Sleep, restart or shut down from the lock screen, e…Improved: Browse lock screen designs, preview them full size…
Type your password after waking or resuming without clicking the lock screen to recover keyboard focus.
Details
Wake grace runs once per wake, and resume lights the screen without a typing delay. Fingerprint settings add `setFingerprintInDark`, and boot snapshots capture up to four monitor sizes.
Also: Reopen an existing customized design; rest the fingerprint reader while the screen is dark; give each monitor a boot snapshot suited to its shape.
v2.0.12 for Omarchy 4; update with `omarchy plugin update io.github.sirjul1337.lock-explorer` then `omarchy restart shell`. Boot screens remain experimental.
Now works: Browse lock screen designs, preview them full size…Behavior changed: Browse lock screen designs, preview them full size…Behavior changed: Copy a design and edit its QML in a built-in editor…Improved: Unlock with an enrolled fingerprint reader as well…Behavior changed: Unlock with an enrolled fingerprint reader as well…Now works: Give the disk decryption passphrase screen at boot…Action required / inferred: Give the disk decryption passphrase screen at boot…
v2.0.8 with v2.0.2, v2.0.3, v2.0.4, v2.0.5, v2.0.6, v2.0.7
Keep the session locked until authentication succeeds, even if a design signals that its unlock animation has finished.
Details
v2.0.4 gates unlock completion on authentication and honors lock requests during unlock animations. v2.0.5 prompts to remove old passwordless boot-rotation helpers; v2.0.6 adds `setBootClock show|hide` and `setBootShutdown design|plain`.
Also: Boot snapshots show passphrase progress on every display and can hide frozen clocks; shutdown can use a plain splash. The owner-message field accepts typing again, and cover art has stricter limits.
v2.0.8 for Omarchy 4. Update the plugin and restart the shell; existing boot-rotation helpers trigger a one-time password prompt for removal.
Action requiredNow works: Browse lock screen designs, preview them full size…Now works: Browse lock screen designs, preview them full size…Improved: Browse lock screen designs, preview them full size…Behavior changedBehavior changed: Give the disk decryption passphrase screen at boot…Action required: Give the disk decryption passphrase screen at boot…Behavior changed: Reveal the password you typed on the lock screen wi…Improved: Give the disk decryption passphrase screen at boot…Now works: Give the disk decryption passphrase screen at boot…Now works: Show a contact message on every lock screen design…Behavior changed: Pause, resume or skip tracks from the lock screen.Action required / inferred: Pause, resume or skip tracks from the lock screen.Action required / inferred: Copy a design and edit its QML in a built-in editor…Action required / inferred: Give the disk decryption passphrase screen at boot…
Let your favorite lock screen designs take turns on each lock or each day.
Details
Settings adds design rotation, per-theme picks, an optional bar icon and media controls; `explorePanel` opens the new picker. Text fields stop reading the clipboard; the code editors keep undo and redo but require an external editor for pasted snippets.
Also: A side panel, nine designs, theme-specific picks, an owner message and media controls arrive; Qt 6.12 colors and repeated locking on Quickshell 0.3.2 work again. Plugin fields and editors lose native paste.
v2.0.1 for Omarchy 4. Update with `omarchy plugin update io.github.sirjul1337.lock-explorer && omarchy restart shell`.
Now works: Browse lock screen designs, preview them full size…Now works: Browse lock screen designs, preview them full size…Action required: Copy a design and edit its QML in a built-in editor…Behavior changedAction required: Copy a design and edit its QML in a built-in editor…Improved: Browse lock screen designs, preview them full size…Behavior changed: Browse lock screen designs, preview them full size…Now works: Copy a design and edit its QML in a built-in editor…Added: Restore a chosen lock screen design automatically w…Added: Rotate favorite lock screen designs each time you l…Added: Show a contact message on every lock screen design…Added: Pause, resume or skip tracks from the lock screen.Improved: Design a lock screen visually by placing and arrang…Now works: Give the disk decryption passphrase screen at boot…Action required: Give the disk decryption passphrase screen at boot…
Lock the session the moment your security key is pulled out, and light the dark lock screen by plugging it back in.
Details
Two off-by-default rows under Security key in Settings, `Lock when the key is removed` and `Wake when the key is inserted`, also set with `omarchy-shell lock setLockOnKeyRemoval on` and `omarchy-shell lock setWakeOnKeyInsert on`. The custom, snapshot, clip and Terminal boot screen generators give each display its own slice of the Plymouth canvas, and `apply.sh` hands root one tar file instead of a directory.
Also: Key presence is rechecked after suspend; boot screens lay out per display on two displays of different shapes; boot themes reach root as one checked archive, and a rotation set up before v1.9.5 asks for its one-time setup again.
v1.9.6, with v1.9.5 as the archive handoff alone; update with `omarchy plugin update io.github.sirjul1337.lock-explorer && omarchy restart shell`. The key settings appear once a security key is set up and turned on in Settings.
Improved: Unlock the screen with a FIDO2 security key, with o…Now works: Unlock the screen with a FIDO2 security key, with o…Now works: Give the disk decryption passphrase screen at boot…Action required / inferred: Give the disk decryption passphrase screen at boot…Action required: Give the disk decryption passphrase screen at boot…Action required: Give the disk decryption passphrase screen at boot…
Pull a security key out while the lock waits for a touch without being locked out of the key.
Details
Removing the key mid-wait no longer counts as failed tries; the lock says No security key found and resumes when it is plugged back in. Korean is added. A second lock screen plugin enabled at once is named, with the command to disable it. Groups v1.9.2 to v1.9.4.
Also: Boot screen apply and rotation read staged files only through checked handles.
v1.9.4.
Now works: Unlock the screen with a FIDO2 security key, with o…Improved: See the lock screen and explorer in your language.
Pick from 23 animated lock screens that draw your clock or logo with Omarchy's ttfx text effects.
Details
23 ttfx designs and a ttfx art piece in the designer; the field shows keyboard layout and Caps Lock; optional sleep, restart and shut-down buttons; Face unlock starts On wake by default; the lock follows the system language in 11 languages; reduce motion, 125% or 150% size; Live pieces in the designer; search with /, favorites with F; a notification counts wrong passwords tried while locked; extras/doctor.sh checks an install. Groups v1.8.0 to v1.9.1.
Also: Hybrid laptops no longer keep the dGPU awake; the explorer opens again without qt6-multimedia; a new wallpaper no longer blanks the lock screen after a theme switch.
v1.9.1; tested on Omarchy 4.0.2 to 4.0.4.
Improved: Browse lock screen designs, preview them full size…Behavior changed: Unlock with your face through pam_facelock.Improved: Unlock with an enrolled fingerprint reader as well…Added: Sleep, restart or shut down from the lock screen, e…Added: See the lock screen and explorer in your language.Added: Get told after unlocking how many wrong passwords w…Improved: Design a lock screen visually by placing and arrang…Action required: Give the disk decryption passphrase screen at boot…
Unlock the screen by touching a FIDO2 security key, with the password still one Tab away.
Details
Security key unlock through its own PAM service, omarchy-lock-fido2, set up once with bash extras/setup-fido2.sh. Boot screens made from a design now follow the display's aspect ratio. A monitor that disconnects when blanked no longer crashes the locked shell in a loop. Groups v1.7.2 to v1.7.7.
Also: Hardened file writes and the boot rotation's root helper; Weather design caps what it reads from wttr.in.
v1.7.7; security key unlock needs a key enrolled through Omarchy's Setup > Security > Fido2.
Added: Unlock the screen with a FIDO2 security key, with o…Now works: Give the disk decryption passphrase screen at boot…Behavior changed
Arrange a clock, a photo and a password box on a canvas to make a lock screen of your own without writing code.
Details
A visual designer (D or + New design) with sixteen pieces, snapping, anchors and reusable components saved to ~/.config/omarchy/lock-components/. v1.7.0 adds face unlock through pam_facelock, a 12-hour clock, the keepDisplaysOnWithHdmi setting and fixes for Omarchy 4.0.3; v1.7.1 adds an Omarchy menu entry setting. Groups v1.6.0 to v1.7.1.
v1.7.1; verified on Omarchy 4.0.2 and 4.0.3.
Added: Design a lock screen visually by placing and arrang…Added: Unlock with your face through pam_facelock.Added: Show the time in 12-hour format on every design.Now works: Browse lock screen designs, preview them full size…Action required: Browse lock screen designs, preview them full size…Improved: Browse lock screen designs, preview them full size…
Unlock into a short video that plays as the lock screen goes away, using a clip of your own if you like.
Details
Clip designs (Storm, Eyes, River) hold the first frame while locked and play on unlock; + New clip turns any video into one. The LUKS boot passphrase screen can now match the lock screen, shipped as a systemd-stub initrd addon. The explorer was redesigned with a sidebar. Groups v1.5.0 to v1.5.5.
Also: Pond, Constellation and Sparks react to typing; Motion loops a video; a broken design falls back to Classic and then a plain password field.
v1.5.5. Video features need qt6-multimedia, which stock Omarchy does not ship. The boot screen is experimental.
Added: Use a video clip as the lock screen and let it play…Added: Give the disk decryption passphrase screen at boot…Action required: Give the disk decryption passphrase screen at boot…Action required: Give the disk decryption passphrase screen at boot…
Preview Omarchy lock screen designs full size and switch to one with a key press.
Details
First releases (v1.1.0 to v1.4.0). The plugin replaces the built-in omarchy.lock service; omarchy-shell lock explore opens a grid of 24 designs with category filters, Space previews and Enter selects. Adds a code editor for your own designs, a show-password button, avatar images and an optional unlock animation.
Also: omarchy-shell lock setInputMonitor <output> chooses which monitor gets the sign-in; the others show a clock.
Added: Browse lock screen designs, preview them full size…Added: Copy a design and edit its QML in a built-in editor…Added: Reveal the password you typed on the lock screen wi…Added: Show your profile picture on the designs that show…Added: Fade, zoom or rise the lock screen away when you un…Added / inferred: Unlock with an enrolled fingerprint reader as well…