How harshjsh01/rio.facelock works
This repository is a small Omarchy/Quickshell biometric desktop plugin. Its documented workflow connects the desktop service to the session manager and PAM-backed authentication; the lock view presents the animated scan, success state, and password fallback. The README also describes face and fingerprint authentication across lock screen, SDDM, sudo, and Polkit, plus separate cold-boot disk protection. No source excerpts were provided, so links beyond these documented relationships are omitted.
Main entry points: Service.qml Quickshell Service · LockView.qml Lock Screen UI
Components 12
Desktop Plugin
- Quickshell Service
Service.qml - Lock Screen UI
LockView.qml - Plugin Manifest
manifest.json
Authentication
- PAM Stack
- Face Recognition
- Fingerprint Service
- System Auth Entry Points
System Integrations
- Omarchy Session Manager
- ONNX Runtime
- Camera
- Cold-Boot Disk Unlock
Other components
- User
Connections 9
- User → Lock Screen UI: uses
- Quickshell Service → Omarchy Session Manager: connects to
- Quickshell Service → PAM Stack: interfaces with
- System Auth Entry Points → PAM Stack: requests authentication
- PAM Stack → Face Recognition: uses face auth
- PAM Stack → Fingerprint Service: uses fingerprint
- Face Recognition → Camera: captures image
- Face Recognition → ONNX Runtime: runs inference
- User → Cold-Boot Disk Unlock: unlocks disk