install-from-github.md

Install Guide

Download a Ready-Made Build

1. Go to the Releases page.
2. Download either:
   • the .dmg — drag-to-Applications installer window
   • the .zip — plain archive, move KeepClean.app to Applications yourself
3. If macOS warns about an unsigned app, right-click KeepClean.app → Open → click Open in the dialog.

First Launch

When you open KeepClean for the first time, a one-time setup screen appears:

1. Grant Accessibility — click the button, toggle KeepClean ON in System Settings.
2. Grant Input Monitoring — click the button, add KeepClean and toggle it ON.
3. Both permissions turn green once detected. Click Continue to KeepClean.

Tip: If Input Monitoring doesn't turn green even after you granted it, click "I've Already Granted It" — this can happen with unsigned builds and is harmless.

Your First Clean

1. Go to the Clean tab.
2. Click Disable Keyboard.
3. Clean your keyboard while the trackpad stays active.
4. Click Re-enable Keyboard when you're done.

That's it. For a more thorough test, run the Post-Install Checklist.

Build From Source

If you prefer building from source:

git clone https://github.com/adhamhaithameid/keep-clean.git
cd keep-clean
xcodegen generate
xcodebuild -project KeepClean.xcodeproj -scheme KeepClean -configuration Release build

Requirements: macOS 13.0+ · Xcode 15+ · XcodeGen

If Something Goes Wrong

• Permissions — if macOS blocks the cleaning actions.
• Troubleshooting — if the app opens but doesn't behave as expected.