A GTK4 GUI for managing QEMU virtual machines via quickemu.
Also available as a Qt6/PySide6 port: quickbox-qt.
|
Main window |
Advanced settings |
Download distros |
|
Migrate VMs |
|
- VM list — browse all VMs with running status, disk size, filter by name
- Launch / Stop — start and stop VMs with one click
- Snapshots — create, apply, and delete QCOW2 snapshots
- Clone VM — full copy of any VM with a new name
- Download distros — search and download ISOs via
quickget, with live progress - Custom VM — create a VM from a local ISO or IMG file with live import progress
- Migrate VMs — move or copy VMs to a different directory
- Multiple locations — save and switch between VM directories
- Profiles — Standard, Lightweight, Performance, Live ISO, Server/Headless
- Settings — per-VM boot mode, compatibility mode, quiet launch
- Danger zone — Delete disk, Format disk, Delete VM (all behind confirmation dialogs)
- System tray — optional tray icon, hide to tray on close
- Collapsible sections — Info, Settings, Snapshots, Actions hide/show per preference
- Read-only mode during import — browse freely while an import runs, settings locked until done
- Python 3.8+
- GTK4 (
python3-gi,gir1.2-gtk-4.0,gobject-introspection) - quickemu (includes
quickget)
sudo ./install.shOr manually:
sudo cp quickbox /usr/local/bin/
sudo chmod +x /usr/local/bin/quickbox
sudo cp quickbox.desktop /usr/share/applications/yay -S quickboxsudo ./uninstall.shquickboxStored in ~/.config/quickbox/quickbox.conf
Default VM directory: ~/emu/
To apply a theme, symlink its gtk-4.0/gtk.css into your config:
ln -sf /usr/share/themes/YourTheme/gtk-4.0/gtk.css ~/.config/gtk-4.0/gtk.cssQuickbox is just a GUI — all the actual VM work (downloading, booting, disk handling) is done by quickemu. Quickbox wouldn't exist without it.
MIT — 2026 Musqz
Parts of this tool were built with AI assistance (Claude by Anthropic). All code has been reviewed and tested by the author.