## Step 1 — Authorize the App to Launch

Open Terminal (Applications › Utilities), then run these commands. Tip: drag QSS-M.app onto the Terminal window to auto-fill its path.

1. Change to the app's directory
   `cd path/to/QSS-M.app`

   Type the path, or drag the app into Terminal to insert it automatically.

2. Make the app executable
   `sudo chmod +x QSS-M.app`

   Grants the app permission to run on this system.

3. Remove the quarantine flag
   `sudo xattr -r -d com.apple.quarantine QSS-M.app`

   Clears the "downloaded from the internet" restriction that blocks launch.

## Step 2 — Enable Input Monitoring (if prompted)

If macOS prompts to allow keystroke/input access for QSS-M, this is needed so the app can read raw mouse input for high-precision movement. If you open the optional launcher with the Option key, you can also click Allow RAW Mouse Input to jump straight to the correct System Settings page. The screenshots below are loaded from the GitHub repo and are not bundled with the app.

1. Open System Settings from the Keystroke Receiving dialog
   Click Open System Settings on the "Keystroke Receiving" prompt.
2. Navigate to Input Monitoring
   Open Privacy & Security, then select Input Monitoring.
3. Enable QSS-M and relaunch
   Select Quit & Reopen to relaunch QSS-M with the new permission.