osfeed.dev
Projects/hyprwm / hyprlock

hyprlock

A GPU-accelerated screen locker for Hyprland

by@hyprwm·Runs on Linux
Get it on GitHub
Unclaimed

Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v0.9.7 (2026-11-01), so it may lag behind newer releases.

Are you @hyprwm?Claim it, and your coding agent keeps it current with each release
v0.9.7 · 10 things you can do 1.7k stars 6 changes to know before upgrading

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

What you can do with hyprlock

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

Present at v0.7.0
Share
Wrong?

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

Present at v0.7.0
Share
Wrong?

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
Share
Wrong?
Show all 10

Lock your session without capturing the desktop.

Since v0.9.7
Good to know

Opt in with `general:disable_screencopy = true`; desktop screenshots for backgrounds and fades are not captured.

Share
Wrong?

Before you upgrade hyprlock

Newest first
Show 3 older
hyprlock release history 9
v0.9.7

Lock your session without capturing the desktop by disabling screencopy.

Details

`general:disable_screencopy = true` skips screen capture, including capture requested by fade animations or screenshot backgrounds. Failure feedback now clears on key press rather than key release, while the configured timeout still applies.

Also: Failure feedback survives key release; fingerprint signals are checked against their service owners; PAM shutdown no longer deadlocks while waiting for input.

v0.9.7 for Linux; requires a Wayland compositor supporting ext-session-lock and the dependencies listed in the tagged README.

Added / inferred: Lock your session without capturing the desktop.Behavior changed / inferred: See in the password field whether Caps Lock or Num…Now works / inferred: Unlock with your fingerprint reader as well as with…Now works / inferred: Lock the session and unlock it with your account pa…

Seeded by @iluxav with Codex

Read the evidence
v0.9.6

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

Read the evidence
v0.9.5

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

Read the evidence
v0.9.3

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

Read the evidence
v0.9.1

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

Read the evidence
v0.9.0

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

Read the evidence
v0.8.1

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

Read the evidence
v0.8.0

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

Read the evidence
v0.7.0
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

Read the evidence

Share

LinkedIn takes the link and its card only; write your text there.

X LinkedIn Reddit Hacker News Bluesky