177 lines
5.3 KiB
Markdown
177 lines
5.3 KiB
Markdown
<p align="center">
|
|
<img width="200" src="res/face-unlock.svg" alt="face-unlock">
|
|
</p>
|
|
|
|
<h1 align="center">face-unlock</h1>
|
|
|
|
<h3 align="center">Face ID for Linux.</h3>
|
|
|
|
<p align="center">
|
|
Unlock the lock screen, sudo and admin prompts with your face.<br>
|
|
On KDE Plasma, GNOME, Hyprland and Niri.
|
|
</p>
|
|
|
|
<h5 align="center">
|
|
<a href="#install">Install</a> |
|
|
<a href="#how-to-use">How to use</a> |
|
|
<a href="#is-it-safe">Is it safe?</a> |
|
|
<a href="https://github.com/LoonixTools/face-unlock/issues">Report a bug</a>
|
|
</h5>
|
|
|
|
<p align="center">
|
|
<a href="https://ko-fi.com/felitendo"><img src="https://storage.ko-fi.com/cdn/kofi5.png?v=6" alt="Buy me a coffee on Ko-fi" height="48"></a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img src="res/screenshots/unlock.webp" alt="The bubble drops down over the lock screen, the face in it looks around, and two green rings spin and land around a tick" width="480">
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img src="res/screenshots/bubble.png" alt="The bubble above the Plasma lock screen: looking, recognised, not recognised" width="720">
|
|
</p>
|
|
|
|
## Install
|
|
|
|
<details>
|
|
<summary><b>Arch</b>, CachyOS, EndeavourOS, Manjaro</summary>
|
|
|
|
```bash
|
|
yay -S face-unlock
|
|
```
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary><b>Fedora</b></summary>
|
|
|
|
```bash
|
|
sudo curl -fsSL -o /etc/yum.repos.d/face-unlock.repo \
|
|
https://loonixtools.github.io/face-unlock/face-unlock.repo
|
|
sudo dnf install face-unlock
|
|
```
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary><b>Debian</b>, Ubuntu</summary>
|
|
|
|
```bash
|
|
codename="$(sed -n 's/^VERSION_CODENAME=//p' /etc/os-release)"
|
|
sudo install -d -m 0755 /etc/apt/keyrings
|
|
curl -fsSL https://loonixtools.github.io/face-unlock/KEY.gpg \
|
|
| sudo gpg --dearmor -o /etc/apt/keyrings/face-unlock.gpg
|
|
echo "deb [signed-by=/etc/apt/keyrings/face-unlock.gpg] https://loonixtools.github.io/face-unlock/deb/$codename ./" \
|
|
| sudo tee /etc/apt/sources.list.d/face-unlock.list
|
|
sudo apt update && sudo apt install face-unlock
|
|
```
|
|
|
|
</details>
|
|
|
|
Updates come with your system updates. It needs a camera and one of these
|
|
desktops, on Wayland:
|
|
|
|
| | Lock screen | sudo and admin prompts | Bubble on the lock screen |
|
|
|---|---|---|---|
|
|
| KDE Plasma 6 | ✅ | ✅ | ✅ |
|
|
| GNOME | ✅ | ✅ | ✅ |
|
|
| Hyprland | ✅ | ✅ | ✅ on face-unlock's own |
|
|
| Niri | ✅ | ✅ | ✅ on face-unlock's own |
|
|
|
|
- **GNOME:** log out and back in once after installing, so the bubble can show.
|
|
- **Hyprland and Niri:** you need a polkit agent. The menu installs one if it is missing.
|
|
|
|
<details>
|
|
<summary>Hyprland and Niri: which lock screen?</summary>
|
|
|
|
<p align="center">
|
|
<img src="res/screenshots/lock-choice.png" alt="The window that asks which lock screen to use: face-unlock's with the bubble on the left, the user's own hyprlock with a line of text at the top on the right" width="560">
|
|
</p>
|
|
|
|
When you turn face unlock on, a window asks which lock screen you want. You
|
|
can change it later under **Settings**.
|
|
|
|
- **face-unlock's own:** the bubble, the time and your wallpaper. You lock with
|
|
`face-unlock lock`, and the menu shows where to put that.
|
|
- **Yours** (hyprlock, swaylock, gtklock or waylock): press Enter on the empty
|
|
password field to scan. hyprlock and swaylock also scan when you come back.
|
|
There is no bubble, but hyprlock shows a line of text at the top.
|
|
|
|
Hyprland without uwsm needs a line in its config. The menu shows it.
|
|
|
|
</details>
|
|
|
|
## How to use
|
|
|
|
```bash
|
|
face-unlock
|
|
```
|
|
|
|
<p align="center">
|
|
<img src="res/screenshots/menu.png" alt="The face-unlock menu in Konsole: face unlock on, one face, lock screen, sudo and admin prompts on" width="560">
|
|
</p>
|
|
|
|
Press **1** and look at the camera. Then lock the screen and look at it.
|
|
|
|
<details>
|
|
<summary>Settings</summary>
|
|
|
|
<p align="center">
|
|
<img src="res/screenshots/settings.png" alt="The settings in Konsole, grouped into lock screen, password prompts, recognition and bubble, with the photo check explained at the bottom" width="680">
|
|
</p>
|
|
|
|
</details>
|
|
|
|
## Is it safe?
|
|
|
|
A convenience, not extra security. A webcam only sees a flat picture.
|
|
|
|
| | |
|
|
|---|---|
|
|
| Photo or video on a phone, tablet or glossy screen | ✅ Stopped |
|
|
| Matte printed photo | ⚠️ Only stopped with photo check *strict* |
|
|
| Video of you on a big matte screen | ❌ Can get in |
|
|
| Five failed tries | ⏸️ Paused for 15 minutes |
|
|
| Your face data | 🔒 Numbers, no pictures. Root only. |
|
|
| sudo over SSH | 🚫 Never unlocked by a face |
|
|
|
|
## More
|
|
|
|
<details>
|
|
<summary>How it works</summary>
|
|
|
|
| | |
|
|
|---|---|
|
|
| `face-unlockd` | The root service. Owns the camera and the face data. |
|
|
| `face-unlock-agent` | Runs in your session. Watches the lock screen, draws the bubble. |
|
|
| `pam_face_unlock.so` | Lets sudo and admin prompts ask the service. |
|
|
| `face-unlock` | The menu. |
|
|
|
|
Two small networks from the OpenCV model zoo run on the CPU: YuNet finds the face, SFace turns it
|
|
into numbers. All details: `man face-unlock`.
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>Build from source</summary>
|
|
|
|
```bash
|
|
make models
|
|
make
|
|
make test
|
|
sudo make install
|
|
```
|
|
|
|
Needs CMake, a C++20 compiler, Qt 6, LayerShellQt, KI18n, OpenCV 4.5.4+ (with DNN), Linux-PAM and
|
|
libsystemd.
|
|
|
|
</details>
|
|
|
|
## Credits
|
|
|
|
- [Glance](https://github.com/jonnyoo/glance) by Jonathan Zhou: the idea and the look of the bubble.
|
|
- [YuNet](https://github.com/opencv/opencv_zoo/tree/main/models/face_detection_yunet) and
|
|
[SFace](https://github.com/opencv/opencv_zoo/tree/main/models/face_recognition_sface) from the
|
|
OpenCV model zoo.
|
|
|
|
GPL-3.0-or-later.
|