v0.1.0

Early, experimental release of eGPU Switch, a Decky Loader plugin that automates all-ways-egpu from Deck Mode.

Marked as a prerelease (0.x per SemVer): validated on one specific hardware/OS combination so far, behavior may still change. See the README's Compatibility section for what is tested vs. expected-but-unconfirmed.

Install

The handheld itself is all you need, no second computer or SSH required:

1. Switch to Desktop Mode and download egpu-switch.zip below with a browser.
2. Switch back to Game Mode.
3. In Decky, enable Developer Mode (Settings, General) if not already on.
4. Settings, Developer, Install Plugin from ZIP File, Browse, pick the ZIP from Downloads.

See the README for the SSH-based deploy alternative (useful for development) and full usage/safety notes.

Features

• Switch to eGPU / Switch to iGPU: toggles boot VGA and restarts the display manager. Switching to iGPU also safely ejects the eGPU (unloads NVIDIA kernel modules, detaches it from the PCI bus) in the same operation.
• Eject eGPU: standalone safe-eject action for the edge case where iGPU is already active but the eGPU was never ejected.
• Restart Display Manager and Rescan for eGPU: recovery actions.
• Always-visible Safe/Not safe indicator showing whether it is currently safe to disconnect the Thunderbolt cable.

Why the eject step exists

The proprietary NVIDIA driver does not support surprise PCIe hot-unplug. Disconnecting the Thunderbolt cable while the kernel modules are still loaded can crash the graphical session with a kernel BUG(), confirmed via dmesg during development. Ejecting first (unload modules, detach PCI functions) avoids this.