Skip to content

A cross-platform system tray tool for disabling your keyboard.

License

Notifications You must be signed in to change notification settings

mwojtyna/keyboard-cleaner

Repository files navigation

Keyboard Cleaner

A cross-platform system tray tool for disabling your keyboard.

Warning

MacOS support is experimental as the current implementation is not user friendly.
For some reason the functionality that blocks keyboard input has to be on a different process than the one running the UI, resulting in requiring 2 programs to be open at the same time.

Requirements

Linux

  • A system tray
  • qt >= 6.2 (Ubuntu 22.04 or newer)
  • libevdev >= 1.12 (Ubuntu 22.04 or newer)

MacOS

  • qt package from homebrew

First usage

Linux

  1. Add your user to the input group - sudo adduser $USER input
  2. Restart your system
  3. Run the keyboard-cleaner binary
  4. Click on the icon in the system tray
  5. Select your keyboard from the menu
  6. Press Disable keyboard

Windows

  1. Run keyboard-cleaner.exe
  2. Click on the icon in the system tray
  3. Press Disable keyboard

Note

Ctrl-Alt-Del still works as it is impossible to override it on Windows

MacOS

  1. Run the keyboard-cleaner-service binary (a terminal window will pop up, you can minimize it)
  2. Run the keyboard-cleaner app bundle
  3. Click on the icon in the system tray
  4. Press Disable keyboard