Lockey

Lockey is a lightweight macOS menu bar utility that temporarily suppresses keyboard input so you can clean your keyboard without triggering accidental key presses.

Download

• Latest DMG: Lockey.dmg
• Releases page: GitHub Releases
• Website repo: Lockey-website

Why Lockey

When cleaning a keyboard, accidental key presses can trigger shortcuts, type into active apps, and disrupt your session. Lockey provides a quick lock/unlock flow directly from the menu bar.

Features

• Menu bar-only control surface (no extra popup windows)
• One-click keyboard lock and manual unlock
• Suppresses standard keyboard events while active
• Attempts to suppress media/function-row system-defined key events (for example brightness and volume keys)
• Accessibility permission guidance in-app

Limitations

• Touch ID / power lock hardware actions are controlled by macOS security layers and cannot be intercepted by a normal user-space app.
• Some protected system contexts may not allow full event interception.

Requirements

• macOS 14 or later
• Accessibility permission enabled for Lockey in:
  • System Settings > Privacy & Security > Accessibility

Build and Run

./script/build_and_run.sh

Useful modes:

./script/build_and_run.sh --verify
./script/build_and_run.sh --logs
./script/build_and_run.sh --debug
./script/build_and_run.sh --bundle
./script/build_and_run.sh --dmg

Build a DMG for distribution

./script/build_and_run.sh --dmg

This creates dist/Lockey-1.0.0.dmg by default. You can override the release version:

LOCKEY_VERSION=1.0.0 ./script/build_and_run.sh --dmg

The build also writes dist/Lockey.dmg as the stable release artifact name for GitHub Releases and website download links.

If you have Apple Developer signing configured locally, you can optionally sign the app bundle and DMG:

LOCKEY_VERSION=1.0.0 \
LOCKEY_CODESIGN_IDENTITY="Developer ID Application: Your Name (TEAMID)" \
./script/build_and_run.sh --dmg

If you also have a notarytool keychain profile configured, the same command can notarize and staple the DMG:

LOCKEY_VERSION=1.0.0 \
LOCKEY_CODESIGN_IDENTITY="Developer ID Application: Your Name (TEAMID)" \
LOCKEY_NOTARY_PROFILE="AC_NOTARY_PROFILE" \
./script/build_and_run.sh --dmg

Without Developer ID signing and notarization, macOS will treat the download as an unsigned app and users may need to use Right Click > Open on first launch.

Testing

DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer swift test

Project Layout

• Sources/Lockey/: menu bar app shell and UI
• Sources/LockeyKit/: core state machine, permission handling, and interception services
• Tests/LockeyKitTests/: unit tests for controller and keyboard interception behavior
• script/build_and_run.sh: local build, bundle, and launch entrypoint

The marketing website has been split into a separate repository: https://github.com/rumi7911/Lockey-website

Status

Lockey is currently focused on a compact v1 experience for personal/direct use.

License

This project is licensed under the MIT License - see the LICENSE file for details.