Fingerprint scanner - Revision history

QuBe: Add setup instructions for KDE Plasma

2026-03-24T21:44:30Z

Add setup instructions for KDE Plasma

← Older revision		Revision as of 21:44, 24 March 2026
Line 34:		Line 34:

	'''Note:''' If the ''Fingerprint Login'' item is not available, the <code>fprintd</code> driver might not be configured correctly.		'''Note:''' If the ''Fingerprint Login'' item is not available, the <code>fprintd</code> driver might not be configured correctly.

			=== KDE Plasma ===
			In [[KDE\|KDE Plasma]], the fingerprints can be configured through the Settings application.

			# Open System Monitor
			# On the menu on the left, scroll down to ''Users'' and enter it
			# Select your user
			# Enter ''Configure Fingerprint Authentication'' and follow the instructions to add your fingerprints

			'''Note:''' If the ''Configure Fingerprint Authentication'' item is not available, the <code>fprintd</code> driver might not be configured correctly.

	== Login ==		== Login ==

Phobos: syntax for code block updates

2026-02-20T21:53:55Z

syntax for code block updates

← Older revision		Revision as of 21:53, 20 February 2026
Line 2:		Line 2:

	== Install ==		== Install ==
	~~<syntaxhighlight lang~~=~~"nixos">~~		{{File\|3={ config, lib, pkgs, ... }: {
	~~# configuration.nix~~
	{ config, lib, pkgs, ... }: {
	~~# ...~~

	# Install the driver		# Install the driver
Line 21:		Line 18:
	# libfprint = pkgs.libfprint-focaltech-2808-a658;		# libfprint = pkgs.libfprint-focaltech-2808-a658;
	# };		# };
	}		}\|name=/etc/nixos/configuration.nix\|lang=nix}}
	</~~syntaxhighlight>~~

	== Enroll fingerprint ==		== Enroll fingerprint ==

Frontear: don't encourage enabling fprintd service at boot, this goes against upstream wishes and can lead to possible hardware damage, as many fingerprint scanners are not intended to remain "active" for a long time. it is more appropriate for the service to activate via dbus when it is needed, to greatly reduce this risk.

2025-10-19T20:27:10Z

don't encourage enabling fprintd service at boot, this goes against upstream wishes and can lead to possible hardware damage, as many fingerprint scanners are not intended to remain "active" for a long time. it is more appropriate for the service to activate via dbus when it is needed, to greatly reduce this risk.

← Older revision		Revision as of 20:27, 19 October 2025
Line 3:		Line 3:
	== Install ==		== Install ==
	<syntaxhighlight lang="nixos">		<syntaxhighlight lang="nixos">
	# ~~Start the driver at boot~~		# configuration.nix
	~~systemd~~.~~services~~.~~fprintd =~~ {		{ config, lib, pkgs, ... }: {
	~~wantedBy = [ "multi-user~~.~~target" ];~~		# ...
	~~serviceConfig~~.~~Type = "simple";~~
	};

	# Install the driver		# Install the driver
	services.fprintd.enable = true;		services.fprintd.enable = true;
	# If simply enabling fprintd is not enough, try enabling fprintd.tod...		# If simply enabling fprintd is not enough, try enabling fprintd.tod...
	services.fprintd.tod.enable = true;		services.fprintd.tod.enable = true;
	# ...and use one of the next four drivers		# ...and use one of the next four drivers
	services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix; # Goodix driver module		services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix; # Goodix driver module
	# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-elan; # Elan(04f3:0c4b) driver		# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-elan; # Elan(04f3:0c4b) driver
	# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-vfs0090; # (Marked as broken as of 2025/04/23!) driver for 2016 ThinkPads		# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-vfs0090; # (Marked as broken as of 2025/04/23!) driver for 2016 ThinkPads
	# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix-550a; # Goodix 550a driver (from Lenovo)		# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix-550a; # Goodix 550a driver (from Lenovo)

	# however for focaltech 2808:a658, use fprintd with overidden package (without tod)		# however for focaltech 2808:a658, use fprintd with overidden package (without tod)
	# services.fprintd.package = pkgs.fprintd.override {		# services.fprintd.package = pkgs.fprintd.override {
	# libfprint = pkgs.libfprint-focaltech-2808-a658;		# libfprint = pkgs.libfprint-focaltech-2808-a658;
	# };		# };
			}
	</syntaxhighlight>		</syntaxhighlight>

Ncfavier: fprintd-enroll doesn't need to (and shouldn't) be run as root

2025-07-05T16:42:56Z

fprintd-enroll doesn't need to (and shouldn't) be run as root

← Older revision		Revision as of 16:42, 5 July 2025
Line 29:		Line 29:

	=== CLI ===		=== CLI ===
	<syntaxhighlight lang="bash">$ ~~sudo~~ fprintd-enroll</syntaxhighlight>		<syntaxhighlight lang="bash">$ fprintd-enroll</syntaxhighlight>

	=== Gnome ===		=== Gnome ===

Thisisnotvasco: Remove unnecessary '}' from pam snippet.

2025-05-31T12:20:03Z

Remove unnecessary '}' from pam snippet.

