-
0.1.0-alpha5
Pre-releaseSome checks failedCI / Test (push) Successful in 57sPackage / RPM — fedora:44 (fedora:44, fedora-44) (push) Successful in 33m49sPackage / Resolve ref (push) Successful in 3sPackage / DEB — ubuntu:22.04 (incomplete matrix)-1 (push) Successful in 15m48sPackage / publish (push) Failing after 37sPackage / publish-testing (push) Failing after 0sPackage / Discover supported releases (push) Successful in 2sPackage / DEB — ubuntu:24.04 (incomplete matrix)-1 (push) Successful in 15m31sPackage / DEB — ubuntu:26.04 (incomplete matrix)-1 (push) Successful in 14m30sCI / Format & Lint (push) Successful in 1m22sRebuild Cargo Cache / Populate linux-hello-cargo-cache volume (push) Successful in 1m28sPackage / Create Forgejo release (push) Successful in 13sCI / Toolchain check (rust:1.97) (push) Successful in 2m30sPackage / DEB — debian:bookworm (debian:bookworm, debian-bookworm) (push) Successful in 18m59sPackage / DEB — debian:trixie (debian:trixie, debian-trixie) (push) Successful in 19m26sSAST / SAST (audit · deny · geiger · semgrep) (push) Successful in 25m14sPackage / RPM — fedora:43 (fedora:43, fedora-43) (push) Successful in 27m47sPackage / Arch Linux / CachyOS / Manjaro / EndeavourOS (push) Successful in 28m54sreleased this
2026-11-03 18:26:19 +01:00 | 4 commits to develop since this releaseChanged
- Migrated the D-Bus stack from
zbus4 tozbus6. - Release drafts are now seeded from the matching
CHANGELOG.mdsection.
Security
- Bumped
tokio,pulldown-cmark,clipboard-winandasync-executorto clear RustSec advisories and yanked crates. - Dropped the unmaintained
zvariant,zbus_namesandzvariant_derive4.x dependencies from the workspace through thezbus6 migration. Slint still pulls thezbus5 versions, so the advisories stay ignored indeny.tomluntil Slint moves.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Migrated the D-Bus stack from
-
0.1.0-alpha4
Pre-releaseSome checks failedRebuild Cargo Cache / Populate linux-hello-cargo-cache volume (push) Successful in 2m35sCI / Format & Lint (push) Successful in 1m16sCI / Test (push) Successful in 1m12sCI / Toolchain check (rust:1.97) (push) Successful in 2m49sSAST / SAST (audit · deny · geiger · semgrep) (push) Successful in 15m57sPackage / Resolve ref (push) Successful in 2sPackage / Discover supported releases (push) Successful in 2sPackage / Arch Linux / CachyOS / Manjaro / EndeavourOS (push) Successful in 25m30sPackage / RPM — fedora:43 (fedora:43, fedora-43) (push) Successful in 37m2sPackage / DEB — debian:bookworm (debian:bookworm, debian-bookworm) (push) Successful in 12m0sPackage / DEB — debian:trixie (debian:trixie, debian-trixie) (push) Successful in 14m1sPackage / DEB — ubuntu:22.04 (incomplete matrix)-1 (push) Successful in 14m14sPackage / DEB — ubuntu:24.04 (incomplete matrix)-1 (push) Successful in 14m17sPackage / RPM — fedora:44 (fedora:44, fedora-44) (push) Successful in 27m1sPackage / DEB — ubuntu:26.04 (incomplete matrix)-1 (push) Successful in 15m59sPackage / Create Forgejo release (push) Successful in 8sPackage / publish (push) Failing after 15sPackage / publish-testing (push) Has been cancelledreleased this
2026-10-10 16:23:21 +02:00 | 10 commits to develop since this releaseAdded
- Overlay dismiss button ("✕", top right): closes the overlay early and acts like Cancel on a pending consent request.
- Overlay hint "Enter your PIN / authenticator code / recovery token in the prompt" when biometrics do not match and a typed credential is requested, instead of a misleading "Authentication failed — use your password".
- New D-Bus signal
AuthCancelled(session_id), emitted when that credential prompt is cancelled. The daemon detects it through a watch connection the PAM module keeps open on the PAM socket while the prompt is shown, because polkit kills the PAM helper when its dialog is dismissed. - TPM tier status and migration in the daemon and D-Bus API, and in the admin GUI and TUI.
- Admin Services tab (GUI and TUI) to manage the base and optional systemd services.
- COPR publish pipeline for stable and testing channels; RPM changelog generated from this file.
- Quick start guide with screenshots, linked from the README.
Changed
- The overlay is no longer shown for callers that already give feedback themselves (terminal, SSH, display-manager and lock-screen themes). It stays for polkit,
swaylockand unknown services. The PAM module reports this with the newhas_own_feedbackflag on every request. - The consent gate (Allow / Cancel) is raised only when the user has an enrolled and available passive factor (face IR / RGB). Fingerprint, FIDO2 touch and typed credentials need no gate, since the gesture is the consent. Mixed setups (e.g. fingerprint + face) keep it.
- D-Bus:
AuthStartedhas a fourth argumenthas_own_feedback: b; deniedAuthResults that request a typed credential carryfactor_used = "needs:<factor>". The PAM socket protocol gains optional fields (has_own_feedback,watch_session,session_id); older modules and daemons keep working. - Terminal PIN prompt is now a plain
PIN:confirmed with Enter, without auto-submit. Graphical lockers keepPIN (N digits)for their auto-submit field. - Admin lock screen reapply re-copies the theme when the source changed, and
make installruns it. - kscreenlocker themes use a neutral auth status text and parse the PIN prompt independently of the locale.
- Secrets integration targets GNOME Keyring only; KWallet references removed.
- RPM: debuginfo package dropped,
CARGO_PROFILE_RELEASE_CODEGEN_UNITSoverride removed to speed up packaging.
Fixed
- The overlay appeared after logins from the lock screen or SDDM and during
sudo/login, where the information is already on screen. - A stale "ready" timer could hide a newer scan result or a consent prompt; resets now apply only if nothing else was shown meanwhile.
- Admin could not enable
polkit-1(or other integrations) on distributions that ship PAM defaults in/usr/lib/pam.d(e.g. Fedora); it now starts from the vendor file, and disabling removes an/etc/pam.dcopy that equals it. - PAM detects enrollment when called as an unprivileged user and skips the pre-prompt when no biometric factor is enrolled.
PAM_SECDIRdetection usesdpkg-architectureonly on Debian-based systems.linux-hello-notify.serviceExecStartpath.- RPM: missing
BuildRequires(fontconfig, udev, xkbcommon, wayland, x11) for COPR builds. - Clippy 1.98 lints (
as_chunks,unused_async_trait_impl).
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
0.1.0-alpha3
Pre-releaseAll checks were successfulCI / Format & Lint (push) Successful in 1m14sCI / Toolchain check (rust:1.97) (push) Successful in 1m13sRebuild Cargo Cache / Populate linux-hello-cargo-cache volume (push) Successful in 1m17sCI / Test (push) Successful in 2m45sSAST / SAST (audit · deny · geiger · semgrep) (push) Successful in 2m22sPackage / Discover supported releases (push) Successful in 2sPackage / DEB — debian:bookworm (debian:bookworm, debian-bookworm) (push) Successful in 11m26sPackage / Arch Linux / CachyOS / Manjaro / EndeavourOS (push) Successful in 11m35sPackage / DEB — ubuntu:24.04 (incomplete matrix)-1 (push) Successful in 10m44sPackage / DEB — ubuntu:22.04 (incomplete matrix)-1 (push) Successful in 10m56sPackage / DEB — debian:trixie (debian:trixie, debian-trixie) (push) Successful in 11m4sPackage / RPM — fedora:44 (fedora:44, fedora-44) (push) Successful in 25m8sPackage / DEB — ubuntu:26.04 (incomplete matrix)-1 (push) Successful in 14m59sPackage / RPM — fedora:43 (fedora:43, fedora-43) (push) Successful in 30m57sPackage / Create Forgejo release (push) Successful in 14sreleased this
2026-09-27 23:31:04 +02:00 | 41 commits to develop since this releaseAdded
- Explicit consent gate before biometric auth in graphical non-DM sessions: a blocking overlay prompt appears when an app requests biometric authentication; auth is denied on timeout.
polkit-1PAM config; polkit is excluded from the overlay consent gate to avoid deadlocks.
Changed
- GNOME Keyring unlock moved to
pam_sm_open_session(was a racy daemon-side fire-and-forget); dropped legacykwalletd5socket path and fixed KDE session detection to use config files. - Consent gate is now blocking: auth is denied on timeout; overlay is required for graphical sessions.
- Overlay and notify systemd units enabled globally via a systemd preset (no manual
systemctl enableneeded after install). - Slint gettext integration wired in the overlay; all user-facing strings go through
@tr(…)/tr!(), with translations for all supported locales. linux-hello-enrollpollsGetAvailableAuthenticatorson-demand while its window is open; removed the daemon-side 2 s availability poll that hammered the IR/RGB camera even when no client was listening.
Removed
kwalletdsupport has dropped, as apparently there is no way to programmatically unlock the wallet by design (previously the system tried to provide the password to the socket, based off Plasma5 version of the software, but it's not compatible with Plasma6)
Fixed
FaceProvider::is_available()scanned only fixed/dev/video0–3; now enumerates cameras via sysfs, matching the face pipeline, so it survives/devnode renumbering (replug, suspend/resume, extra webcams).- Overlay initial visibility: surface now starts hidden via
run_event_loop()+ui.hide(), shows on auth events, and shrinks to 1×1 px on hide to avoid a KWin null-buffer remap bug; Ctrl+C cancels auth. - Layer-shell surface hidden via null buffer when idle; pointer input wired to prevent input passthrough while visible.
- Consent gate skips the overlay popup when
PAM_TTYis a real terminal (pts/tty) or when the session is not graphical. is_graphical_session()removed fromneeds_consent: polkit-kde strips session environment variables, making the check unreliable.pam_sm_open_sessionskips PAM conversation for graphical non-DM consent contexts.- PAM config paths: module name no longer hardcodes
secdir; fixed by using the bare module name. - Overlay systemd service install path corrected to
user/(wassystem/); user preset split from system preset.
Security
- Bumped
ratatuito 0.30 andcrosstermto 0.29 to remove the transitive unsound dependency onlru 0.12.5(RUSTSEC-2026-0002, RUSTSEC-2026-0253).
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
0.1.0-alpha2
Pre-releaseAll checks were successfulPackage / Discover supported releases (push) Successful in 2sCI / Format & Lint (push) Successful in 1m31sCI / Toolchain check (rust:1.97) (push) Successful in 1m55sRebuild Cargo Cache / Populate linux-hello-cargo-cache volume (push) Successful in 2m51sCI / Test (push) Successful in 2m56sSAST / SAST (audit · deny · geiger · semgrep) (push) Successful in 4m2sPackage / Arch Linux / CachyOS / Manjaro / EndeavourOS (push) Successful in 15m1sPackage / DEB — debian:trixie (debian:trixie, debian-trixie) (push) Successful in 13m39sPackage / DEB — ubuntu:22.04 (incomplete matrix)-1 (push) Successful in 13m53sPackage / DEB — ubuntu:26.04 (incomplete matrix)-1 (push) Successful in 6m2sPackage / RPM — fedora:43 (fedora:43, fedora-43) (push) Successful in 23m51sPackage / DEB — ubuntu:24.04 (incomplete matrix)-1 (push) Successful in 21m25sPackage / RPM — fedora:44 (fedora:44, fedora-44) (push) Successful in 34m29sPackage / Create Forgejo release (push) Successful in 16sreleased this
2026-08-28 12:34:33 +02:00 | 68 commits to develop since this releaseThis is a first, pre-release preview.
It is currently feature-full, though it has been tested on Fedora 44 only.
Fingerprint enroll / usage has not been tested due to no device available.Changes from alpha-1
- SDDM SELinux (mainly targeting Fedora-based distros) hotfix
Currently tested
- Face (webcam RGB)
- Face (IR Windows Hello — Nexigo camera). Tested with a single UVC infrared
webcam; other cameras may have issues. - PIN
- FIDO2 USB key
- TOTP
- SDDM and kscreenlocker themes
Not tested
- Fingerprint (no device available)
- Recovery token
- swaylock, hyprlock, greetd, LightDM integrations
Quick setup
- Install the package.
- Ensure the following system-wide services are enabled and running:
linux-hello— main authentication daemonlinux-hello-sddm-helper— HTTP bridge required by the SDDM themelinux-hello-reseal— re-seals TPM keys at boot (only relevant with
Secure Boot + TPM 2.0; harmless otherwise)
- Optionally enable the following user services
(systemctl enable --user --now):linux-hello-overlay— graphical Wayland overlay during auth (not needed
under SDDM)linux-hello-notify— desktop notification on key inconsistency errors
- Run Linux Hello Enrollment and enroll your preferred authentication
methods. - Run Linux Hello Admin:
- Choose your recovery mode.
- Enable the integrations you want to use.
- Configure the authentication policies.
- Apply a linux-hello theme:
- SDDM — use the theme picker in the Admin UI.
- KDE lockscreen (kscreenlocker) — use the Install lockscreen theme
button; this patches the Plasma files and is automatically re-applied
onplasma-desktopupgrades.
- Go to your display manager settings and select the linux-hello SDDM theme.
Recovery / escape hatches
Tip: do not add linux-hello to the
loginPAM service (TTY logins).
Keeping TTY login as pure password authentication gives you an always-available
escape hatch regardless of what happens to the graphical session.Locked screen won't unlock
Switch to a free TTY (
Ctrl+Alt+F2), log in with your password, then:loginctl unlock-sessionsSwitch back to your graphical session (Ctrl+Alt+F1 or whichever VT it is on).
SDDM theme broken / login loop
Switch to a TTY and log in with your password, then either:
- Disable the linux-hello SDDM theme — change the active theme back to the
default:
sudo sed -i 's/^Current=.*/Current=breeze/' /etc/sddm.conf.d/kde_settings.conf
sudo systemctl restart sddm
(adjust the config path and theme name to match your system) - Or disable the SDDM integration entirely via the Admin TUI:
sudo linux-hello-admin # launches the TUI when run without a display
Navigate to Integrations, disable SDDM, and apply.
KDE lockscreen patch gone wrong
From a TTY or a working terminal:
sudo linux-hello-admin lockscreen uninstall
This reverts the Plasma files to their original state. Log out and back in to
reload the lockscreen.Nuclear option — disable linux-hello entirely
sudo systemctl stop linux-hello linux-hello-sddm-helper
sudo systemctl disable linux-hello linux-hello-sddm-helperPAM will fall through to pam_unix (password) automatically, because the PAM
stacks use default=ignore — a linux-hello failure or absence never blocks
login on its own.Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
0.1.0-alpha1
Pre-releaseSome checks failedCI / Toolchain check (rust:1.97) (push) Successful in 1m3sPackage / Discover supported releases (push) Successful in 3sCI / Test (push) Successful in 1m55sCI / Format & Lint (push) Successful in 2m10sSAST / SAST (audit · deny · geiger · semgrep) (push) Successful in 2m52sPackage / DEB — ubuntu:22.04 (incomplete matrix)-1 (push) Successful in 15m24sPackage / Arch Linux / CachyOS / Manjaro / EndeavourOS (push) Successful in 16m12sPackage / DEB — ubuntu:24.04 (incomplete matrix)-1 (push) Successful in 15m36sPackage / DEB — debian:trixie (debian:trixie, debian-trixie) (push) Successful in 6m10sPackage / DEB — ubuntu:26.04 (incomplete matrix)-1 (push) Successful in 22m14sPackage / RPM — fedora:44 (fedora:44, fedora-44) (push) Successful in 26m25sPackage / RPM — fedora:43 (fedora:43, fedora-43) (push) Successful in 34m20sPackage / Create Forgejo release (push) Failing after 25sreleased this
2026-08-28 00:00:28 +02:00 | 72 commits to develop since this releaseThis is a first, pre-release preview.
It is currently feature-full, though it has been tested on Fedora 44 only.
Fingerprint enroll / usage has not been tested due to no device available.Currently tested
- Face (webcam RGB)
- Face (IR Windows Hello — Nexigo camera). Tested with a single UVC infrared
webcam; other cameras may have issues. - PIN
- FIDO2 USB key
- TOTP
- SDDM and kscreenlocker themes
Not tested
- Fingerprint (no device available)
- Recovery token
- swaylock, hyprlock, greetd, LightDM integrations
Quick setup
- Install the package.
- Ensure the following system-wide services are enabled and running:
linux-hello— main authentication daemonlinux-hello-sddm-helper— HTTP bridge required by the SDDM themelinux-hello-reseal— re-seals TPM keys at boot (only relevant with
Secure Boot + TPM 2.0; harmless otherwise)
- Optionally enable the following user services
(systemctl enable --user --now):linux-hello-overlay— graphical Wayland overlay during auth (not needed
under SDDM)linux-hello-notify— desktop notification on key inconsistency errors
- Run Linux Hello Enrollment and enroll your preferred authentication
methods. - Run Linux Hello Admin:
- Choose your recovery mode.
- Enable the integrations you want to use.
- Configure the authentication policies.
- Apply a linux-hello theme:
- SDDM — use the theme picker in the Admin UI.
- KDE lockscreen (kscreenlocker) — use the Install lockscreen theme
button; this patches the Plasma files and is automatically re-applied
onplasma-desktopupgrades.
- Go to your display manager settings and select the linux-hello SDDM theme.
Recovery / escape hatches
Tip: do not add linux-hello to the
loginPAM service (TTY logins).
Keeping TTY login as pure password authentication gives you an always-available
escape hatch regardless of what happens to the graphical session.Locked screen won't unlock
Switch to a free TTY (
Ctrl+Alt+F2), log in with your password, then:loginctl unlock-sessionsSwitch back to your graphical session (Ctrl+Alt+F1 or whichever VT it is on).
SDDM theme broken / login loop
Switch to a TTY and log in with your password, then either:
- Disable the linux-hello SDDM theme — change the active theme back to the
default:
sudo sed -i 's/^Current=.*/Current=breeze/' /etc/sddm.conf.d/kde_settings.conf
sudo systemctl restart sddm
(adjust the config path and theme name to match your system) - Or disable the SDDM integration entirely via the Admin TUI:
sudo linux-hello-admin # launches the TUI when run without a display
Navigate to Integrations, disable SDDM, and apply.
KDE lockscreen patch gone wrong
From a TTY or a working terminal:
sudo linux-hello-admin lockscreen uninstall
This reverts the Plasma files to their original state. Log out and back in to
reload the lockscreen.Nuclear option — disable linux-hello entirely
sudo systemctl stop linux-hello linux-hello-sddm-helper
sudo systemctl disable linux-hello linux-hello-sddm-helperPAM will fall through to pam_unix (password) automatically, because the PAM
stacks use default=ignore — a linux-hello failure or absence never blocks
login on its own.Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads