2 releases 2 tags

RSS feed

• v0.1.0-alpha1 4b36ecf298

  Compare

  0.1.0-alpha1 Pre-release

  elegos released this 2026-08-28 00:00:28 +02:00 | 6 commits to develop since this release

  This 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

  1. Install the package.
  2. Ensure the following system-wide services are enabled and running:
     • linux-hello — main authentication daemon
     • linux-hello-sddm-helper — HTTP bridge required by the SDDM theme
     • linux-hello-reseal — re-seals TPM keys at boot (only relevant with
       Secure Boot + TPM 2.0; harmless otherwise)
  3. 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
  4. Run Linux Hello Enrollment and enroll your preferred authentication
     methods.
  5. 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
         on plasma-desktop upgrades.
  6. Go to your display manager settings and select the linux-hello SDDM theme.

  Recovery / escape hatches

  Tip: do not add linux-hello to the login PAM 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-sessions
  

  Switch 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-helper

  PAM 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

  ---

  • linux-hello-0.1.0_alpha1-1-x86_64.pkg.tar.zst
    0 downloads · 2026-08-28 00:00:30 +02:00 · 30 MiB
  • linux-hello-0.1.0~alpha1-1.fc43.x86_64.rpm
    0 downloads · 2026-08-28 00:00:35 +02:00 · 20 MiB
  • linux-hello-0.1.0~alpha1-1.fc44.x86_64.rpm
    0 downloads · 2026-08-28 00:00:32 +02:00 · 21 MiB
  • linux-hello-debug-0.1.0_alpha1-1-x86_64.pkg.tar.zst
    0 downloads · 2026-08-28 00:00:30 +02:00 · 11 KiB
  • linux-hello-debuginfo-0.1.0~alpha1-1.fc43.x86_64.rpm
    0 downloads · 2026-08-28 00:00:37 +02:00 · 122 MiB
  • linux-hello-debuginfo-0.1.0~alpha1-1.fc44.x86_64.rpm
    0 downloads · 2026-08-28 00:00:35 +02:00 · 123 MiB
  • linux-hello-debugsource-0.1.0~alpha1-1.fc43.x86_64.rpm
    0 downloads · 2026-08-28 00:00:35 +02:00 · 430 KiB
  • linux-hello-debugsource-0.1.0~alpha1-1.fc44.x86_64.rpm
    0 downloads · 2026-08-28 00:00:32 +02:00 · 429 KiB
  • linux-hello_0.1.0-alpha1-1_amd64.deb
    0 downloads · 2026-08-28 00:00:31 +02:00 · 19 MiB
  • linux-hello_0.1.0-alpha1-1_amd64.deb
    0 downloads · 2026-08-28 00:00:32 +02:00 · 20 MiB
  • linux-hello_0.1.0-alpha1-1_amd64.deb
    0 downloads · 2026-08-28 00:00:31 +02:00 · 20 MiB
  • linux-hello_0.1.0-alpha1-1_amd64.deb
    0 downloads · 2026-08-28 00:00:29 +02:00 · 21 MiB