hid-mitm
hid-mitm copied to clipboard
Sysmodule mitming the Horizon hid (human interface device) services to allow using unsupported gamepads on the nintendo switch.
hid-mitm
Sysmodule mitming the Horizon hid (human interface device) services.
Disclaimer:
This sysmodule is in beta! Problems are to be expected. If you encounter any that aren't listed in the known issues section please report it here if nobody else did already.
Features
-
Rebind buttons on your gamepads.
-
Use custom gamepads on your nintendo switch by using your phone/pc as a proxy.
Setup
While hid-mitm will work perfectly fine on stock atmosphere and possibly reinx the recommended setup is to download the latest Kosmos since it comes preconfigured with the awesome Kosmos Toolbox which allows you to easily configure hid-mitm.
On Kosmos it's just a matter of opening the Kosmos Toolbox, enabling the hid-mitm sysmodule and rebooting.
On Atmosphere, installing hid-mitm can be done by dragging the content of the release.
No help for ReiNX is provided, if it runs that's fine but if you run into problems please try on a supported cfw before reporting.
No support whatsoever for sxos.
Usage
Rebinding buttons
Simply open the Kosmos toolbox, go to the sysmodule menu and continue to the hid-mitm menu from there (it's a simple button-press explained in the bottom bar)
After that a screen will pop up in which you can select the button you want to rebind and then what you want it to rebind for.
After you're done, be sure to touch the button in the middle to save your changes.
You can also configure it manually by editing the /config/hid_mitm/config.ini
file.
Custom gamepads
The way that custom gamepads work with hid-mitm is not by directly connecting the gamepad to your switch but by connecting your gamepad to your phone (and experimentally pc) and then running the hid-mitm app which then in turn sends the input to your switch which will recognize it as an additional pro-controller.
Download the companion_apps.zip
from the release page.
Android
- Install the
hid-mitm.apk
from the zip on your phone. - Make sure that your switch has hid-mitm enabled and is connected to the same network as your phone. You can use 90dns if you don't want your switch to connect to nintendos servers.
- Connect your gamepad to your phone
- Enter the ip-address of your nintendo switch in the hid-mitm app (it can be found in the network settings) and press "connect"
- Your switch now should now pick up your gamepad as an additional pro-controller! :)
iOS
- Install the
hid-mitm.ipa
from the zip on your phone. You can use Cydia Impactor for that, don't worry it will work just fine even without a jailbreak. - Make sure that your switch has hid-mitm enabled and is connected to the same network as your phone. You can use 90dns if you don't want your switch to connect to nintendos servers.
- Connect your gamepad to your phone (please note that apple is rather restrictive with the choice of gamepads that they allow you to use)
- Enter the ip-address of your nintendo switch in the hid-mitm app (it can be found in the network settings) and press "connect"
- Your switch now should now pick up your gamepad as an additional pro-controller! :)
As a workaround to iOS not recognizing a plus and minus button l1+l2+r1+r2+x
will result in a plus
and l1+l2+r1+r2+dpad-left
in a minus
.
Hid-mitm can also easily be repurposed to do scripted inputs (for example a "twitch plays").
Check out the input_pc.py
for some reference of how to talk to hid-mitm.
Known issues
- In some games the "connect gamepad" dialog will pop up every few minutes when playing in multiplayer with a custom gamepad connected
- There are various problems that happen if hid-mitm and sys-ftpd are enabled at the same time.
- Some phones have a terrible bluetooth connection which will result in input-delay if using bluetooth gamepads. I can't do anything about that, that's an issue with android.
- On some wifi-networks iPhones have problems which will result in terrible input delay. You can work around this by just opening a hotspot on your phone and letting the switch connect to that. If you don't want your switch to use up mobile data be sure to enable 90dns.
- Some gamepads won't have their inputs mapped correctly on android.
If anyone who has experience with android development wants to get that fixed by adding some kind of "setup interface" it would be greatly appreciated. - Tetris 99 doesn't want to recognize custom gamepads for some reason
- The switch doesn't seem to accept using the custom gamepad as "activity" so the screen will automatically fade out after a while. You can work around that by turning off the auto-screen-off feature in the system settings.
Planned features
- Support for connecting multiple custom gamepads
- Support for motion controls
- (maybe) vibration support
- Support for "disguising" gamepads as something else. To allow for example to play pokemon with a pro-controller.
Support
The best way to get your questions answered is by asking in the AtlasNX discord.
Please don't pollute the issue-tracker with general usage questions.