From ad8358dd97eb904a62e926c20d8d47516ef2820c Mon Sep 17 00:00:00 2001 From: Martin Wimpress <304639+flexiondotorg@users.noreply.github.com> Date: Mon, 13 May 2024 09:15:15 +0100 Subject: [PATCH] Update USB redirection section --- 05-Advanced-quickemu-configuration.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/05-Advanced-quickemu-configuration.md b/05-Advanced-quickemu-configuration.md index e5356b8..a19541c 100644 --- a/05-Advanced-quickemu-configuration.md +++ b/05-Advanced-quickemu-configuration.md @@ -49,7 +49,7 @@ Arguments The following features are available while using the SPICE protocol: - Copy/paste between the guest and host -- Host file sharing to the guest +- Host file sharing with the guest - USB device redirection To use SPICE add `--display spice` to the Quickemu invocation, this requires that the `spicy` client is installed, available from the `spice-client-gtk` package in Debian/Ubuntu. @@ -287,12 +287,21 @@ If you created your Windows 10 or Windows 11 virtual machine with `quickget`, th Quickemu supports USB redirection via SPICE pass-through and host pass-through. +**NOTE!** When a USB device is redirected from the host, it will not be usable by host operating system until the guest redirection is stopped. Therefore, do not redirect the input devices, such as the keyboard and mouse, as it will be difficult (or impossible) to revert the situation. + ## SPICE redirection (recommended) Using SPICE for USB pass-through is easiest as it doesn't require any elevated permission: +Both `spicy` from [spice-gtk](https://www.spice-space.org/spice-gtk.html) (*Input -> Select USB Devices for redirection*) and `remote-viewer` from [virt-viewer](https://gitlab.com/virt-viewer/virt-viewer) (*File -> USB device selection*) support this feature. + - Start Quickemu with `--display spice` and then -- Select `Input` -\> `Select USB Device for redirection` from the menu to choose which device(s) you want to attach to the guest. +- **`spicy` (default) + - **Select `Input` -\> `Select USB Device for redirection` from the menu to choose which device(s) you want to attach to the guest. +- **`remote-viewer` + - **Select `File` -\> `USB device selection` from the menu to choose which device(s) you want to attach to the guest. + +To ensure that this functionality works as expected, make sure that you have installed the necessary SPICE Guest Tools on the virtual machine. ### Enabling SPICE USB redirection on NixOS