Runner Installation Guide
Step-by-step instructions for installing Qontinui Runner on your system.
🪟 Windows Installation
Standard Installation
- 1.
Download the .msi installer
Get the latest version from the download page
- 2.
Run the installer
Double-click the
.msifile - 3.
Handle SmartScreen warning
Expected warning: "Windows protected your PC" - this appears because the app is not yet code-signed ($200/year). The software is safe and open source.To proceed:
- Click "More info" on the SmartScreen dialog
- Click "Run anyway"
- 4.
Follow the installation wizard
Accept the license and choose installation location
- 5.
Launch Qontinui Runner
Find it in the Start Menu or on your Desktop (if selected)
System Requirements
- Windows 10 or Windows 11
- 64-bit processor
- 4 GB RAM (8 GB recommended)
- 200 MB free disk space
🍎 macOS Installation
Standard Installation
- 1.
Download the .dmg file
Universal binary works on Intel and Apple Silicon Macs
- 2.
Open the DMG file
Double-click to mount the disk image
- 3.
Drag to Applications
Drag "Qontinui Runner" to the Applications folder
- 4.
First launch (Gatekeeper workaround)
Expected: "Cannot open because developer cannot be verified" - this is because the app is not yet notarized with Apple ($99/year).Method 1 (Recommended):
- Find Qontinui Runner in Applications
- Right-click (or Control-click) on the app
- Select "Open" from the menu
- Click "Open" in the dialog
- Subsequent launches will work normally
Method 2 (Terminal):
xattr -cr /Applications/Qontinui\ Runner.app
System Requirements
- macOS 11 (Big Sur) or later
- Apple Silicon (M1/M2/M3) or Intel processor
- 4 GB RAM (8 GB recommended)
- 200 MB free disk space
🐧 Linux Installation
AppImage Installation
- 1.
Download the AppImage
Universal format that works on most distros
- 2.
Make it executable
chmod +x qontinui-runner-*.AppImage - 3.
Run the AppImage
./qontinui-runner-*.AppImage - 4.
Optional: System Integration
Install AppImageLauncher to integrate with your application menu
System Requirements
- Modern Linux distribution (Ubuntu 20.04+, Fedora 34+, etc.)
- 64-bit processor
- X11 or Wayland display server
- 4 GB RAM (8 GB recommended)
- 200 MB free disk space
Verifying Your Download
For security-conscious users, you can verify the integrity of your download using checksums. All releases include SHA-256 checksums on GitHub.
Windows (PowerShell):
macOS/Linux:
Compare the output with the checksum listed on the download page or GitHub releases.
Troubleshooting
Windows: "This app can't run on your PC"
You need a 64-bit version of Windows. Qontinui Runner doesn't support 32-bit systems.
macOS: "Damaged and can't be opened"
This happens when macOS quarantines downloaded files. Fix with:
Linux: "Permission denied"
Make sure the AppImage is executable: