fingerprint-reader.md

Fingerprint Reader

The fingerprint reader is supported by libfprintd and fprintd software. The current version in FreeBSD ports is very old, so you'll have to build from the fixed port.

Building and Installing

Build it from our fork of freebsd-ports:

# Prepare
git clone https://github.com/FrameworkComputer/freebsd-ports
cd freebsd-ports
git checkout fprint

# Build
cd security/libfprint
sudo make install-missing-packages
make
cd securiy/fprintd
make

# Install
sudo make install

Configuring

Once you have installed fprintd, you can set up your Login Manager, lockscreen and so on, to use it. The Arch Wiki has detailed instructions: https://wiki.archlinux.org/title/Fprint Note that on FreeBSD the etc files are in /usr/local/etc/, not in /etc.

Add the following as the first line to:

• /usr/local/etc/pam.d/kde
• /usr/local/etc/pam.d/sudo

auth            sufficient      pam_fprintd.so

Enrolling and testing

fprintd-enroll
fprintd-verify

Upstreaming effort

• freebsd-ports
  • branch with all changes
• libfprint
  • branch with all changes
  • Merge requests
    • Allow build on non-Linux systems (disable SPI)
• fprintd
  • branch with all changes
  • Merge Requests
    • freebsd: Fix building on FreeBSD
    • pam: Allow build with OpenPAM instead of linux-pam
    • pam: Allow build with basu instead of libsystemd

Manually building forks

git clone https://gitlab.freedesktop.org/JohnAZoidberg/libfprint
cd libfprint
git checkout freebsd-usb
meson -Dudev_rules=disabled -Dudev_hwdb=disabled build
ninja -C build

git clone https://gitlab.freedesktop.org/JohnAZoidberg/fprintd
cd fprintd
git checkout freebsd
meson -Dlibsystemd=basu -Dsystemd=false -Dopenpam=true -Dpam_modules_dir=/usr/local/lib build
ninja -C build