A powerful, text-based Terminal User Interface (TUI) application for managing QEMU/KVM virtual machines using the libvirt Python API.
Managing virtual machines in a terminal environment has never been easier or more powerful. VirtUI Manager bridges the gap between the simplicity of command-line tools and the rich functionality of GUI-based solutions, offering the best of both worlds for virtualization administrators.
- Virt-manager requires X11 forwarding, which is slow, resource-intensive, and often impossible in remote environments
- GUI-based solutions are heavy with X dependencies, making them unsuitable for headless servers or low-bandwidth connections
- Command-line tools lack the intuitive interface needed for complex VM management tasks
- Cockpit Machine is feature incomplete, and needs a lot of depencies. It is not multi hypervisor oriented
VirtUI Manager solves these challenges with:
- Lightweight Terminal Interface: No X11 dependencies, works perfectly over SSH
- Remote Management: Efficient low-bandwidth control of remote libvirt servers
- Rich Feature Set: Advanced VM management capabilities in a simple, intuitive interface
- Multi-server Support: Manage VMs across multiple libvirt servers from a single interface
- Performance Optimized: Built-in caching reduces libvirt calls and improves responsiveness
- Libvirt Event handler: Only get update on event from libvirt
- Migration Support: Live and offline VM migration capabilities and custom migration
- Bulk Operations: Execute commands across multiple VMs at once (including configuration)
- Web Console Access: Integrated VNC support with novnc over ssh tunnel for remote server
- Recommended Minimal Terminal Size: 34x92. 34x128 is the recommended Size
- Remote Connection: SSH access to libvirt server (ssh-agent recommended)
- Python 3.7+
- libvirt with Python bindings
- Python Dependencies: textual, pyaml, libvirt-python, markdown-it-py
- Optional: virt-viewer, novnc, websockify for enhanced functionality
As there is no simple way to get sound and network model using libvirt API, the user can provides a list in his own configuration file.
To get a list of model for a machine type you can use the qemu command line:
qemu-system-x86_64 -machine pc-q35-10.1 -audio model=help
qemu-system-x86_64 -machine pc-q35-10.1 -net model=helpPossible User config parameters:
- network_models: List of allowed network models (default:
['virtio', 'e1000', 'e1000e', 'rtl8139', 'ne2k_pci', 'pcnet']) - sound_models: List of allowed sound models (default:
['none', 'ich6', 'ich9', 'ac97', 'sb16', 'usb'])
AI assistance is used to improve coding efficiency by automating boilerplate, suggesting relevant code completions, and quickly detecting bugs.
This project is licensed under the GPLv3 License.