Joy-Con Toolkit Switch - Gamebrew

An easy tool that allows you to modify the Joy-Con colors your Switch system associates with your Joy-Cons and Pro Controllers.

The change is carried in the controllers software and shows on any Switch, ideal for controllers with aftermarket shells.

This tool was inspired by Shinyquagsire23's HID-Joy-Con-Whispering.

Note: Before you do anything, make a backup of your SPI flash. If you have done one, change the name a little bit to avoid overwrites and keep it for life.

• Change colors of your Joy-Con and Pro Controller (plus left/right grip).
• Use the IR stream or capture and save photos.
• Use the NFC to check type and UID.
• Save your custom colors for future use.
• Backup your SPI flash.
• Edit user calibration for analog sticks.
• View S/N, FW Version, MAC address and Battery.
• Restore from a backup. Restore colors, S/N, Calibration, Full restore.
• Change S/N.
  • If you didn't do a valid backup and you lost your S/N, you are the only responsible.
  • If for whatever reason you lost it, check the plastic slivers that your Joy-Con were wrapped inside the retail box.
• Debug - Send Custom Commands. Send Vibrations, set player and HOME leds, etc, and see their reply.
  • Only for users that know what they are doing. You are the only responsible.
• Full test controls. Test buttons, analog sticks, motion controls, complete with calibration.
• Temperature reading. Check the current Joy-Con or the ambient temperature after letting it for some minutes.
• Easter Egg: Play 2 Mario themes through Joy-Con HD Rumble.
• Capture traffic between the controller and the PC into a log file.
• Led indicator:
  • Player Led behavior: Solid - Waiting for command; 4th Led Blinking - Doing stuff.
  • Additionally for Right JC and Pro HOME led: Heartbeat - Waiting for command; Breathing - Doing stuff.
• For more, check Changelog.

Prerequisites

Install only if needed:

How to use

Press the sync button to connect the Joy-Con to your computer. Wait until it starts searching, then open your computer's Bluetooth menu. You should see the Joy-Con pop up. If done correctly, it should automatically show up in the Joy-Con Toolkit program.

In the Joy-Con Toolkit, you'll see the "backup SPI" option, which will create a default state you can revert to. Please make a backup of your SPI flash before doing anything, in case anything goes wrong (may take ~10 mins).

You can now customize the colors by changing the "body colour" or the "buttons colour", press "write colours" to save. Then slot your Joy-Cons back onto your Switch, it should register them as whatever colours you assigned.

Troubleshooting

The colors do not show up in Switch:

Switch 2.3.0 and older:

• Clear the controller cache by doing the following:
• Go to System Settings > Controllers and Sensors and do Disconnect all controllers. Restart your Switch and then pair.

Switch 3.0.0, 4.0.0 and newer:

• Just pair the controller with Switch.