Mohammad Afnan

Clean My Keyboard

A lightweight GTK4 utility that temporarily disables all keyboard input so you can safely wipe down your keys without triggering random shortcuts.

GTK4CLinuxCMakePolkit
GitHub RepositoryInstallation Guide

Copr build status

AUR Version

Dependencies

  • cmake
  • pkgconf
  • gtk4
  • polkit
  • hicolor-icon-theme

Note for Window Manager Users

Clean My Keyboard requires root privileges to temporarily disable your input devices, which it requests via Polkit.

If you are using a full Desktop Environment (GNOME, KDE, XFCE), this will work out of the box. However, if you are using a standalone Window Manager (i3, Sway, bspwm, Hyprland, etc.), you must ensure you have a Graphical Polkit Authentication Agent installed and running in the background.

Common Polkit Agents:

  • polkit-gnome (Popular for GTK setups)
  • lxqt-policykit (Lightweight Qt)
  • mate-polkit
  • hyprpolkitagent (For Hyprland)

Installation

Arch Linux

yay -S clean-my-keyboard

Fedora

sudo dnf copr enable hyperafnan/clean-my-keyboard
sudo dnf install clean-my-keyboard

Manual Build

cmake -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr
cmake --build build
sudo cmake --install build

License

MIT — see LICENSE.