Repository navigation
v1.0.0 - Linux Fingerprint Sensor Solution
🚀 Linux Fingerprint Sensor Solution v1.0.0
First official release of the Linux Fingerprint Sensor Solution, a native driver, PAM biometric authentication module, and GTK3 management suite for Goodix GM168 (27c6:581a, 27c6:589a) capacitive fingerprint sensors found in Xiaomi RedmiBook Pro 14S / 15 and Xiaomi Mi NoteBook Ultra laptops.
✨ Key Features
- Dense Ridge-Flow Matcher (DRFM): Replaces broken Bozorth3 with a 2D affine RANSAC ridge-flow matcher tailored for compact 80x64 sensor matrices.
- Windows Hello Enclave Parity: Reverse-engineered from official Goodix Windows 11 drivers (
GoodixEngineAdapter.dll&AdapterEnclave.signed.dll). - Zero-FAR Security Verification Gates: Multi-octave physical spatial deduplication,
valid_areabounding spread (>= 12%), rigid skin scale bounds (0.92 - 1.08), and dense ridge patch Normalized Cross-Correlation (NCC >= 0.28). - Linux PAM System Authentication: Passwordless
sudo, lock screen (Super + L), and desktop login. - Adaptive Template Study (
gx_templateStudy): Dynamically refines enrolled templates over time for changes in skin moisture and seasonal variations. - Modern GTK3 Biometric Suite GUI: Real-time sensor preview, 16-stage multi-angle enrollment wizard, and live telemetry monitor.
📦 Installation
Quick One-Line Install:
curl -fsSL https://raw.githubusercontent.com/shohagranasuvo/linux-fingerprint-sensor-solution/main/install.sh | sudo bashDebian / Ubuntu Package:
Download goodix-gm168-linux-driver_1.0.0_amd64.deb below and run:
sudo dpkg -i goodix-gm168-linux-driver_1.0.0_amd64.deb
sudo apt-get install -f