canido.dev
Use with your agentConnect an agent
Projects/hyprwm / hyprlock

hyprlock

A GPU-accelerated screen locker for Hyprland

Get it on GitHub
Unclaimed

Built by @hyprwm on GitHub. This page was written by @iluxav from public sources, last updated for v0.9.6 (2026-07-18), and may lag behind new releases.

Maintain hyprlock? Claim it
v0.9.6 / 2026-07-189 things you can do5 changes to know before upgradingFollow (Atom feed)

Lock your Wayland session behind a customizable lock screen and unlock it with your password or fingerprint.

A hyprlock lock screen with a blurred desktop background, a large clock, and a password field in the center.

What you can do with it

Lock the session and unlock it with your account password checked through PAM.

Good to know

Needs a compositor that supports the ext-session-lock protocol. The PAM service is set with auth:pam:module.

Present at v0.7.0

Unlock with your fingerprint reader as well as with your password.

Good to know

Needs fprintd; turned on with auth:fingerprint:enabled.

Present at v0.7.0

Show a blurred screenshot of your desktop or an image of your choice behind the lock screen, per monitor.

Present at v0.7.0

Place labels, images and shapes on the lock screen, including text that updates from a command, such as the time or the battery level.

Present at v0.7.0

See in the password field whether Caps Lock or Num Lock is on and whether the last attempt failed.

Present at v0.7.0

Configure or turn off the fade-in, fade-out and password-dot animations.

Present at v0.7.0

Unlock the session from a script by sending hyprlock SIGUSR1.

Present at v0.7.0

Unlock without a password if you move the mouse or press a key within a few seconds of the lock.

Present at v0.7.0

Run a command when you click or tap a widget on the lock screen.

Since v0.9.0

Before you upgrade

Newest first
Show 2 older
v0.8.02025-04-08

Install wayland-protocols 1.35 or newer before building from source.

Action requiredAffects: People building hyprlock from source
Read the evidence
Release history 8
v0.9.62026-07-18

Unlock with pam_fprintd in the PAM stack without the password prompt misbehaving.

Details

PAM conversation starts right away, and behavior with pam_fprintd.so in the PAM service is fixed. Invalid numeric config values no longer crash hyprlock.

v0.9.6.

Now works: Unlock with your fingerprint reader as well as with…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.9.52026-04-18

Show your own message while the password is being checked.

Details

New input-field:check_text, shown during authentication. dots_size accepts smaller values. Groups v0.9.4 and v0.9.5.

v0.9.5.

Improved: See in the password field whether Caps Lock or Num…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.9.32026-03-22

Refresh the background screenshot or image with a command while the screen is locked.

Details

background:reload_cmd now also reloads a screenshot background, and runs at start when path is empty, so a command can supply the image.

v0.9.3.

Improved: Show a blurred screenshot of your desktop or an ima…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.9.12025-07-31

Clear the whole password field with Ctrl+A.

Details

Ctrl+A clears the typed password, like Escape, Ctrl+U and Ctrl+Backspace. onclick fires on press only.

v0.9.1.

Improved: Lock the session and unlock it with your account pa…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.9.02025-07-17

Run a command by clicking or tapping a widget on the lock screen, such as switching the keyboard layout.

Details

New onclick option on widgets; touch counts as a click. general:grace is replaced by the --grace <seconds> command-line flag, and --immediate is deprecated. Fade in and out now use a screenshot.

v0.9.0.

Added: Run a command when you click or tap a widget on the…Action required: Unlock without a password if you move the mouse or…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.8.12025-04-17

Labels without halign or valign are now centered by default.

Details

label:halign and label:valign default to center instead of none.

v0.8.1.

Behavior changed: Place labels, images and shapes on the lock screen,…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.8.02025-04-08

Let fprintd pause fingerprint checks during suspend and pick them up again afterwards.

Details

The loading bar is gone and general:disable_loading_bar with it; input-field:fail_timeout moved to general:fail_timeout. New input-field:hide_input_base_color separates the base color from the outer color when hide_input is on.

v0.8.0; building from source needs wayland-protocols >= 1.35.

Action required: See in the password field whether Caps Lock or Num…Action requiredImproved: Unlock with your fingerprint reader as well as with…Action required

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.7.02025-02-22
Starting point

Lock your Wayland session and unlock it with your account password.

Details

State of hyprlock at v0.7.0: configured in ~/.config/hypr/hyprlock.conf with background, input-field, label, image and shape widgets, an auth section for PAM and fingerprint, and animation/bezier keywords. In v0.7.0 itself, fade and dot-fade settings moved to the animation keyword and the $PROMPT placeholder was replaced by $PAMPROMPT and $FPRINTPROMPT.

Arch: pacman -S hyprlock; otherwise build from source with CMake (needs wayland-protocols, mesa, hyprwayland-scanner, cairo, pango, pam, hyprlang, hyprutils, hyprgraphics).

Added: Lock the session and unlock it with your account pa…Added: Unlock with your fingerprint reader as well as with…Added: Show a blurred screenshot of your desktop or an ima…Added: Place labels, images and shapes on the lock screen,…Added: See in the password field whether Caps Lock or Num…Added: Configure or turn off the fade-in, fade-out and pas…Added: Unlock the session from a script by sending hyprloc…Added: Unlock without a password if you move the mouse or…

Seeded by @iluxav with Claude Code (canido)

Read the evidence