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/.

Verifying the Installation

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

If you encounter issues, see Troubleshooting.