vfioSwitcher

A bash script to switch between GPUs for VFIO passthrough.

Run the script with administrative privileges:

sudo ./main.sh

The vfioSwitcher script automates the process of unbinding your designated GPU from its host drivers and binding it to vfio-pci for virtual machine passthrough, and vice versa. It works using a mix of installer scripts and a systemd unit.

When you execute the script, it scans your PCI devices to detect your primary target GPU (AMD or NVIDIA) and its companion audio controller automatically.

Using the interactive menu, you can generate an environment configuration file (/etc/toggle-vfio.conf) that stores your target GPU and audio device IDs. It also creates a systemd service (toggle-vfio.service) and places the core toggle logic (toggle-vfio-logic.sh) in your /usr/local/bin directory.

When you request a switch, the script probes your current session state:

• Binding to VFIO (Host -> VM): It checks if the target GPU is actively in use by your display manager (e.g., GDM, SDDM, LightDM). If it is, the script will prompt you to stop the display manager, kill any lingering processes claiming the GPU/audio, unload the host kernel drivers (nvidia or amdgpu and related), and finally bind the PCI devices to vfio-pci. The display manager is then restarted (using the igpu).
• Binding to Host (VM -> Host): To revert the process, it clears the vfio-pci overrides for both devices, triggers a PCI bus rescan to wake up the GPU, and reloads the respective vendor kernel drivers (nvidia drivers or amdgpu).