Make a Ring of your own

At home on
your desktop.

Choose a download for your computer. Every file below comes directly from the project’s GitHub release.

v0.1.3 · PrereleaseUnsigned buildsRelease notes ↗

Looking for a newer version or another architecture? Browse all GitHub releases ↗. The files above are pinned to v0.1.3.

From download to desktop

A few installation notes.

Verify your download, then choose the instructions for your platform.

Linux: AppImage or DEB

For the AppImage, make the downloaded file executable in your file manager’s properties, then launch it. In a terminal:

chmod +x linux-QiRing_0.1.3_amd64.AppImage
./linux-QiRing_0.1.3_amd64.AppImage

For Debian or Ubuntu, open the DEB with your package installer, or use:

sudo apt install ./linux-QiRing_0.1.3_amd64.deb

The standard AppImage and DEB use normal per-user storage. Use the separate portable archive for a portable Ring. Linux distribution compatibility can vary; report your distribution and error if a build won’t launch.

Windows: MSI installer

Download the x64 MSI, verify it against the published checksums, and open it to run the installer. Launch QiRing from the installed shortcut.

Because this release is unsigned, Windows may show an unknown-publisher or SmartScreen warning. Only proceed if you trust the source and have verified the download; on managed computers, follow your organization’s policy.

For a copy that keeps its Ring beside the app, choose the portable ZIP instead of the MSI.

macOS: Apple Silicon DMG

This download is for Apple Silicon Macs (M-series), not Intel Macs. Open the DMG, copy QiRing to Applications, and eject the disk image.

The app is not Developer ID signed or notarized. macOS may block the first launch. If you trust and have verified the download, consult Apple’s instructions for opening apps from outside the App Store. Do not disable Gatekeeper globally.

macOS builds use normal per-user storage; portable mode is not supported.

Portable builds: keep the folder together

Extract the Linux TAR.GZ or Windows ZIP into a folder you own and can write to. Keep the qiring-portable marker beside the AppImage or Windows executable.

QiRing creates a QiRingData directory beside the launcher. Move that directory, the launcher, and the marker together. Keep independent backups before moving between computers.

Read the complete portable-storage guide →
Checksums, SBOMs, and provenance

Each platform has a SHA-256 checksum file and an SPDX software bill of materials (SBOM, an inventory of dependencies). To check a whole platform manifest, download all its files—including the SBOM—into one folder.

On Linux:

sha256sum --check linux-SHA256SUMS

On macOS:

shasum -a 256 -c macos-SHA256SUMS

On Windows, compare the result of this command to the matching entry in windows-SHA256SUMS:

Get-FileHash -Algorithm SHA256 .\windows-QiRing_0.1.3_x64_en-US.msi

Checksums detect file differences; they do not replace a trusted download source or a platform signature. With the GitHub CLI, you can also check build provenance:

gh attestation verify <downloaded-file> --repo gcoxdev/qiring

Installed? Start here.

Your first Ring awaits.

Learn the vocabulary, create a Ring, and save your recovery key before adding your essentials.

Open the getting-started guide ↗