Runner Installation Guide

Standard Installation

1. 1.

   Download the .msi installer

   Get the latest version from the download page

2. 2.

   Run the installer

   Double-click the .msi file

3. 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:

   1. Click "More info" on the SmartScreen dialog
   2. Click "Run anyway"
4. 4.

   Follow the installation wizard

   Accept the license and choose installation location

5. 5.

   Launch Qontinui Runner

   Find it in the Start Menu or on your Desktop (if selected)

Standard Installation

1. 1.

   Download the .dmg file

   Universal binary works on Intel and Apple Silicon Macs

2. 2.

   Open the DMG file

   Double-click to mount the disk image

3. 3.

   Drag to Applications

   Drag "Qontinui Runner" to the Applications folder

4. 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):

   1. Find Qontinui Runner in Applications
   2. Right-click (or Control-click) on the app
   3. Select "Open" from the menu
   4. Click "Open" in the dialog
   5. Subsequent launches will work normally

   Method 2 (Terminal):

   xattr -cr /Applications/Qontinui\ Runner.app

AppImage Installation

1. 1.

   Download the AppImage

   Universal format that works on most distros

2. 2.

   Make it executable

   chmod +x qontinui-runner-*.AppImage
3. 3.

   Run the AppImage

   ./qontinui-runner-*.AppImage
4. 4.

   Optional: System Integration

   Install AppImageLauncher to integrate with your application menu

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: