hotplugger | VirtIO USB Port passthrough helper

(Optional) run python3 monitor.py and follow the prompts. Basically once you hit Enter you have to plug and unplug an USB device (a thumb drive or audio device preferred) into the USB ports that you want to know their DEVPATH route from. This will help you identify them so you can write them into config.yaml in the ports array. This array only accepts DEVPATH routes that UDEV generates.
git clone https://github.com/darkguy2008/hotplugger.git
(Optional) run python3 monitor.py and follow the prompts. Basically once you hit Enter you have to plug and unplug an USB device (a thumb drive or audio device preferred) into the USB ports that you want to know their DEVPATH route from. This will help you identify them so you can write them into config.yaml in the ports array. This array only accepts DEVPATH routes that UDEV generates.
Edit config.yaml. It must stay in the same folder as monitor.py and hotplugger.py. Using the following file as example: virtual_machines: windows: socket: /home/user/vm/windows/qmp-sock delay: 1 hubs: - xhci0.0 - xhci1.0 ports: - /devices/pci0000:00/0000:00:14.0/usb3/3-3 - /devices/pci0000:00/0000:00:14.0/usb3/3-4 This is for a Windows VM where its UNIX QEMU QMP socket is located at /home/user/vm/windows/qmp-sock, with a 1-second delay after a device is plugged to actually do the hotplugging to QEMU, with two virtual XHCI hubs that will receive all the USB devices in the 2 USB ports denoted as /devices/pci0000:00/0000:00:14.0/usb3/3-3 and /devices/pci0000:00/0000:00:14.0/usb3/3-4 . To figure this out, I ran monitor.py and got this output: Monitoring USB ports... ^C DEVPATH=/devices/pci0000:00/0000:00:14.0/usb3/3-3 DEVPATH=/devices/pci0000:00/0000:00:14.0/usb3/3-3/3-1:1.0 DEVPATH=/devices/pci0000:00/0000:00:14.0/usb3/3-4 DEVPATH=/devices/pci0000:00/0000:00:14.0/usb3/3-4/3-1:1.0 DEVPATH=/devices/pci0000:00/0000:00:14.0/usb3/3-4/3-1:1.1 So this means that I have to enter only the shortest entries: /devices/pci0000:00/0000:00:14.0/usb3/3-3 and /devices/pci0000:00/0000:00:14.0/usb3/3-4
Create an /etc/udev/rules.d/99-zzz-local.rules file with the following content: SUBSYSTEM=="usb", ACTION=="add", RUN+="/bin/bash -c 'python3 /path-to-hotplugger/hotplugger.py >> /tmp/hotplugger.log' 2>&1" SUBSYSTEM=="usb", ACTION=="remove", RUN+="/bin/bash -c 'python3 /path-to-hotplugger/hotplugger.py >> /tmp/hotplugger.log' 2>&1" Make sure to change path-to-hotplugger with the path where you cloned the repo to, or installed the package. It can be simplified, but this one is useful in case you want to debug and see what's going on. Otherwise, proceed with a simpler file: SUBSYSTEM=="usb", ACTION=="add", RUN+="/bin/bash -c 'python3 /path-to-hotplugger/hotplugger.py'" SUBSYSTEM=="usb", ACTION=="remove", RUN+="/bin/bash -c 'python3 /path-to-hotplugger/hotplugger.py'"
Have a coffee! ☕
This is a work in progress, but here's some steps to get you started:.
Edit your VM's XML config like this: <domain type='kvm' xmlns:qemu='http://libvirt.org/schemas/domain/qemu/1.0'> <name>QEMUGuest1</name> <uuid>c7a5fdbd-edaf-9455-926a-d65c16db1809</uuid> ... <qemu:commandline> <qemu:arg value='-chardev'/> <qemu:arg value='socket,id=mon1,server=on,wait=off,path=/tmp/my-vm-sock'/> <qemu:arg value='-mon'/> <qemu:arg value='chardev=mon1,mode=control,pretty=on'/> </qemu:commandline> </domain> Add the xmlns attribute and the QEMU commandline arguments like that. The /tmp/my-vm-sock is the name of an unix domain socket. You can use any, just make sure to also put the same path in the config.yaml file.
If you get a permissions issue, edit /etc/libvirt/qemu.conf and add security_driver = "none"to it to fix apparmor being annoying about it.