quickbox-qt --- GUI for quickemu

A Qt6/PySide6 GUI front-end for quickemu.

Ported from the original quickbox GTK version.

Main window	VM settings	Download distros
Locations & profiles	Migrate VMs	About

Features

• Browse, launch, and manage quickemu VMs from a clean Qt6 interface
• Download distros via quickget with live progress
• Snapshot management (create, apply, delete)
• Clone and migrate VMs
• Custom VM creation from local ISO/IMG files
• Per-VM display backend selector (SDL / GTK / SPICE via virt-viewer)
• System tray support
• Translations for 17 languages

Requirements

• Python 3.10+
• PySide6
• quickemu / quickget
• python-gobject (gi — GLib version guard)

Installation

Arch Linux

yay -S quickbox-qt

Debian

Quickbox-qt debian

Manual

# Install dependencies
pip install PySide6
or
yay -S pyside6

# Run directly
./quickbox

Usage

quickbox

VMs are read from ~/emu by default. The location can be changed or extended via the Advanced panel inside the app.

Translations

JSON files live in translations/. Add a new file named <lang_code>.json matching the keys in any existing translation to add a new language.

Credits

Quickbox-qt is just a GUI — all the actual VM work (downloading, booting, disk handling) is done by quickemu. Quickbox-qt wouldn't exist without it.

License

MIT — see LICENSE.

---

Parts of this tool were built with AI assistance (Claude by Anthropic). All code has been reviewed and tested by the author.