Skip to content

v1.0.0 - Linux Fingerprint Sensor Solution

Choose a tag to compare

@shohagranasuvo shohagranasuvo released this 05 Nov 22:16
· 12 commits to main since this release

🚀 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_area bounding 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 bash

Debian / 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