bonk: a fox guards your Mac's keyboard
Keeps your desktop visible and your Mac awake while a tiny fox blocks keyboard, mouse and trackpad input. Jev drives the character's reactions.
Bonk</h1> <p align="center"><strong>A playful macOS input guard with an on-device fox personality.</strong></p> Keep your desktop visible and your Mac awake while a tiny fox blocks unwanted keyboard, mouse, and trackpad input. Reactions run locally; Jev adds optional creative direction. Pick a bonk mode — classic fox, a powered-off-looking black screen, or an away-screen that lists the agents still running — and optionally photograph anyone who fails to unlock. > [!IMPORTANT] > Bonk is not a replacement for the macOS Lock Screen. Anything already visible remains visible. ## Build and install Requires macOS 13+ and Swift 5.10+. The standalone Command Line Tools support building and packaging; full Xcode 15.4+ is needed for the XCTest suite. ```sh git clone https://github.com/Captain-Sangam/bonk.git cd bonk make export ``` Launch **Bonk** from Spotlight or Applications and grant Accessibility permission in **System Settings → Privacy & Security → Accessibility**. Activate it from the menu-bar paw or your shortcut (default `⇧⌘B`), changeable in **Settings**; press `Esc` twice to start macOS owner authentication and unlock. Choose the bonk mode and turn on the optional intrusion camera in **Settings**; the camera asks for its own permission the first time you enable it. `make export` validates, packages, and installs the app into `/Applications` or `~/Applications`. Use `make run` to build and launch from `dist/`, or `make app` to package only. See [Getting started](docs/getting-started.md) for permissions, unlock timing, and optional Jev setup. ## Documentation and contributions - [Documentation index](docs/README.md) - [Features and character behavior](docs/features.md) - [Architecture](docs/architecture.md) - [Packaging and installation](docs/packaging.md)