Repository navigation
v1.1.0 - Goodix GM168 Linux Biometric Suite (Stable Release)
Goodix GM168 Linux Biometric Driver & DRFM Suite — Release v1.1.0 (Stable)
Production-ready Linux biometric driver, PAM authentication stack, and modern GTK4 management suite for Goodix GM168 (27c6:581a / 27c6:589a) fingerprint sensors found in Xiaomi RedmiBook Pro 14S / 15 and Mi NoteBook Ultra.
🌟 What's New in v1.1.0
- Zero-FAR Windows Hello Enclave Parity: Implements our reverse-engineered Dense Ridge-Flow Matcher (DRFM) and Adaptive Template Learning (
gx_templateStudy) to completely replace the broken standard LinuxfprintdBozorth3 algorithm. - 16-Stage Multi-Zone Guided Enrollment:
- Full support for 4 anatomical finger zones: Center Pad, Fingertip, Left Edge, and Right Edge.
- Built-in 1.8-second finger-lift reset interval with intuitive visual cues, ensuring clean capacitive baseline calibration between stages.
- Robust Hardware Concurrency: Cross-process hardware mutex locking (
/run/goodix_sensor.lock) to eliminate USB bus resets anderrno=16 (Device or resource busy)contention. - Seamless System PAM Integration: Fast, reliable biometric unlock for
sudoterminal commands, lock screen (Super + L), and GDM / system login. - Multi-Ubuntu ABI Compatibility: Seamless out-of-the-box compatibility across Ubuntu 22.04 LTS, 24.04 LTS, 24.10, and 26.04 (Resolute).
- User Convenience: Added terminal CLI command
goodix-enrolland Desktop application launcher.
📦 Quick Installation
Method 1: Automated One-Liner (Recommended)
curl -fsSL https://raw.githubusercontent.com/shohagranasuvo/linux-fingerprint-sensor-solution/main/install.sh | sudo bashMethod 2: Install via Debian (.deb) Package
Download goodix-gm168-linux-driver_1.1.0_amd64.deb below and run:
sudo dpkg -i goodix-gm168-linux-driver_1.1.0_amd64.deb
sudo apt-get install -f🚀 Getting Started
Launch the application by running:
goodix-enrollOr click Goodix Fingerprint Suite in your application launcher menu.