Skip to content

Installation

Quadstronaut edited this page Jun 7, 2026 · 1 revision

Installation

Windows (v0.1.1 — current release)

No installer. No .NET runtime required. QuadClicker ships as a self-contained single-file EXE.

  1. Go to github.com/Quadstronaut/QuadClicker/releases/latest
  2. Download QuadClicker.exe
  3. Run it — no setup step

Minimum OS: Windows 10 22H2 or Windows 11

SmartScreen warning

The binary is currently unsigned. Windows SmartScreen will show a "Windows protected your PC" warning on first launch. This is expected until an Authenticode certificate is in place (see CODE_SIGNING.md).

To run anyway: click More infoRun anyway.

Package managers (in flight — not yet published)

These manifests exist in the repo and are being submitted to the respective registries. None are live yet.

Channel Install command (once published)
Chocolatey choco install quadclicker
Scoop scoop install quadclicker
winget winget install Quadstronaut.QuadClicker

macOS (unreleased)

Status: code-complete, unverified. The Swift source is written but has never been compiled or run — an Xcode-equipped Mac is required to build it. No signed or notarized artifact is available.

When a macOS release ships, it will require:

  • macOS 13 Ventura or later
  • Accessibility permission granted in System Settings → Privacy & Security → Accessibility (required for CGEventPost input injection and global hotkeys)

Planned distribution: direct DMG download and Homebrew cask.


Linux (build-verified, no package yet)

Status: build verified, no package published. The Qt6/C++ app compiles and runs on Ubuntu 24.04 (Qt 6.4.2, GCC 13.3) and all unit tests pass. No AppImage, .deb, Snap, or Flatpak is published yet.

To build from source: see Building-from-Source.

Minimum OS: Ubuntu 22.04 / Fedora 38

X11 vs Wayland

Click injection works on both X11 (XTest extension) and Wayland (uinput kernel interface) — the app detects the compositor at runtime. Global hotkeys are X11-only. See Hotkeys-and-Platform-Notes.

Clone this wiki locally