Skip to content

Instantly share code, notes, and snippets.

@AmulyaX
Last active October 16, 2025 20:28
Show Gist options
  • Save AmulyaX/7d050daffe3429c409effe1111bb65ae to your computer and use it in GitHub Desktop.
Save AmulyaX/7d050daffe3429c409effe1111bb65ae to your computer and use it in GitHub Desktop.
Use custom built libfprint to add fixes for specific drivers
# Install deps
sudo apt install meson ninja-build build-essential git pkg-config libglib2.0-dev libgusb-dev libnss3-dev libpam-dev libudev-dev libusb-1.0-0-dev
# Clone fprintd source code
git clone https://gitlab.freedesktop.org/libfprint/libfprint.git
# Checkout to our good guy who made a patch for sensor
# 1c7a:0587 LighTuning Technology Inc. ETU905A88-E
git fetch "https://gitlab.freedesktop.org/thameruddin/libfprint.git" 'egismoc-0587'
git checkout -b 'libfprint-egismoc-0587' FETCH_HEAD
# Try building the code
cd libfprint
meson setup builddir
ninja -C builddir
sudo ninja -C builddir install
sudo ldconfig
# Above command will install everything to /usr/local/
sudo apt install fprintd libpam-fprintd
### IMPORTANT
### Try not to install the libfprint via apt, if the above debs are not being installed without this, either install and
### purge later or create a symbolic link to our custom build libfprint.so (Feel free to ask if you need help with this)
Refer to following comments for more help:
https://gist.github.com/AmulyaX/7d050daffe3429c409effe1111bb65ae?permalink_comment_id=5776944#gistcomment-5776944
https://gist.github.com/AmulyaX/7d050daffe3429c409effe1111bb65ae?permalink_comment_id=5212157#gistcomment-5212157
@theT4mer
Copy link

