Skip to content

Install

Choose the recommended base download for your platform. It installs optional tools when you first need them. The download panel also lists the other packages:

Recommended for v0.6.0-beta.2
Windows
Download Base installer
14.3 MB · qrate-0.6.0-beta.2-base-setup.exe
macOS
Download Base disk image
52.8 MB · qrate-0.6.0-beta.2-base-universal.dmg
Linux
Download Base archive
33.8 MB · qrate-0.6.0-beta.2-base-x86_64-linux.tar.gz

Start with a base download. qrate offers to add PDF previews and the assistant when you need them.

Full, portable, and managed downloads
Windows · Full installerqrate-0.6.0-beta.2-setup.exe81.9 MB
Windows · Portable ZIPqrate-0.6.0-beta.2-x86_64.zip117.2 MB
Windows · Managed MSIqrate-0.6.0-beta.2-x86_64.msi96.6 MB
macOS · Full disk imageqrate-0.6.0-beta.2-universal.dmg124.2 MB
Linux · Full archiveqrate-0.6.0-beta.2-x86_64-linux.tar.gz78.2 MB
Check a download against SHA256SUMS.txt.
  • Full: a larger download with optional tools for computers that stay offline. On macOS, install ffmpeg separately for video previews.
  • Portable ZIP (Windows): unpack and run qrate without an installer.
  • Managed MSI (Windows): for IT deployment with Group Policy, SCCM, or Intune.

An installed qrate updates to the same type of download it came from. You can also add optional tools later under Settings ▸ Components.

The qrate tap installs the base app:

Terminal window
brew install --cask devnull03/tap/qrate

The tap can lag a prerelease. Use the GitHub download above for the newest beta; stable releases update the tap automatically once that channel is enabled.

qrate offers to install optional components when you need them. For video previews, install ffmpeg separately with brew install ffmpeg.

The WinGet package will use the per-machine MSI. Its first community manifest still needs to be submitted and accepted. Once it is listed, install it with:

Terminal window
winget install --id devnull03.qrate --exact

The Microsoft Store package is in preparation. Its first listing must be submitted and certified before it can be installed from the Store. Use a GitHub Releases download until then.

Install Rust with rustup. Add the rustfmt and clippy components. Then clone the repository and run it. The first build downloads the dependencies. Later builds use the Cargo cache.

Terminal window
git clone https://github.com/devnull03/qrate
cd qrate
cargo run

Common image formats work without extra tools. PDF previews use PDFium. Video frame previews use ffmpeg. qrate links neither one. It loads PDFium dynamically and runs ffmpeg as a subprocess. A checkout without them still builds and launches, but PDFs and videos show only a type icon. qrate looks beside its own executable first, then for a copy it installed itself (Settings ▸ Components), then on your PATH.

This script downloads PDFium for your platform, and ffmpeg on Windows. On macOS and Linux, install ffmpeg with your package manager.

Terminal window
./scripts/fetch-binaries.sh