← Older revision		Revision as of 12:20, 31 May 2025
Line 44:		Line 44:
	security.pam.services.login.fprintAuth = false;		security.pam.services.login.fprintAuth = false;
	security.pam.services.gdm-fingerprint = lib.mkIf (config.services.fprintd.enable) {		security.pam.services.gdm-fingerprint = lib.mkIf (config.services.fprintd.enable) {
	text = ''		text = ''
	auth required pam_shells.so		auth required pam_shells.so
	auth requisite pam_nologin.so		auth requisite pam_nologin.so
	auth requisite pam_faillock.so preauth		auth requisite pam_faillock.so preauth
	auth required ${pkgs.fprintd}/lib/security/pam_fprintd.so		auth required ${pkgs.fprintd}/lib/security/pam_fprintd.so
	auth optional pam_permit.so		auth optional pam_permit.so
	auth required pam_env.so		auth required pam_env.so
	auth [success=ok default=1] ${pkgs.gdm}/lib/security/pam_gdm.so		auth [success=ok default=1] ${pkgs.gdm}/lib/security/pam_gdm.so
	auth optional ${pkgs.gnome-keyring}/lib/security/pam_gnome_keyring.so		auth optional ${pkgs.gnome-keyring}/lib/security/pam_gnome_keyring.so

	account include login		account include login

	password required pam_deny.so		password required pam_deny.so

	session include login		session include login
	session optional ${pkgs.gnome-keyring}/lib/security/pam_gnome_keyring.so auto_start		session optional ${pkgs.gnome-keyring}/lib/security/pam_gnome_keyring.so auto_start
	'';		'';
	};
	};		};

	</syntaxhighlight>		</syntaxhighlight>
	[[Category:Hardware]]		[[Category:Hardware]]

Mmkaram: vfs0090 driver is marked as broken in nixpkgs

2025-04-23T05:55:06Z

vfs0090 driver is marked as broken in nixpkgs

← Older revision		Revision as of 05:55, 23 April 2025
Line 16:		Line 16:
	services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix; # Goodix driver module		services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix; # Goodix driver module
	# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-elan; # Elan(04f3:0c4b) driver		# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-elan; # Elan(04f3:0c4b) driver
	# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-vfs0090; # driver for 2016 ThinkPads		# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-vfs0090; # (Marked as broken as of 2025/04/23!) driver for 2016 ThinkPads
	# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix-550a; # Goodix 550a driver (from Lenovo)		# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix-550a; # Goodix 550a driver (from Lenovo)

Martials: gdm and gnome-keyring was moved to top-level

2025-02-02T16:48:58Z

gdm and gnome-keyring was moved to top-level

← Older revision		Revision as of 16:48, 2 February 2025
Line 51:		Line 51:
	auth optional pam_permit.so		auth optional pam_permit.so
	auth required pam_env.so		auth required pam_env.so
	auth [success=ok default=1] ${pkgs~~.gnome~~.gdm}/lib/security/pam_gdm.so		auth [success=ok default=1] ${pkgs.gdm}/lib/security/pam_gdm.so
	auth optional ${pkgs~~.gnome~~.gnome-keyring}/lib/security/pam_gnome_keyring.so		auth optional ${pkgs.gnome-keyring}/lib/security/pam_gnome_keyring.so

	account include login		account include login
Line 59:		Line 59:

	session include login		session include login
	session optional ${pkgs~~.gnome~~.gnome-keyring}/lib/security/pam_gnome_keyring.so auto_start		session optional ${pkgs.gnome-keyring}/lib/security/pam_gnome_keyring.so auto_start
	'';		'';
	};		};

Imsick: added instruction for focaltech driver

2025-01-21T18:47:15Z

added instruction for focaltech driver

← Older revision		Revision as of 18:47, 21 January 2025
Line 19:		Line 19:
	# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix-550a; # Goodix 550a driver (from Lenovo)		# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix-550a; # Goodix 550a driver (from Lenovo)

			# however for focaltech 2808:a658, use fprintd with overidden package (without tod)
			# services.fprintd.package = pkgs.fprintd.override {
			# libfprint = pkgs.libfprint-focaltech-2808-a658;
			# };
	</syntaxhighlight>		</syntaxhighlight>

TNTima: added semicolons

2025-01-19T15:19:24Z

added semicolons

← Older revision		Revision as of 15:19, 19 January 2025
Line 15:		Line 15:
	# ...and use one of the next four drivers		# ...and use one of the next four drivers
	services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix; # Goodix driver module		services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix; # Goodix driver module
	# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-elan # Elan(04f3:0c4b) driver		# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-elan; # Elan(04f3:0c4b) driver
	# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-vfs0090; # driver for 2016 ThinkPads		# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-vfs0090; # driver for 2016 ThinkPads
	# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix-550a # Goodix 550a driver (from Lenovo)		# services.fprintd.tod.driver = pkgs.libfprint-2-tod1-goodix-550a; # Goodix 550a driver (from Lenovo)

	</syntaxhighlight>		</syntaxhighlight>

Granddave: Add gnome pre-text

2024-12-16T19:08:34Z

Add gnome pre-text

← Older revision		Revision as of 19:08, 16 December 2024
Line 28:		Line 28:

	=== Gnome ===		=== Gnome ===
			In [[GNOME\|Gnome]], the the fingerprints can be configured through the Settings application.
	# Open Gnome Settings		# Open Gnome Settings
	# Scroll down to ''System''		# Scroll down to ''System''