Skip to content

Download ​

Everything here always refers to the newest release. There is no version in any link, so a bookmark never goes stale.

The application ​

Direct download

Binaries are unsigned. On macOS, Homebrew is the recommended path for that reason.

Unpack the archive and put quickrun somewhere on your PATH. Run it with no arguments — or double-click it — and QuickRun puts an icon in the tray and opens its window. No console window appears: the binary is a desktop application that also works as a command line tool when you start it from a terminal.

winget install fgilde.QuickRun works once the package is accepted into the winget repository; the submission is under review. Until then use scoop, which installs from the manifest this site serves.

The Homebrew formula and the scoop manifest are regenerated with every release and served from here, so neither needs a separate tap or bucket repository.

macOS: the cask, not the formula ​

bash
brew install --cask fgilde/tap/quickrun

This is the install a Mac expects. It puts QuickRun.app into /Applications, so it appears in Launchpad and Spotlight with its icon, it can claim the quickrun:// scheme - which lives in an app bundle's Info.plist and cannot be claimed by a bare binary - and it links the binary inside the bundle onto your PATH, so quickrun in a terminal and the app are the same installation.

The formula installs the command line only:

bash
brew install fgilde/tap/quickrun   # no app bundle, no Launchpad entry, no quickrun://

Both are also served from this site, so neither needs the tap:

bash
brew install --cask https://quickrun.org/quickrun-cask.rb
brew install https://quickrun.org/quickrun.rb

Updating is brew update first - that fetches the tap - and then the one that matches what you installed. The cask and the formula are both called quickrun, and a plain brew upgrade quickrun means the formula:

bash
brew update
brew upgrade --cask quickrun   # the app
brew upgrade quickrun          # the command line only

Installed from a URL rather than the tap? Homebrew has no tap to check for a newer version, so install it again - the URL always serves the current one:

bash
brew reinstall --cask https://quickrun.org/quickrun-cask.rb

Either way QuickRun leaves its own binary alone, because Homebrew owns it.

The bundle is also a plain download, if you would rather not use Homebrew:

Downloaded by hand, it carries the quarantine flag and macOS calls it damaged. Clear it once:

bash
xattr -dr com.apple.quarantine /Applications/QuickRun.app

Verifying a download ​

Every release publishes SHA256SUMS covering each binary. The Linux installer checks it automatically; quickrun update checks it before replacing anything.

bash
sha256sum -c --ignore-missing SHA256SUMS

Unsigned binaries ​

QuickRun is not code-signed yet:

  • macOS refuses to run a downloaded unsigned binary. Homebrew strips the quarantine attribute, which is why it is the recommended path; install.sh removes it explicitly. For a manual download, clear it yourself:

    bash
    xattr -d com.apple.quarantine ./quickrun
  • Windows shows a SmartScreen warning on first run, because the binary is not signed yet. scoop and winget installs avoid it.

    One release, v0.8.3, went further: the published zip was refused by browsers as "virus detected", because Defender's machine-learning model called it Trojan:Script/Wacatac.B!ml - !ml being a guess from shape rather than a match against anything known. It was wrong, and it was about that one file: the same source built locally scanned clean, and the same source rebuilt in CI downloaded clean. Every Windows build is now scanned on the build machine before it is published, so a release that would be refused fails there instead of reaching you.

    If a download is ever blocked anyway: check what you got against the release's own SHA256SUMS,

    powershell
    Get-FileHash .\quickrun-win-x64.zip -Algorithm SHA256

    and install through winget or scoop, which do not go through the browser's download path.

  • Linux does not care.

A signature is the permanent answer, and the release workflow signs Windows builds as soon as the signing credentials are configured. Until then the checksums above are what proves a download is the file it claims to be.

The browser extension ​

The extension puts a Run button on GitHub. It is not required — the application works on its own — but it is the reason QuickRun exists.

Edge installs it from the Microsoft Edge Add-ons store, and updates come with the browser's own.

Where a store does not carry it yet, load it unpacked. Unzip the download, then:

  • Chrome, Edge, Opera — chrome://extensions → Developer mode → Load unpacked → the unpacked folder
  • Firefox — about:debugging → This Firefox → Load Temporary Add-on → the manifest.json inside the folder
  • Safari — Settings → Advanced → Show features for web developers, then Develop → Allow unsigned extensions, then Develop → Add Temporary Extension and pick the folder or the zip itself. Safari 16.4 or later. The permission goes away when Safari restarts, so this is for trying it rather than for keeping it - a permanent install needs the extension inside a signed app, which is described here

That is all: there is nothing to pair. QuickRun accepts requests only from a browser extension.

What to do next ​