Skip to content

Switch 2 Connect v0.12.4 - NSO GameCube Controller ESP32-S3 Input Path Alignment

Pre-release
Pre-release

Choose a tag to compare

View all tags
@TommyWabg TommyWabg released this 11 Jul 09:43
v0.12.4
46957e2
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Improvements & Bug Fixes

  • NSO GameCube Controller ESP32-S3 Input Path Alignment: The ESP32-S3 connection path now mirrors the WinRT BLE path by subscribing to all Switch 2 service notify characteristics and routing incoming notifications by their source GATT handle/UUID. This allows NSO GameCube Controller reports to be parsed through the same characteristic-aware flow used by WinRT, instead of forcing the firmware onto a LEGACY input characteristic.

Assets Description

  • Switch2Connect_0.12.4.exe: The all-in-one standalone executable. Fully packed with all dependencies—no Python installation required.

Quick Start

  1. Download Switch2Connect_0.12.4.exe.
  2. Launch the app. If the driver is not installed, a dialog will ask to install the WinUHid driver. Click Yes and approve the administrator UAC prompt.
  3. Once the installation completes, the setup window will close automatically, and the main application will launch.
  4. Turn on your Switch 2 controller by holding the Sync button (or pressing any button if already paired). Do not pair controllers manually in Windows Bluetooth settings; the app uses automatic GATT discovery.
  5. Use the settings panel at the bottom of the app to configure your preferred controller layout (Xbox / PS4 / PS5), gyro sensitivity, and custom button mappings.

Important Setting for Steam Users:

Because this app emulates both Xbox One and PS4 controllers, Steam Input might try to "help" by applying its own layout overrides, which can double-swap your buttons and mess up your in-game controls!
To ensure your layout stays consistent:

  1. Go to Steam > Settings > Controller > Show Advanced Settings.
  2. Make sure "Enable Steam Input for Xbox controllers" is turned ON.
  3. Make sure "PlayStation Controller Support" is set to Enabled. (NOT Enabled in Games w/o Supports)
  4. Now the Switch_2_Controllers app will handle the layout switching for you!

ESP32-S3 N16R8

ESP32-S3 N16R8 Guide
  • ESP32-S3 N16R8 Firmware Installation Guide:
  1. Hold the boot button on the ESP32-S3 N16R8 board.
  2. Plug in the ESP32-S3 N16R8 board's OTG port via USB-C to the PC while holding the boot button.
  3. In the app, click the [ESP32-S3 N16R8 Driver] button.
  4. Click click [Install] and wait until finish installing.
  5. Unplug and plug the ESP32-S3 N16R8 board.
  6. Reconnect any controllers previously paired via the system BLE by pressing SYNC.
  • ESP32-S3 N16R8 Buying Guide:
  1. Search for development boards strictly labeled as ESP32-S3 N16R8. This ensures the board contains 16MB Flash and 8MB PSRAM, which is necessary for handling complex tasks and controller connections. Avoid any boards labeled as "N8R2", "N8R8", or standard "ESP32".
  2. Select the ESP32-S3-WROOM-1 version if you want a built-in PCB antenna. This is the recommended, plug-and-play choice for standard plastic enclosures. Only choose the ESP32-S3-WROOM-1U version if you are using a metal case or require an external antenna to extend the Bluetooth/Wi-Fi range.
  3. Verify that the board features an OTG USB port (often a dual USB-C design). The OTG port is strictly required for data transfer and firmware installation.

Support This Project

Built with a user-experience-first mindset, this project has reached a mature and comprehensive state and will remain completely free to use forever.

If you are highly satisfied when gaming with this app, please consider leaving a tip. Any financial "thank you" is incredibly appreciated!

Happy gaming, and thank you for your generous support!

Assets 3
Loading