Installation

Installation

Flathub (Recommended)

The easiest way to install QBZ. All dependencies are bundled.

flatpak install flathub com.blitzfc.qbz

Then launch with:

flatpak run com.blitzfc.qbz

Or find "QBZ" in your application menu.

Snap Store

sudo snap install qbz-player

Known limitation: MPRIS media controls are currently unavailable in the Snap build. The required auto-connect review from Canonical has been pending. If you have a Snapcraft forum account, please support the permission request. All other installation methods have full MPRIS support.

AUR (Arch Linux)

Using your preferred AUR helper:

yay -S qbz-bin

Or manually:

git clone https://aur.archlinux.org/qbz-bin.git
cd qbz-bin
makepkg -si

GitHub Releases

Download the latest release from the Releases page.

Available formats:

Format	File	Instructions
Debian/Ubuntu	qbz_x.x.x_amd64.deb	sudo dpkg -i qbz_*.deb
Fedora/RHEL	qbz-x.x.x.x86_64.rpm	sudo rpm -i qbz-*.rpm
AppImage	qbz_x.x.x_amd64.AppImage	chmod +x qbz_*.AppImage && ./qbz_*.AppImage
Flatpak Bundle	qbz_x.x.x_x86_64.flatpak	flatpak install qbz_*.flatpak
Tarball	qbz_x.x.x_amd64.tar.gz	Extract and run ./qbz

Note: When using .deb, .rpm, or tarball packages, you may need to install system dependencies manually. See System Requirements for the full list.

APT Repository (Debian/Ubuntu)

For automatic updates via apt:

# Add the repository
echo "deb [trusted=yes] https://vicrodh.github.io/qbz-apt stable main" | sudo tee /etc/apt/sources.list.d/qbz.list

# Update and install
sudo apt update
sudo apt install qbz

Building from Source

Prerequisites

• Rust (stable, latest recommended)
• Node.js (18+) and npm
• System dependencies listed in System Requirements
• Tauri CLI: cargo install tauri-cli

Build Steps

# Clone the repository
git clone https://github.com/vicrodh/qbz.git
cd qbz

# Install frontend dependencies
npm install

# Build the app
cargo tauri build

The compiled binary and packages will be in src-tauri/target/release/bundle/.

macOS (Experimental)

QBZ is a Linux-first application. macOS support is experimental and limited. Features like PipeWire, ALSA Direct, casting, and device control are unavailable.

Download the unsigned DMG from Releases (Apple Silicon only).

Since the DMG is unsigned, you need to allow it in System Settings > Privacy & Security after first launch.

macOS port maintained by @afonsojramos.

Verifying the Installation

After installing, launch QBZ and check the version in Settings > About.

If you encounter issues, see Troubleshooting.