whatisgithub

What is irlume?

archledger/irlume — explained in plain English

Analysis updated 2026-05-18

9RustAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

Irlume brings Windows Hello style face unlock to Linux login, lock screen, and sudo, storing only encrypted face embeddings instead of images.

Mindmap

mindmap
  root((irlume))
    What it does
      Face unlock for Linux login
      Lock screen unlock
      Optional sudo unlock
      Password always works
    Tech stack
      Rust
      Linux PAM
      TPM 2.0
      IR camera support
    Use cases
      Passwordless login
      Secure sudo access
      Encrypted face templates
    Security
      Anti spoofing checks
      TPM sealed keys
      No stored face images

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Unlock your Linux login screen and lock screen using face recognition instead of typing a password.

USE CASE 2

Enable opt-in face-based sudo authentication with a password fallback that never locks you out.

USE CASE 3

Use a TPM chip to encrypt stored face data and unseal your login keyring on successful face match.

What is it built with?

RustLinuxPAMTPM

How does it compare?

archledger/irlumecodeitlikemiley/wazloslos321-lab/goldworm
Stars999
LanguageRustRustRust
Last pushed2026-07-09
MaintenanceActive
Setup difficultymoderatemoderatemoderate
Complexity3/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires x86-64 Linux with systemd and PAM, a TPM 2.0 chip is recommended but not required.

GPL v3: you can use and modify the code freely, but any distributed derivative work must also be released under the same license.

So what is it?

Irlume brings Windows Hello style face unlocking to Linux. It lets you log in, unlock your screen, and optionally use sudo just by looking at your camera, instead of typing a password every time. The password always still works as a fallback, so you can never be locked out even if the camera fails to recognize you. It works with different kinds of cameras: an infrared camera, the same type used by Windows Hello laptops, unlocks a full secure mode that even works in the dark, a regular webcam gives a more convenient screen unlock, and a fingerprint reader can be added as an extra factor. The camera only turns on when you ask it to, by leaving the password field empty and pressing enter, so it is never silently watching. Rather than storing a picture of your face, it stores a mathematical representation of it, and on computers with a TPM security chip, that data is encrypted using a key sealed inside the chip itself, so it cannot simply be read off a stolen hard drive. It also includes checks meant to stop someone from tricking it with a photo or a video of your face displayed on a screen, and the README is upfront that a particularly good glossy printed photo can still fool the default settings, with an optional blink detection feature available to close that gap at the cost of a slightly slower login. The project compares itself directly against Windows Hello and two existing open-source Linux face-unlock projects, arguing it is more secure than both on template protection and camera-injection defenses. It installs with a single command that detects your Linux distribution, Fedora, Ubuntu, Arch, Debian, and their common variants are all supported, and a guided setup tool walks you through enrolling your face and wiring it into your login screen. A TPM security chip is strongly recommended but not required to use the tool. It is released under the GPL version 3 license.

Copy-paste prompts

Prompt 1
Walk me through installing irlume on my Linux distribution and enrolling my face.
Prompt 2
Explain how irlume protects against someone using a photo or video to fake a face unlock.
Prompt 3
How does irlume use a TPM chip to protect stored face data compared to storing it as a plain file?
Prompt 4
Show me how to enable face-based sudo with irlume using the login enable command.

Frequently asked questions

What is irlume?

Irlume brings Windows Hello style face unlock to Linux login, lock screen, and sudo, storing only encrypted face embeddings instead of images.

What language is irlume written in?

Mainly Rust. The stack also includes Rust, Linux, PAM.

What license does irlume use?

GPL v3: you can use and modify the code freely, but any distributed derivative work must also be released under the same license.

How hard is irlume to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is irlume for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.