Skip to content

Commit

Permalink
Update docs for v4.6
Browse files Browse the repository at this point in the history
  • Loading branch information
osy committed Nov 27, 2024
1 parent ffe22cf commit e96fdbc
Show file tree
Hide file tree
Showing 6 changed files with 655 additions and 588 deletions.
4 changes: 2 additions & 2 deletions guest-support/dynamic-resolution.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,12 @@ parent: Guest Support
---
{% include toc.md %}

Dynamic resolution allows the virtual machine to change resolution to match the current window size (including full screen window). It it only supported on QEMU backend virtual machines and requires guest tools to be installed.
Dynamic resolution allows the virtual machine to change resolution to match the current window size (including full screen window). It it supported on QEMU backend virtual machines when guest tools are installed and in Apple backend guests running macOS 14 or newer.

## Enabling Dynamic Resolution

1. In the virtual machine configuration, make sure that ["Auto resolution"]({% link settings-qemu/devices/display.md %}#auto-resolution) is checked.
2. Install the guest tools on [Linux]({% link guest-support/linux.md %}) or [Windows]({% link guest-support/windows.md %}).
2. Install the guest tools on [Linux]({% link guest-support/linux.md %}) or [Windows]({% link guest-support/windows.md %}) if using QEMU backend.
3. Reboot the virtual machine.

**macOS**{: .label .label-green } When you resize the virtual machine window, it should automatically request to the guest agent to change the resolution to match that size.
Expand Down
2 changes: 1 addition & 1 deletion guest-support/guest-support.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Guest Support
nav_order: 7
has_children: true
---
In order to take full advantage of all the features UTM has to offer, you need to install some software in the virtual machine guest. Currently only [Windows]({% link guest-support/windows.md %}) (excluding older versions) and [Linux]({% link guest-support/linux.md %}) have all the drivers and tools to support all of UTM's features. If you run an operating system that is not supported by the guest tools, some of the following features may not work:
In order to take full advantage of all the features UTM has to offer, you need to install some software in the virtual machine guest. Currently only [Windows]({% link guest-support/windows.md %}) (excluding older versions), [Linux]({% link guest-support/linux.md %}), and [macOS]({% link guest-support/macos.md %}) have all the drivers and tools to support all of UTM's features. If you run an operating system that is not supported by the guest tools, some of the following features may not work:

* Directory sharing
* Clipboard sharing
Expand Down
11 changes: 8 additions & 3 deletions guest-support/macos.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,10 +36,15 @@ $ mount_virtiofs share [mount point]
### Network sharing
Another way of sharing files between the host and guest (including support for macOS 12) is to use the network file sharing feature of macOS running on the host. You can do it from "System Preferences" under the "Sharing" category. Check out [Apple's user guide](https://support.apple.com/guide/mac-help/set-up-file-sharing-on-mac-mh17131/mac) for more details. Once a network share is set up, your macOS guest can connect to it just like any other Mac.

## Clipboard Sharing
{: .label .label-green }
**macOS 15+**
When both the guest and host are running macOS 15 or higher, clipboard sharing is supported. First, enable the feature in the VM's settings under Virtualization → Enable Clipboard Sharing. Then, after starting the VM, mount the guest tools by selecting "Install Guest Tools" from the CD button in the toolbar. Open the package installer from the mounted drive and after the installation is complete, macOS will prompt for you to allow "spice-vdagent" and "spice-vdagentd" to be opened. Make sure you agree to open in these prompts.

## Missing features
The Apple Virtualization backend used to virtualize macOS does not support many UTM features. Below is a list of some unsupported features.

* USB sharing
* Clipboard sharing
* Dynamic display resolution
* Save states
* Clipboard sharing (before macOS 15)
* Dynamic display resolution (before macOS 14)
* Save states (before macOS 14)
4 changes: 4 additions & 0 deletions guides/windows.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,3 +91,7 @@ If Windows 11 setup is stuck due to lack of network connection:
### SPICE tools did not install automatically

See [this page]({% link guest-support/windows.md %}#windows-xp-and-higher) for more details.

### Windows installer loads and then goes into a black screen

Windows 11 24H2 has a compatibility issue with the graphics drivers that are provided by the UTM guest tools ISO. You can eject the guest ISO from the CD menu and reboot to access Windows installer. After the installation is complete, you can re-mount the guest tools from the CD menu and selecting "Install Windows Guest Tools". After you install the guest tools, you may see a black screen again. If this happens, you should reset the VM to allow the drivers to properly load at boot.
Loading

0 comments on commit e96fdbc

Please sign in to comment.