Hid-mitm-plus Switch

hid-mitm-plus
General
Author	PaskaPinishkes
Type	Sysmodules
Version	PLUS-0.2-ALPHA
License	GPL-2.0
Last Updated	2020/05/01
Links
Download
Website
Source

hid-mitm-plus is a hid-mitm (by jakibaki) fork that allows for up to 4 controllers (and in the future 8) to be used on a Nintendo Switch from a PC using the network. The purpose for this is to allow the Nintendo Switch to be playable through services such as Parsec (tested and working).

Development has been abandoned in favor of a rewrite that works on Horizon 10.0. If you still want to use this sysmodule, please keep in mind that hid-mitm-plus only works on <10.0

Note: Obsolete sysmodule, use sys-hidplus instead.

Features

• Use custom gamepads on your nintendo switch by using your pc as a proxy (take in mind that this sysmodule isn't retrocompatible with the original hid-mitm proxies).
• Rebind buttons on your gamepads (untested).

Installation

Requirements:

• Atmosphere (not tested on ReiNX, crashes on SX OS and in some Kosmos setups).
• hid-mitm-plus pre-release.
• Python 3.
• 9.0.0+ FW Version.
• If you want to use a streaming service such as Parsec, you'll need either:
  • a) A capture card such as Elgato HD60 S or Pro; or
  • b) SysDVR.

Instructions:

• Extract the pre-release zip file and copy the atmosphere folder to your microSD card.
• Insert the microSD card to your Nintendo Switch and turn it on.
• Go to Settings > Internet and write down somewhere the IP Address, you'll need it.
• Open Command Prompt and go to the folder where you extracted the hid-mitm-plus pre-release.
• Execute py -3 -m pip install inputs.
• Execute python3 input_pc.py [IP ADDRESS], replacing [IP ADDRESS] with the IP that appears on the Switch Internet Settings.
• If you have a controller connected, now the switch should detect it.

User guide

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 pc and then running the input_pc.py app which then in turn sends the input to your switch which will recognize it as an additional pro-controller.

Right now, it is possible to emulate up to 4 controllers and in the future, 8. Please take in mind that everything in this sysmodule and script is experimental and was only tested with an Xbox controller. The android and iOS apps made for the original hid-mitm weren't tested, but are most likely unsupported due to the changes made to support more controllers.

Hid-mitm-plus 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.

Rebinding buttons

Note: This feature is untested due to Horizon 10.0 featuring this.

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.

Known issues

• Some games don't work properly (check Games with issues).
• If a controller is disconnected, it's not possible to reconnect it unless you restart the sysmodule/switch.
• The sysmodule freezes at boot at some consoles (possibly because of kosmos?).

Games with issues:

• BOXBOY! + BOXGIRL! (Input is not detected for some reason).
• Cuphead (Input is not detected for some reason).
• 1-2-Switch (Needs gyroscope and Joy Con support).
• Pokemon Let's Go Pikachu/Eevee (Needs gyroscope and Joy Con support).
• Super Mario Party (Needs gyroscope and Joy Con support).
• Mario & Sonic at the Olympic Games Tokyo 2020 (Some sports require the gyroscope, but most of the game is still playable).
• Super Smash Bros. Ultimate (Crash when booting).
• Pokémon Sword/Shield (Crash when booting).
• Clubhouse Games: 51 Worldwide Classics (Crash when booting).

Changelog

PLUS 0.2 ALPHA

• Untested pre release that tries to fix a bug in 0.1 where controllers aren't detected by the Switch in the latest AMS versions.

PLUS 0.1 ALPHA

• Untested pre release with 4 controller support.

Credits

• jakibaki - original sysmodule (hid-mitm).
• PaskaPinishkes - code edits to support up to 4 players.
• ReSwitched Discord Server - help in the support channels.

External links

• GitHub (hid-mitm-plus) - https://github.com/PaskaPinishkes/hid-mitm-plus
• GitHub (hid-mitm) - https://github.com/jakibaki/hid-mitm
• GBAtemp - https://gbatemp.net/threads/hid-mitm-plus-a-hid-mitm-fork-to-allow-the-switch-to-be-playable-through-parsec-or-steam-remote.563744/