These instructions are for setting up the GNU/Linux Fingerprint reader (TPE-F4500) on Bazzite. For the most part the fingerprint reader works out of the box on Bazzite, but there are a few tweaks required to get the fingerprint reader working at the login screen for the system if you want to be able to utilize the fingerprint reader to login.
These directions have been vetted under the KDE variant of Bazzite 44.20260608: Stable (F44.20260608) and will probably work for future releases as well.
Steps to enable the fingerprint reader at the KDE plasma login:
0. Connect the USB fingerprint reader to a USB port on your computer
1. Open a terminal (click on the KDE menu in lower left corner, search for konsole, and open konsole)
2. Type the following line into the terminal and hit enter:
sudo nano /etc/pam.d/plasmalogin
3. Copy and paste the following lines into the terminal/nano text editor:
#%PAM-1.0
# Increase timeout to 10s and allow 2 tries before falling back to password
# This gives the Digital Persona sensor time to fully initialize the claim
auth sufficient pam_fprintd.so max-tries=2 timeout=3
# Fallback to Password
auth required pam_unix.so try_first_pass likeauth nullok
account include password-auth
password include password-auth
session include password-auth
4. Hold the ctrl key down and while doing so tap the x key
5. You will be prompted with a Save modified buffer? message and here you want to tap the y key for yes
6. When you see Write to File appear hit the enter key to save
7. Run the following command:
sudo systemctl edit fprintd.service
8. Copy and paste the following between the "### Anything between here ..." line and the "### Edits below this comment will be discarded" line:
[Service]
# Keep the service alive for 60 seconds after inactivity instead of default (often 30s)
TimeoutStopSec=60
# Restart automatically if it crashes during a claim attempt
Restart=on-failure
RestartSec=2
9. Hold down the ctrl key and tap the x key (while still holding the ctrl key down)
10. A Save modified buffer? message will appear, tap the y key for yes.
11. When you see Write to File:// .... hit enter to save
12. Copy and paste the following lines into the terminal to restart the service:
sudo systemctl daemon-reexec
sudo systemctl restart fprintd.service
Actually adding your fingerprint(s) to the system:
13. Click on the KDE menu in the lower left corner, type in users, then open Users app when it appears in the search results
14. Click the Configure Fingerprint Authentication... button
15. Click the Add button
16. Using your touchpad/mouse select the fingerr from the picture on the screen you want to add and enter your login password when prompted and click the OK button
17. Place your finger on the fingerprint reader straight on
18. Repeat with the finger a little off to the right side
19. Repeat with the finger a little off to the left side
20. Repeat with the finger a little over the top of the fingerprint sensor
21. Repeat with the finger a little under the top of the fingerprint sensor
22. If you don't see Finger enrolled yet keep pressing your fingerprint against the sensor until you do
23. Go to the KDE menu in the lower left and click Session, then Log Out, and finally confirm by clicking the Log Out Now button
24. To login hit the enter button or > button and then the fingerprint reader should light up at which point you can use your finger to login.
