Skip to content

musqz/quickbox

Repository files navigation

Quickbox — GUI for quickemu

Quickbox icon

Version License Python GTK4 Linux

Beta — actively developed and tested. Not yet published to AUR or any distro repository. Feedback welcome.

A GTK4 GUI for managing QEMU virtual machines via quickemu.

quickbox

quickbox

quickbox

Features

  • 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

quickbox

Requirements

  • Python 3.8+
  • GTK4 (python3-gi, gir1.2-gtk-4.0, gobject-introspection)
  • quickemu (includes quickget)

Installation

From source (all distros)

sudo ./install.sh

Or manually:

sudo cp quickbox /usr/local/bin/
sudo chmod +x /usr/local/bin/quickbox
sudo cp quickbox.desktop /usr/share/applications/

Arch Linux — local PKGBUILD (beta testing)

git clone https://github.com/musqz/quickbox.git
cd quickbox/packaging
makepkg -si

AUR package is planned but not yet published.

Uninstallation

sudo ./uninstall.sh

Usage

quickbox

Configuration

Stored in ~/.config/quickbox/quickbox.conf

Default VM directory: ~/emu/

GTK4 theme

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

License

MIT — Copyright (c) 2026 Musqz


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

About

Gui for managing quickemu vm's. Migration function. Snapshot function. Switch working dir. And more.

Resources

License

Stars

Watchers

Forks

Contributors