• v0.1.0 ba44e579e1

    v0.1.0 Stable

    DieMitchell released this 2026-10-17 22:01:13 +02:00 | 0 commits to main since this release

    First release. The Switch 2 NSO GameCube controller now works wirelessly over the device's own Bluetooth LE, appearing as a virtual Xbox 360 pad.

    Steam Frame (SteamOS, arm64): framecube-bridge-v0.1.0-linux-aarch64.tar.gz

    • About 130 Hz input from a 7.5 ms connection interval (requires the setcap step below). Rumble works.
    • Adds + › Launch Program › GameCube Controller with a GameCube icon. Each launch toggles the bridge on or off.
    • Install:
      tar xzf framecube-bridge-v0.1.0-linux-aarch64.tar.gz && cd framecube-bridge-v0.1.0-linux-aarch64
      sh frame/install.sh
      sudo setcap cap_net_raw+ep ~/.local/share/nso-gc-bridge/nso-gc-bridge
      
      Without setcap, input runs at Linux's default of about 33 Hz.

    Windows (x64): framecube-bridge-v0.1.0-windows-x64.zip

    • Requires the ViGEmBus driver.
    • About 66 Hz, which is the fastest BLE interval Windows allows (15 ms).
    • Don't pair the controller in Windows Bluetooth settings; run nso-gc-bridge.exe and hold Sync.
    • The rumble fix in this build hasn't been tested on Windows yet.

    Known limitations

    • Press Sync on the controller after every disconnect, because bonded reconnect isn't implemented yet.
    • Rumble is on/off only, and the controller has no gyro.

    The protocol logic is ported from joypad-os (Apache-2.0). Not affiliated with Nintendo or Valve.

    Downloads