Another random crap I created because random windows kept popping up while I was cleaning my keyboard. Honestly, I’d rather spend an hour building this tool than deal with that again.
KeyBlocker is a macOS utility that allows you to temporarily disable your keyboard input. This is useful for cleaning your keyboard, preventing accidental keystrokes from pets or children, or simply ensuring no input is registered during certain tasks.
- Keyboard Blocking: Intercepts and blocks all keyboard events.
- Update Checking: Checks for updates and notifies the user if a new version is available.
- Settings: Configurable settings for keyboard blocking.
- Custom Panic Shortcut: Set a custom panic shortcut to quickly toggle keyboard blocking.
- System Tray Integration: Easily toggle blocking from the macOS menu bar.
- Logging: Configurable logging levels (Info, Error, Debug) for troubleshooting.
- Ease of Use: Simple command-line interface and minimalist UI.
- macOS: This application is specifically designed for macOS using the Core Graphics and Cocoa frameworks.
- Accessibility Permissions: The app requires Accessibility permissions to intercept keyboard events. When you first run the app, you will be prompted to allow it in System Settings > Privacy & Security > Accessibility.
You can build the project using the provided Makefile.
# Build the binary
make
# Create the application bundle (KeyBlocker.app)
make bundle
# Create a distribution DMG
make dmgYou can run the application directly from the binary or open the created bundle.
# Run the binary
./key_blocker
# With custom log level
./key_blocker --log-level debug- Download the latest
KeyBlocker.dmgfrom the Releases page. - Open the
.dmgfile. - Drag
KeyBlocker.appinto your/Applicationsfolder. - Launch the app and grant the required Accessibility Permissions when prompted.
- Relaunch the app (if permissions were granted)
Once running, you will see a tray icon in your menu bar.
- Click the icon to display KeyBlocker's window.
- Click the switch to toggle keyboard blocking on or off.
- Click "Enable Shortcut" to enable the custom panic shortcuts.
- Click "Unlock Shortcut" to write your own custom panic shortcut command (Needs Enable Shortcut to be enabled).
-v,--verbose: Enable debug logging.--log-level <level>: Set the log level. Available levels:debug,info,error.
This project is licensed under the Affero General Public License v3.0 - see the LICENSE file for details (if applicable).
Miguel Álvarez