GitHub - mroboff/vm-curator: vm-curator is a fast and friendly TUI to build and manage QEMU/KVM virtual machines in Linux. It does not rely on libvirt, which means 3D acceleration (para-virtualized, not pass-through) works for NVIDIA GPUs.
Navigation Menu
Search code, repositories, users, issues, pull requests...
Provide feedback
We read every piece of feedback, and take your input very seriously.
Saved searches
Use saved searches to filter your results more quickly
To see all available qualifiers, see our documentation.
Uh oh!
There was an error while loading. Please reload this page.
vm-curator is a fast and friendly TUI to build and manage QEMU/KVM virtual machines in Linux. It does not rely on libvirt, which means 3D acceleration (para-virtualized, not pass-through) works for NVIDIA GPUs.
License
mroboff/vm-curator
Folders and files
Latest commit
History
Repository files navigation
vm-curator
A fast and friendly Rust TUI for managing QEMU/KVM virtual machines. Discover, create, organize, launch, and manage VMs with an intuitive interface.
Important Launch Note
Para-virtualized 3D acceleration works with NVIDIA GPUs in VMs created by vm-curator! Huzzah!
This was extensively tested by the developer on an RTX-4090 in Arch Linux using NVIDIA driver 590.48.01. The guest OS still has to support QEMU 3D-accelleration. (virtio-vga-gl with gl=on.) Note this is not the same as full GPU Passthrough (the kind requiring multiple GPUs and/or jumping through many, many hoops.) Support for full GPU passthrough is being worked on.
Features
VM Discovery & Organization
VM Creation Wizard
Snapshot Management
Launch Script Editor
USB Passthrough
Additional Features
Screenshots
Installation
Prerequisites
The binary will be at target/release/vm-curator.
Usage
Key Bindings
Configuration
Settings are stored in ~/.config/vm-curator/config.toml and can be edited via the Settings screen (s key).
VM Library Structure
VMs are expected in your library directory (default ~/vm-space/) with this structure:
The launch.sh script should invoke QEMU. VM Curator parses this script to extract configuration and can generate new scripts via the creation wizard.
OS Profiles
The creation wizard includes pre-configured profiles for 50+ operating systems:
Microsoft: DOS, Windows 3.x, 95, 98, ME, 2000, XP, Vista, 7, 8, 10, 11, Server editions
Apple: Classic Mac OS (System 6-9), Mac OS X (10.4-10.15), macOS (11+)
Linux: Arch, Debian, Ubuntu, Fedora, openSUSE, Mint, CentOS, RHEL, Gentoo, Slackware, Alpine, NixOS, Void, EndeavourOS, Manjaro, and more
BSD: FreeBSD, OpenBSD, NetBSD, DragonFly BSD
Unix: Solaris, OpenIndiana, illumos
Other: Haiku, ReactOS, FreeDOS, Plan 9, Minix, TempleOS
Each profile includes optimal QEMU settings for that OS (emulator, machine type, VGA, audio, network, etc.).
Metadata Customization
OS Information: Override or add OS metadata in ~/.config/vm-curator/metadata/:
ASCII Art: Add custom ASCII art in ~/.config/vm-curator/ascii/.
QEMU Profiles: Override profiles in ~/.config/vm-curator/qemu_profiles.toml.
Dependencies
Cross-Distribution Compatibility
VM Curator automatically detects OVMF/UEFI firmware paths across Linux distributions:
🤝 Contributing
Contributions are welcome! If you find a bug or have an idea for an improvement, feel free to open an issue or submit a Pull Request.
Help Wanted: ASCII Art
As a TUI application, vm-curator relies on visual flair to stand out. I am specifically looking for help with:
If you have a knack for terminal aesthetics, your PRs are highly appreciated!
☕ Support & Maintenance Status
vm-curator was built to solve a specific, painful problem: getting high-performance, 3D-accelerated Linux VMs (via QEMU) without the overhead and complexity of libvirt or virt-manager.
This is a personal passion project that I am sharing with the community. While I use this tool daily and will fix critical bugs as I encounter them, please note:
If this tool saved you time or helped you get 3D Acceleration working without having to resort to passthrough:
If you'd like to say thanks, you can support the project below. Donations are a "thank you" for existing work, not a payment for future support.
License
MIT
About
vm-curator is a fast and friendly TUI to build and manage QEMU/KVM virtual machines in Linux. It does not rely on libvirt, which means 3D acceleration (para-virtualized, not pass-through) works for NVIDIA GPUs.
Topics
Resources
License
Uh oh!
There was an error while loading. Please reload this page.
Stars
Watchers
Forks
Releases
Sponsor this project
Uh oh!
There was an error while loading. Please reload this page.
Packages
0
Contributors
3
Uh oh!
There was an error while loading. Please reload this page.
Languages
Footer
Footer navigation