philipgb/bazzite-deck-gnome-desktop-lock

This is a small installer for Linux systems running the GNOME desktop, specifically Fedora and Bazzite. It addresses a narrow problem: the built-in lock screen may not work well on certain devices, particularly handheld gaming computers. When you press Super+L (the standard lock shortcut on most Linux desktops), this tool switches to a text-based console, locks all virtual terminals, puts the machine to sleep, and resumes to a password prompt when you wake it up. Your graphical session and all its open applications stay running the entire time. The project is intentionally specific. It requires Fedora's kbd package and rejects substitutes. It has been tested on a Bazzite Deck GNOME setup, Fedora 43, and a OneXPlayer handheld. It needs a physical keyboard because the text-based lock prompt cannot use touchscreen or controller-based on-screen keyboards. The installer must be run from a terminal inside the active GNOME session as your normal user, not with administrator privileges directly. Installation involves cloning the repository and running a shell script. The script creates a system service, a narrow privilege rule that allows only two specific commands without a password, and a GNOME keyboard shortcut. It backs up your existing lock binding before disabling it. If you have an older similar setup installed, the script can migrate and clean up those files. Uninstallation reverses all of these changes and restores your previous lock shortcut. The tool is careful about security. It checks that the user requesting the lock matches the active graphical session, prevents multiple lock operations from running at once, and verifies that the machine genuinely went to sleep by comparing system clocks before and after. It deliberately does not change hardware wakeup settings, so if a USB device or monitor wakes the machine immediately, that is a separate hardware issue the installer will not fix. The full README is longer than what was shown.