DIDIY User Guide

The DIDIY V0 boards (released 6/4/2022) originally came with Arte’s Pico Rectangle firmware, if you have a DIDIY board with no version number on it then you have a Version 0. Please update your board by following the instructions on this page: https://github.com/HTangl/HTangl-Firmware

All current versions of the DIDIY will come with HTangl Firmware preinstalled. If you have not updated your firmware in over a month or so I recommend doing so as features are being added/changed all the time. The instructions in this guide only apply to the most recent version of the HTangl Firmware. Instructions on how to update can be found here.

Playing Melee/P+ on PC

1. Plug in your controller using a USB-C to USB-A cable.

2. Download the HTangl Dolphin controller profile file for Windows, Linux or Mac.

3. Navigate to your Dolphin install location, if you are using the slippi launcher click the gear icon in the top right then go to the netplay tab and click on “Open containing folder”. Now go to User>Config>Profiles>GCPad and put the file in there, you'll most likely need to create the "Profiles" and "GCPad" folders. Note on Linux the Config folder is in the hidden “.config” folder, the full file path is “~/.config/SlippiOnline/Config/Profiles/GCPad/”. You will need to turn off hidden folders in your distro to find the folder.

4. Open Dolphin, If you are using the slippi launcher you will need to go to the same netplay tab as in the previous step but this time click on “Configure Dolphin”. Go to the controllers menu and change any port to "Standard Controller" then click "Configure" next to that port. Go to the Profile drop down menu and select HTangl_X then click "Load", do not click save.

5. Test your controller by pressing some buttons, your inputs should flash red. If it doesn't work press "Refresh" at the top left then select the HTangl_X profile and click “Load” again then check the device drop down menu to make sure “Pico“ is selected.

Close out of all config windows and launch the game. You're good to go!

If you are playing P+ you will need to switch to the P+ game mode, scroll down to the game modes section for instructions.

Playing on Wii/GC/Switch

GC/Wii - Plug in the controller with a USBC to GC cable. No further setup is required. If you are playing P+ you will need to switch to the P+ mode, check the game modes section below for instructions.

If you are playing on a Wii using a USB loader you need to enable "Native Controller" for your controller to work. This option will be in different places depending on what loader you are using. This is not necessary if you are using Slippi Nintendont as it is enabled by default.

Switch - There are 2 methods for connecting to a Switch, either directly through USB or using a GC adapter. For USB, hold the X button and plugin using a USB C to USB A cable, no further setup is required. For GCC adapter, plug your controller into a GCC adapter using a UCBC to GC cable. You will then need to switch to the Ultimate game mode, check the “Game Modes” section below for instructions. Switching game modes is not needed when plugging in through USB holding X.

Game Modes

HTangl Firmware has several different game modes which change stick coordinates and mappings depending on the mode. The controller will always start in the Melee game mode (unless holding the X button on plugin), it does not save the mode you played in last. You switch game modes by first plugging in the controller and then pressing 3 buttons simultaneously (do no try to hold all 3 buttons before plugging in), the game mode will change instantly, you do not need to hold the buttons down. These are the commands for accessing each mode:

  • Mod X + Start + L = Melee (default mode)

  • Mod X + Start + Left = Project M/+

  • Mod X +Start + Down = Ultimate

  • Mod X + Start + Right = FGC (Used for traditional fighters)

  • *Mod Y + Start + L = Keyboard (emulates a standard PC keyboard)

  • Mod Y + Start + Left = Rivals of Aether

  • Mod Y + Start + Down = Platformer (this is a generic mode meant for playing platformers like mario, hollow knight, etc.)

*The Keyboard mode is a unique mode that requires an extra step to access. Before inputting the mode button combination you must unplug the controller and then plug back in while holding the Z button. This changes the firmware communication backend to DInput instead of the default Xinput. If you try to access keyboard mode without first switching to the DInput backend the controller will freeze and you will have to unplug/replug to reset it.

Layout pictures for each game mode can be found here: https://www.htangl.com/modes

Input Viewer

The HTangl and DIDIY work with the B0XX input viewer made by Simple Controllers but there are a couple files that need to be modified

Start by downloading the input viewer from this link: B0XX Input Viewer
Make sure to grab the "B0XXInputViewer.zip" file not the source code zip

Next download the modified files from this link: HTangl Input Viewer

After unzipping both files open the B0XX Input Viewer folder and go to the /resources/app folder then replace the serial.js file and everything in the images folder with the files from the HTangl Input Viewer.zip. You should now be able to plug in your controller and launch the input viewer, make sure to plug your controller in before starting the program.

To change the background color for chroma keying edit the style.css file, the background color can be defined with either a word or rgb value, for example you could just type "green" or you could put in the rgb value for green "rgb(0, 255, 0)". There are also 2 different background image files in the images folder you can choose from, one that is a bit easier to read and one that has GCC button symbols, change the file name of whichever one you want to use to “bg.png”.

Art Template

If you have a DIDIY Case and would like to add your own art to the top panel you can use the following templates. Watch the HTangl Art Printing video for more info on how to use these files. Although the video focuses on the HTangl the principals are the same.

DIDIY Case Art Template - DIDIY Case with Select/Home Buttons Art Template

DIDIY Wiring

You can use this picture for wiring your DIDIY. It’s a mirror of the default HTangl layout so all the buttons are shown as if you are looking at the controller from the bottom.