LinuxCommandLibrary

fprintd-list

List enrolled fingerprint devices and prints

TLDR

List enrolled fingerprints for a specific user

$ fprintd-list [username]
copy

List enrolled fingerprints for one or more users
$ fprintd-list [username1 username2 ...]
copy

Display help
$ fprintd-list
copy

SYNOPSIS

fprintd-list [-a, --all]

PARAMETERS

-a, --all
    List fingerprints enrolled by all users (requires Polkit authorization)

DESCRIPTION

fprintd-list is a command-line tool from the fprintd package, used to query and display fingerprints enrolled with the fprintd fingerprint authentication daemon on Linux systems.

fprintd provides D-Bus interfaces for managing fingerprint readers, supporting various hardware via libfprint drivers. By default, fprintd-list shows fingerprints enrolled for the current user, grouped by device driver. Output includes driver name, number of prints, and human-readable labels like right-index-finger.

For example, it might display:
Driver: libfprint-2-tod1-goodix-3268u (1 fingerprint)
Print 0: right-index-finger


The --all option lists fingerprints across all users, requiring elevated privileges via Polkit. This is useful for administrators managing shared systems. The command communicates with the running fprintd service, so the daemon must be active and a supported reader present.

It's part of biometric authentication workflows, aiding PAM integration for passwordless logins. No direct modification occurs; use companion tools like fprintd-enroll for enrollment.

CAVEATS

Requires running fprintd daemon; --all needs admin privileges via sudo or Polkit agent. No output if no fingerprints enrolled or unsupported hardware.

EXAMPLE OUTPUT

$ fprintd-list
Driver: libfprint-2-tod1-vfs9xxx (2 fingerprints)
  Print 0: left-thumb
  Print 1: right-thumb


$ sudo fprintd-list --all # Shows all users

DEPENDENCIES

Requires fprintd service: systemctl --user start fprintd or system-wide.

HISTORY

Part of fprint project (since ~2007); fprintd daemon introduced ~2010 for D-Bus integration, actively maintained for modern libfprint v1/v2 drivers.

SEE ALSO

Copied to clipboard