For me, the factory reset fails at the "sudo validity-sensors-firmware" step and it seems to do so because it finds no matching devices. Same problem when trying to enable python3-validity :(. However, when running the lsusb command, the device shows up as follows:
Bus 001 Device 055: ID 1c7a:0587 LighTuning Technology Inc. ETU905A88-E
Hardwarewise, i have more or less the same setup as @Skywalker8510, but a Zenbook.

@Doudoube
Copy link

Doudoube commented Aug 28, 2024

For me, lets see following result under linux mint :
dider@ego:$ lsusb
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 003: ID 3277:0010 Sonix Technology Co., Ltd. USB2.0 FHD UVC WebCam
Bus 001 Device 004: ID 1c7a:0587 LighTuning Technology Inc. ETU905A88-E
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 003 Device 002: ID 13d3:3568 IMC Networks Wireless_Device
Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
dider@ego:
$ fprintd-
fprintd-delete fprintd-enroll fprintd-list fprintd-verify
dider@ego:~$ fprintd-verify
Using device /net/reactivated/Fprint/Device/0
Listing enrolled fingers:

  • #0: right-index-finger
    Verify started!
    Verifying: right-index-finger
    Verify resul

@maks
Copy link

maks commented Aug 29, 2024

For future readers, on Ubuntu 24.04 I needed to install the following build dependencies to build libfprint from source:

sudo apt install libgusb-dev  gobject-introspection libnss3-dev libudev-dev libgudev-1.0-dev gtk-doc-tools cmaks libpixman-1-dev

and I ran the meson commands as a normal user without using sudo but did allow it to use sudo for the final install step of meson install -C builddir

@routadu
Copy link

routadu commented Sep 9, 2024

I'm currently using Asus Zenbook UX3402VA with Ubuntu 24.04 and followed all the steps of installation.
The installation was successful with no errors.

But I'm still getting this error while trying to enroll my fingerprint:

Impossible to enroll: GDBus.Error:net.reactivated.Fprint.Error.NoSuchDevice: No devices available

The fingerprint reader does show up in lsusb command

LighTuning Technology Inc. ETU905A88-E

@rk4500
Copy link

rk4500 commented Sep 30, 2024

I was having issues installing the compiled library to /usr/local with the original commands.
For me, I had to first run:
sudo apt purge --auto-remove fprintd libfprint-2-2
To remove the old library.

Then install with:
sudo ninja -C builddir install

Then I also was getting an error when trying to run "sudo apt install fprintd fprintd-pam"
So instead, I had to install:
sudo apt install libpam-fprintd

Finally, fprintd-enroll worked, and the fingerprint option in 24.04 Gnome settings came back too.

(I have an Asus Vivobook Pro 16 OLED which has a LighTuning Technology Inc. ETU905A88-E fingerprint reader (ID 1c7a:0587) the updated libfprint library helped get it finally working!)

@Doudoube
Copy link

For your information, ETU905A88-E driver is now implemented on libfprint v.1.94.8 as u can see here ๐Ÿ‘
https://gitlab.freedesktop.org/libfprint/libfprint/-/releases

@antoskuu
Copy link

For your information, ETU905A88-E driver is now implemented on libfprint v.1.94.8 as u can see here ๐Ÿ‘ https://gitlab.freedesktop.org/libfprint/libfprint/-/releases

I still can't get it to work on Pop_Os, with the commands from above. I have exactly the ETU905A88-E sensor.

What i do :
sudo apt remove fprintd libpam-fprintd
sudo apt purge --auto-remove fprintd libfprint-2-2
git clone https://gitlab.freedesktop.org/libfprint/libfprint.git
cd libfprint
sudo meson setup builddir (or sudo meson builddir ?)
sudo meson install -C builddir
sudo apt install fprintd libpam-fprintd

and during fprintd-enroll either my finger is not detected, or it is, and afterwards during verify its not detected... any help?
thank you very much

@Doudoube
Copy link

For your information, ETU905A88-E driver is now implemented on libfprint v.1.94.8 as u can see here ๐Ÿ‘ https://gitlab.freedesktop.org/libfprint/libfprint/-/releases

I still can't get it to work on Pop_Os, with the commands from above. I have exactly the ETU905A88-E sensor.

What i do : sudo apt remove fprintd libpam-fprintd sudo apt purge --auto-remove fprintd libfprint-2-2 git clone https://gitlab.freedesktop.org/libfprint/libfprint.git cd libfprint sudo meson setup builddir (or sudo meson builddir ?) sudo meson install -C builddir sudo apt install fprintd libpam-fprintd

and during fprintd-enroll either my finger is not detected, or it is, and afterwards during verify its not detected... any help? thank you very much

I don't know POP'OS.
I think you must install the libfprint v.1.94.8 driver and install it, it should work...

@averagenokiauser
Copy link

I am on Debian. My fingerprint reader is VFS491 (138a:003d). This is not the same reader as here but i am trying to do something like people here are. Someone already did this: https://github.com/ludwhe/libfprint/. I think he just forked some drivers for my Fingerprint reader and then just updated libfprint version? I donโ€™t know much about this and would be really happy if someone could assist me.

@boevski
Copy link

boevski commented May 14, 2025

For your information, ETU905A88-E driver is now implemented on libfprint v.1.94.8 as u can see here ๐Ÿ‘ https://gitlab.freedesktop.org/libfprint/libfprint/-/releases

Could somebody explain why the same device model (ETU905A88-E) is being reported by lsusb with different hex numbers (i.e. 1c7a:0583, 1c7a:0584, 1c7a:0587) and how does it matter?

As @Doudoube mentions, the driver does seem to be implemented, but the release notes only mention "egismoc: New PIDs 0x0583, 0x0586, 0x0587" while my sensor is showing 0584 and, consequently, is not being recognized by fprintd.service.

@Luis97Lopez
Copy link

I was having issues installing the compiled library to /usr/local with the original commands. For me, I had to first run: sudo apt purge --auto-remove fprintd libfprint-2-2 To remove the old library.

Then install with: sudo ninja -C builddir install

Then I also was getting an error when trying to run "sudo apt install fprintd fprintd-pam" So instead, I had to install: sudo apt install libpam-fprintd

Finally, fprintd-enroll worked, and the fingerprint option in 24.04 Gnome settings came back too.

(I have an Asus Vivobook Pro 16 OLED which has a LighTuning Technology Inc. ETU905A88-E fingerprint reader (ID 1c7a:0587) the updated libfprint library helped get it finally working!)

Worked for me with ASUS Zenbook D14 UX3402

@merijnvervoorn
Copy link

For my ASUS Zenbook 14 (UX3402V) with reader LighTuning Technology Inc. ETU905A88-E (Find this with lsusb) running Ubuntu the following managed the job:

sudo apt install meson ninja-build build-essential git pkg-config libglib2.0-dev libgusb-dev libnss3-dev libpam-dev libudev-dev libusb-1.0-0-dev

Download latest release and extract: https://gitlab.freedesktop.org/libfprint/libfprint/-/releases

Using terminal cd into the extracted folder.

meson setup builddir
ninja -C builddir
sudo ninja -C builddir install
sudo ldconfig

To use the fingerprint scanner:

sudo apt install fprintd libpam-fprintd

fprintd-enroll 

->Now it should say "Using device /net/reactivated/Fprint/Device/4 \ Enrolling right-index-finger finger."
->Place your finger on the scanner and take it off, replace and continue until "Enroll result: enroll-completed"

sudo pam-auth-update

-> scroll down to "Fingerprint authentication" and make sure to check that (with space), hit enter.

Now it should work

@AmulyaX
Copy link
Author

AmulyaX commented Oct 13, 2025

I was having issues installing the compiled library to /usr/local with the original commands. For me, I had to first run: sudo apt purge --auto-remove fprintd libfprint-2-2 To remove the old library.

Then install with: sudo ninja -C builddir install

Then I also was getting an error when trying to run "sudo apt install fprintd fprintd-pam" So instead, I had to install: sudo apt install libpam-fprintd

Finally, fprintd-enroll worked, and the fingerprint option in 24.04 Gnome settings came back too.

(I have an Asus Vivobook Pro 16 OLED which has a LighTuning Technology Inc. ETU905A88-E fingerprint reader (ID 1c7a:0587) the updated libfprint library helped get it finally working!)

For my ASUS Zenbook 14 (UX3402V) with reader LighTuning Technology Inc. ETU905A88-E (Find this with lsusb) running Ubuntu the following managed the job:

sudo apt install meson ninja-build build-essential git pkg-config libglib2.0-dev libgusb-dev libnss3-dev libpam-dev libudev-dev libusb-1.0-0-dev

Download latest release and extract: https://gitlab.freedesktop.org/libfprint/libfprint/-/releases

Using terminal cd into the extracted folder.

meson setup builddir
ninja -C builddir
sudo ninja -C builddir install
sudo ldconfig

To use the fingerprint scanner:

sudo apt install fprintd libpam-fprintd

fprintd-enroll 

->Now it should say "Using device /net/reactivated/Fprint/Device/4 \ Enrolling right-index-finger finger." ->Place your finger on the scanner and take it off, replace and continue until "Enroll result: enroll-completed"

sudo pam-auth-update

-> scroll down to "Fingerprint authentication" and make sure to check that (with space), hit enter.

Now it should work

Thanks guys for keeping the troubleshooting up-to-date, I sold my old laptop sometime ago, so I cannot confirm what works and what doesn't but having faith on you, I have updated the original gist and tagged your comments. Thanks again, long live open source.

@vmax71
Copy link

vmax71 commented Oct 16, 2025

Hello everyone I have a debian 13 over Acer Swift SF14-61T. I followed the tips and I installed fprintd and libfprintd (https://github.com/TenSeventy7/libfprint-egismoc-sdcp). Issues:

  1. when I try to install libpam-fprintd, the system wants install fprintd and libfprintd from debian repository, overwrite the previous one.
  2. fprintd-enroll: Failed to get Fprintd manager: Error calling StartServiceByName for net.reactivated.Fprint: Failed to activate service 'net.reactivated.Fprint': timed out (service_start_timeout=25000ms)
    Anybody could help me please?
    Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment