QSS-M · macOS Setup

How to Allow QSS-M to Run on macOS

If you installed QSS-M outside the App Store, macOS needs a couple of one-time permissions before it will launch and capture raw mouse input.

Step 1 — Authorize the App to Launch

Official releases (1.7.0 and later) are signed and notarized by Apple and open normally — skip to Step 2. The commands below are only needed for development builds, which are not notarized.

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
    Keystroke Receiving dialog asking to allow QSS-M to receive keystrokes
    Click Open System Settings on the "Keystroke Receiving" prompt.
  2. Navigate to Input Monitoring
    System Settings showing Privacy & Security with Input Monitoring available
    Open Privacy & Security, then select Input Monitoring.
  3. Enable QSS-M and relaunch
    Dialog offering Later or Quit & Reopen for Input Monitoring access
    Select Quit & Reopen to relaunch QSS-M with the new permission.

Quake Data Location

QSS-M keeps imported PAK files, configuration, saves, history, and bookmarks in the self-contained id1 folder beside QSS-M.app. The launcher and Dock menu's Open Quake Folder action open the folder containing QSS-M.app.