3input

KO | EN

gitlite — search

#javascript #python #typescript #llm #golang #android #machine-learning #rust #nodejs #cli #awesome-list #security #ios #open-source

(★ 9)

A SysModule Input Monitor

3input Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 3Input - A System Module Input Monitor

3Input is an input viewer that works behind the scenes on your 3DS. Much like [HorizonMod](https://github.com/Bas25/HorizonMod), the goal is to run as a daemoized process/system module, which you can then use a client to connect to and read your inputs. This is essentially an inverse to InputRedirection in [Luma/Rosalina](https://github.com/LumaTeam/Luma3DS/wiki/Rosalina#inputredirection).

## Features
Launch the Launcher, write down the IP address and port that is presented to you, press A, and then connect to the 3DS IP with a client, such as the example [viewer](https://github.com/phlexplexico/3input/viewer/) (this viewer does not require the port, only the IP).

The current implementation sends a JSON Object per defined frequency. The JSON object also contains escape sequences so an application can properly decode them. Here is an example as to what the JSON being sent looks like:
```JSON
'{\n\t"btn":268435456,\n\t"cp_x":134,\n\t"cp_y":-68,\n\t"tp_x":0,\n\t"tp_y":0,\n\t"ir_btn":14,\n\t"cpp_x":14,\n\t"cpp_y":14\n}\n'
```

You can then use an application to parse it, to make it more readable like so:
```JSON
{
    "btn":268435456,
    "cp_x":134,
    "cp_y":-68,
    "tp_x":0,
    "tp_y":0,
    "ir_btn":14,
    "cpp_x":14,
    "cpp_y":14
}
```

## Why?
Currently, the only way to view inputs for the 3DS is either using a handcam, or via the use of NTR and [coNTRoller-overlay](https://github.com/zed0/coNTRoller-overlay). NTR can be rather buggy, and also uses a lot more resources than necessary to just show inputs. The aim is to replace it with something less buggy, and that can run on both new and old 3DS'.

## Contributors/Credit
- [N3rds](https://github.com/n3rdswithgame) for the entirety of the old codebase. Since then I've been going through and documenting as much as I can to get a further understanding of the codebase itself.
- [leoetlino](https://github.com/leoetlino) for helping with allocation heap and helping with the sysmodule.
- [MarcusD](https://github.com/Bas25/HorizonMod) for HorizonMod. Some code was graciously borrowed within the heap allocation, and a decent reference for running a system module.
- [hax0kartik](https://github.com/hax0kartik) for his [rehid](https://github.com/hax0kartik/rehid) work and helping me out getting the RST services working!

## Building
 - Install [devkitPro](http://devkitpro.org/) 3DS tools.
 - `make`
 - [`bannertool`](https://github.com/Steveice10/bannertool/releases) on your `PATH`.
 - [`makerom`](https://github.com/3DSGuy/Project_CTR/releases) on your `PATH`.

Run `make` in both the `Launcher` directory, and the root directory. Install both `CIAs` on your 3DS, *make sure you're connected to a Wifi Access Point* and launch the Launcher! Now connect with a client (such as [3SharpView](https://github.com/PhlexPlexico/3SharpView) ). Alternatively, check the [Releases](https://github.com/PhlexPlexico/3input/releases) tab for the files.

## Installing
In order to install, you must install *both* CIA files, and then place the `code.ips` file in the same structure in the release. `/luma/titles/0004013000003302/code.ips`. This patch is to allow multiple hooks into the RST service. Once both CIAs are installed, run the launcher, write your IP and port down, and then press A to launch!

## Changing Sending Frequency
The main thread of the module is also reading inputs. If you wish to exit, you can press `SEL+START` to close the application and destroy anything created by it. The following will change the send rate of the inputs:
- `SEL+X` - 140 per second.
- `SEL+Y` - 60 per second. (Default)
- `SEL+A` - 10 per second. 
- `SEL+B` - 1 per second.
- `SEL+START` - Exits the module.

## Viewing the Output
In order to view the output, please consider using a tool such as [3SharpView](https://github.com/PhlexPlexico/3SharpView)

## TODO
There's a few more things in the TODO pile, and these can be found mainly in the code, which will be ported over to the Issues/Project section in GitHub. Most of it is quality of life (i.e. WiFi issues).

## License
This project is licensed under [GNU GENERAL PUBLIC LICENSE V3](https://www.gnu.org/licenses/gpl-3.0.en.html). Feel free to distribute, contribute, and make changes! Pull requests to improve functionality is always welcome!

3input

3input Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

3input

3input Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README