https://github.com/maxchehab/face-authenticator
Script that unlocks your desktop with your face.
https://github.com/maxchehab/face-authenticator
Last synced: about 1 month ago
JSON representation
Script that unlocks your desktop with your face.
- Host: GitHub
- URL: https://github.com/maxchehab/face-authenticator
- Owner: maxchehab
- Created: 2018-03-19T20:12:25.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2018-04-24T22:39:38.000Z (about 7 years ago)
- Last Synced: 2025-01-30T21:57:21.992Z (3 months ago)
- Language: Python
- Homepage:
- Size: 176 KB
- Stars: 3
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Face Authenticator
Script that unlocks your Gnome 3 desktop if your face is present.
## How it works
Using a python [face recognition](https://github.com/ageitgey/face_recognition) library the program queries d-bus to unlock your Gnome 3 desktop.
## Warning
This drasticaly increases the risk of a random stranger unlocking your computer. Although the face authentication algorithm may be sound, a simple image of your face will suffice to unlock your device.
## Installation
I can only confirm this program works with Ubuntu 17.10 and Gnome 3.
```
git clone https://github.com/maxchehab/face-authenticator
cd face-authenticator
make install
```
This will install the neccessary files to run the authentication deamon.
You must now provide the program with an image of your face.
```
make authorize image="/path/to/your/face.jpg"
```
Finally, restart your computer or gdm.
## Uninstallation
To remove the authenticator simply:
```
rm -rf $HOME/.face-authenticator
rm $HOME/.config/autostart/face-authenticator.desktop
reboot
```
## Contact
Feel free to reach out to me at [twitter](https://twitter.com/maxchehab) or report an [issue](https://github.com/maxchehab/face-authenticator/issues) if there are any problems.