macOS Utility Tool (KeyRemapper)

This project contains the source code for a macOS Utility Tool. Follow these simple steps to build it into a functional macOS app (.app).

Prerequisites

• Xcode: Make sure you have Xcode installed from the Mac App Store.

How to Build the App

1. Open the Project Double-click the KeyRemapper.xcodeproj file in this folder to open the project in Xcode. (Alternatively, you can open your terminal, navigate to this folder, and run the command: open KeyRemapper.xcodeproj)

2. Select the Destination At the top of the Xcode window, look for the destination selector (next to the play/stop buttons). Make sure "My Mac" is selected.

3. Build and Run Click the Play button (▶) in the top-left corner of Xcode, or press Cmd + R on your keyboard. Xcode will compile the code and launch the app.

4. Export the App (Optional) If you want a standalone .app file to move to your Applications folder or share:

   • In Xcode's menu bar, go to Product > Build (Cmd + B).
   • Under the "Products" folder in the left sidebar of Xcode, right-click KeyRemapper.app and select Show in Finder.
   • You can now copy this .app file to your Applications folder!

Troubleshooting

If the KeyRemapper.xcodeproj file is missing or not opening correctly, you can easily regenerate it. Open your terminal, navigate to this folder, and run:

sh generate_project.sh

This script will instantly recreate the Xcode project file for you.