Repository navigation
eGPU Switch v0.3.3 (stable)
First stable release since v0.1.0, with everything learned from real hardware testing on an AyaNeo (AMD Ryzen 7840U) and an ROG Ally X folded in.
Highlights since v0.1.0
- Safe eject flow: unloads NVIDIA modules and removes the eGPU from the PCI bus before you disconnect the Thunderbolt cable, instead of only switching boot VGA.
- Deep Rescan option for cases where a plain PCI rescan does not bring the eGPU back after reconnecting.
- Automatic HDMI audio rebind after a rescan re-adds the eGPU, gated on actual ELD health instead of a fixed sleep.
- Connection diagnostics panel: connection type (Thunderbolt or PCIe), link speed and width, Thunderbolt controller and peripheral names, and boot/sleep freeze fix status.
- Friendly GPU and Thunderbolt controller names parsed from machine-readable lspci and boltctl output, picking the authorized peripheral instead of just the first one listed.
- Settings persistence for the auto-eject and deep rescan toggles.
- Documented fix for AMD platforms that freeze on boot or sleep/wake with the eGPU connected (thunderbolt.host_reset=0 kernel argument).
- Standalone shutdown-eject hook, distributed separately from the plugin, for systems that freeze on shutdown/reboot with the eGPU still attached.
- Dependency-free self-check test suite covering the pure parsing and decision functions.
Installation
Download egpu-switch.zip below and install via Decky Loader: Settings -> Developer -> Install Plugin from ZIP File. Requires all-ways-egpu to be installed and configured first (see README).