/sys-con

Nintendo Switch sysmodule that allows support for third-party controllers

Primary LanguageC++GNU General Public License v3.0GPL-3.0

sys-con

A Nintendo Switch custom sysmodule for third-party controller support. No man-in-the-middle required!

[Switch FW 5.0.0+] [Atmosphère only]

Description

This sysmodule aims to provide complete functionality for most popular game controllers not supported by Nintendo Switch. At the current moment, only USB connection is supported.

This app is missing a lot of features. For more information, see the issues page.

⚠ I can't support your generic 3rd party HID controller yet.

It is a limitation of the firmware and I'm looking to work around it.

Install

Grab the latest zip from the releases page. Extract it in your SD card and boot/reboot your switch.

Config

sys-con comes with a config folder located at sdmc:/config/sys-con/. It contains options for adjusting stick/trigger deadzone, as well as remapping inputs. For more information, see example.ini in the same folder. All changes to the files will be updated in real time.

Progress roadmap

  • Docked USB Support
  • [5.0.0-7.0.0] FW Version Support
  • Xbox 360 Controller Support
  • Xbox One X/S Controller Support
  • Dualshock 3 Support
  • Undocked USB Support Works with a USB-C OTG adapter. Some knock-off brands may not support OTG.
  • Xbox 360 Wireless adapter
  • Dualshock 4 Support
  • Rumble Support
  • [Bluetooth Support] See ndeadly's MissionControl
  • Motion Controls Support
  • Config application

Building (For developers)

Don't download the project as ZIP. It doesn't copy the submodules correctly and you will be left with empty folders.

Instead, clone the repository recursively using any git client you have. (Git Bash, Git GUI, Github Desktop, etc.)

Like all other switch projects, you need to have devkitA64 set up on your system.

For compatibility with the Atmosphere-libs dependency, this project currently uses a version of libnx at commit b35d42f. Clone the repository, checkout to that commit, and run make install to set it up.

If you have Visual Studio Code, you can open the project as a folder and run the build tasks from inside the program. It also has Intellisense configured for switch development, if you have DEVKITPRO correctly defined in your environment variables. Handy!

Otherwise, you can open the console inside the project directory and use one of the following commands:

make -j8: Builds the project and its dependencies (libstratosphere) and places the resulting files in the output folder (out/). The -j8 means it will create 8 separate threads to speed up the building process. Make it lower if it freezes up your system.

make clean: Cleans the project files (but not the dependencies).

make mrproper: Cleans the project files and the dependencies.

For an in-depth explanation of how sys-con works, see here.

ko-fi