/face-authenticator

Script that unlocks your desktop with your face.

Primary LanguagePython

Face Authenticator

Script that unlocks your Gnome 3 desktop if your face is present.

How it works

Using a python 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 or report an issue if there are any problems.