OpenMacApps

Mugshot

Local face recognition for sudo and unlocking a locked session, with an animated HUD that opens from the camera notch.

MIT · Downloads from github.com

License
MIT
Open source
Category
Privacy & security
Source
GitHub
Lorenzo-Coslado
Verified
2026

About Mugshot

Mugshot checks your face through the webcam when sudo asks for a password. It can also unlock a session that is already logged in and locked. A HUD grows out of the camera notch while it scans and falls back to your password when recognition fails. Recognition runs on the Mac with OpenCV's YuNet and SFace models. Enrolled face data stays in ~/Library/Application Support/faceid, and camera frames are not uploaded.

It requires an Apple Silicon Mac on macOS 14 or later, plus a webcam. Public releases are signed with a Developer ID and notarized according to the project's release procedure. A 2D webcam can be fooled by a photo or video, so this is a convenience, not a replacement for stronger authentication. Lock-screen unlock is off by default and stores your Mac login password in the Keychain. It cannot unlock FileVault or handle the first login after a restart. Setup needs camera and Accessibility approval and a privileged helper.

Information

Source code
Lorenzo-Coslado/macos-faceid
License
MIT
Website
github.com
Download
github.com
Category
Privacy & security
Topics
Menu bar apps
Evidence checked

OpenMacApps links to each project’s official download. Check its release notes for macOS version and Apple silicon support. The verification date records our license and source review, not a security audit. Read how we verify.

Sources and image credits

License and artwork notices

Improve this listing

For the Developer

Link to this page from your README with a badge.

Listed on OpenMacApps
[![Listed on OpenMacApps](https://openmacapps.com/badge.svg)](https://openmacapps.com/apps/mugshot/)
See All You Might Also Like