carapace-sh/carapace-bin / skills/qemu
qemu
UnverifiedUse when working with QEMU — qemu-system-*, qemu-img, qemu-nbd, qemu-storage-daemon, qemu-pr-helper, block drivers, machine types, CPU models, device emulation, networking, display options, QMP protocol, and guest agent. Triggers on: "qemu", "qemu-system", "qemu-img", "qemu-nbd", "qemu-kvm", "QEMU", "qcow2", "qcow", "qed", "virtio", "virgl", "vhost-user", "VirtIO", "block driver", "machine type", "SEV", "SEV-SNP", "TDX", "snapshot", "backing file", "NBD", "Network Block Device", "QMP", "QEMU Monitor Protocol", "guest agent", "qemu-ga", "cpu model", "host passthrough", "SPICE", "VNC".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.5 KB |
| references/block-devices.md | markdown | 4.1 KB |
| references/block-drivers.md | markdown | 4.6 KB |
| references/cpu-models.md | markdown | 4.8 KB |
| references/devices.md | markdown | 5.1 KB |
| references/display.md | markdown | 4.2 KB |
| references/guest-agent.md | markdown | 4.0 KB |
| references/machine.md | markdown | 3.2 KB |
| references/man-docs.md | markdown | 2.9 KB |
| references/networking.md | markdown | 5.2 KB |
| references/overview.md | markdown | 3.8 KB |
| references/qemu-img.md | markdown | 6.5 KB |
| references/qemu-nbd.md | markdown | 3.3 KB |
| references/qemu-pr-helper.md | markdown | 2.0 KB |
| references/qemu-storage-daemon.md | markdown | 3.7 KB |
| references/qemu-system.md | markdown | 5.2 KB |
| references/qmp.md | markdown | 5.8 KB |
references/display.md
View on GitHub# Display and Graphics
Configure how the VM's graphical output is presented, both locally and remotely.
## Display Backends
| Display | Option | Description |
|---------|--------|-------------|
| GTK | `-display gtk` | Native GTK3 window with zoom, grab, and Ctrl+Alt+ shortcuts |
| SDL | `-display sdl` | SDL2 window |
| curses | `-display curses` | Text-mode terminal output (no VGA) |
| VNC | `-vnc HOST:PORT` | Remote framebuffer protocol (via `-vnc`, not `-display`) |
| spice-app | `-display spice-app` | SPICE remote desktop protocol (standalone GTK window) |
| egl-headless | `-display egl-headless` | Offscreen EGL rendering, remote-only |
| dbus | `-display dbus` | Wayland/D-Bus display sharing |
| cocoa | `-display cocoa` | Native macOS window (Cocoa API, macOS only) |
| none | `-display none` | No display (use QMP/HMP only) |
## VGA Interface
```
-vga MODEL
-vga std # Standard VGA (bochs-display, default for most machines)
-vga cirrus # Cirrus CLGD 5446 (legacy)
-vga vmware # VMware SVGA II (for VMware drivers)
-vga qxl # SPICE QXL (for SPICE acceleration)
-vga virtio # virtio-gpu (virgl/3D acceleration)
-vga none # No VGA (use -device for custom graphics)
```
## VNC
VNC is provided via `-vnc`, not `-display`:
```
-vnc HOST:PORT[,option=value[,...]]
```
| Option | Description |
|--------|-------------|
| `HOST:PORT` | e.g. `0.0.0.0:0` (display 0 on all interfaces) |
| `unix:PATH` | UNIX socket |
| `password` | Require password (set via QMP `set_password`) |
| `lossy` | Use lossy compression methods |
| `non-adaptive` | Disable adaptive updates |
| `acl` | Enable access control list |
| `reverse=HOST:PORT` | Reverse/VNC server connection |
| `websocket=PORT` | WebSocket port for noVNC |
VNC key mapping: Ctrl+Alt+[1-9] to switch monitors; Ctrl+Alt+Shift to release grab.
### Connecting
```
vncviewer HOST:DISPLAY
```
## SPICE
```
-spice port=PORT,addr=ADDR,password=SECRET,disable-ticketing
```
| Option | Description |
|--------|-------------|
| `port=N` | TCP port |
| `tls-port=N` | TLS-encrypted port |
| `addr=IP` | Bind address |
| `password=VAL` | Plaintext password (mutually exclusive with `disable-ticketing`) |
| `disable-ticketing` | No authentication |
| `image-compression=auto|quic|glz|lz|off` | Image compression |
| `jpeg-wan-compression=auto|never|always` | JPEG compression over WAN |
| `zlib-glz-wan-compression=auto|never|always` | Zlib compression |
| `streaming-video=off|all|filter` | Video streaming detection |
| `agent-mouse=on|off` | Guest mouse via spice-vdagent |
| `playback-compression=on|off` | Audio playback compression |
| `seamless-migration=on|off` | Seamless migration support |
### Connecting
```
spicy -h HOST -p PORT
remote-viewer spice://HOST:PORT
```
## VirGL / 3D Acceleration
```
-display gtk,gl=on
-vga virtio
```
or
```
-display egl-headless,gl=on
-vga virtio
```
Requires:
- `virglrenderer` library
- Paravirtualized GPU: `-device virtio-vga` or `-device virtio-gpu-pci`
- `-display egl-headless,gl=on` for remote-only
VirGL provides OpenGL acceleration to the guest without emulating a physical GPU.
## Multi-Monitor
```
-device virtio-vga,max_outputs=2
-device virtio-gpu-pci,max_outputs=2
```
Each output appears as a separate monitor in the guest. Switch between heads with `-display gtk` using Ctrl+Alt+[1-9].
## Full Screen and Window Options
| Option | Description |
|--------|-------------|
| `-full-screen` | Start full screen |
| `-g WxH[xDEPTH]` | Guest resolution (e.g. `-g 1024x768x32`) |
| `-no-frame` | No window decorations (SDL) |
| `-alt-grab` | Use Ctrl+Alt+Shift for grab (was Ctrl+Alt) |
| `-ctrl-grab` | Use right Ctrl for grab |
## Audio
Audio is configured via `-audiodev` (not a display option, but related):
```
-audiodev pa,id=audio0 # PulseAudio
-audiodev alsa,id=audio0 # ALSA
-audiodev sdl,id=audio0 # SDL audio
-audiodev spice,id=audio0 # SPICE audio tunnel
-audiodev none,id=audio0 # No host audio
-audiodev oss,id=audio0 # OSS
-audiodev jack,id=audio0 # JACK
-audiodev dbus,id=audio0 # PipeWire/D-Bus
-audiodev pipewire,id=audio0 # PipeWire
```
Then attach to a device:
```
-device intel-hda -device hda-duplex,audiodev=audio0
-device AC97,audiodev=audio0
-device sb16,audiodev=audio0
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |