utmapp / utmapp/UTM

Document that SPICE clipboard on Windows ARM requires virtio-ramfb (display backend dependency)

Open
#7,681 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Swift
Stars
35.5k
Forks
1.8k
Avg merge
5d 5h
Merged PRs (30d)
7

Description

## Summary

Clipboard sharing via SPICE on Windows ARM VMs depends on the selected display backend, but this dependency is not documented and is non-obvious.

## Environment

- UTM version: 4.7.5 (118)
- macOS: 26.4.1 (25E253)
- Guest: Windows 11 ARM
- VM type: Virtualize

## Observations

With SPICE guest tools installed (`spice-vdagent` running):

Clipboard behavior varies depending on the display device:

| Display Device | Clipboard |
|----------------------|----------|
| virtio-ramfb | ✅ Works |
| virtio-ramfb-gl | ❌ Does not work |
| virtio-gpu / gpu-gl | ❌ Does not work |

## Key Insight

Clipboard integration requires:
1. SPICE guest agent (installed and running)
2. A SPICE-compatible display backend

Using accelerated/GL display modes appears to bypass or disable the SPICE channel required for clipboard integration, even though the agent is running and UTM UI indicates clipboard sharing is enabled.

## Why this is confusing

- Clipboard sharing can be enabled in UTM settings regardless of display backend
- SPICE services appear healthy inside the guest
- Failure mode is silent (no error, clipboard just doesn't work)

This makes it difficult to diagnose and can lead to incorrect assumptions that SPICE is unsupported on Windows ARM.

## Suggestion

Add documentation (and possibly UI hints) clarifying:

- Clipboard sharing requires both:
- SPICE guest agent
- A SPICE-compatible display backend (e.g. `virtio-ramfb`)
- GPU/GL display modes may disable clipboard integration

Optional: warn in UI when clipboard sharing is enabled with a non-SPICE-compatible display.

## Additional note

This behavior is reproducible and switching to `virtio-ramfb` immediately restores clipboard functionality.

Working settings:

![Image](https://github.com/user-attachments/assets/aabf39a8-3bc5-454e-a21c-791ade28b610)

![Image](https://github.com/user-attachments/assets/5ee6ad87-690a-4fe7-b7f9-0566880a8f7f)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.