Skip to content

v1.0.0 - FaceUnlock for macOS

Choose a tag to compare

View all tags
@sh4dow-clone sh4dow-clone released this 18 Jul 14:27
· 2 commits to main since this release
v1.0.0
770687a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Face-recognition unlock daemon for macOS. Wake the display, press Space/Return on the lock screen, and FaceUnlock types your password for you. Everything runs on-device - no network, no telemetry.

Highlights

  • ArcFace on the Apple Neural Engine : 7-pose enrollment, landmark-aligned 112x112 crops, best-of-N frame averaging, TTA flip, CLAHE + gamma exposure normalization for reliable indoor matching.
  • Working distance ~20–70cm with ROI filtering so background people are ignored.
  • Movement-based liveness: flat photos and screenshots can't pass.
  • AES-GCM encryption of both password and enrolled embeddings, session key held in the Keychain behind Touch ID.
  • Hardened Runtime + PT_DENY_ATTACH in release. Zero network, zero AppleEvents entitlements.
  • Menu bar agent: Dock icon optional.

Requirements

  • macOS 14 (Sonoma) or later, Apple Silicon recommended
  • Camera + Accessibility permission
  • Touch ID or a device password

See the README for setup, threat model, and architecture.

Assets 3
Loading