3DS:Rehid: Difference between revisions

{{Infobox homebrew

| title = Rehid

| imagealt = RehidHelper banner as used on the HOME Menu

* '''Remapping Buttons''' - Rehid allows for the remapping of buttons or button combos to different buttons or combos.

* '''Remapping Touch''' - You can assign button inputs to points on the touchscreen, or map certain areas on the touchscreen to button.

* '''Per Game Remaps''' - Rehid allows you to save configurations to a specific title, or set a remap to be used globally.

* '''RehidHelper''' - Rehid features an app to help you download Rehid's sysmodules, scan QR codes to install configurations, or disable Rehid.

==Installation==

|-|Universal Updater=

===what you need===

* [[3DS:Universal-Updater|Universal Updater]] installed on your console

===instructions===

# Power on the console

# Tap the magnifying glass on the bottom screen, then search for '''rehid'''

# Wait until the app installs

# Power off your Console

# While holding {{B|SELECT}}, power on your console to enter Luma3DS configuration

# Ensure that "'''Enable loading external FIRMs and modules'''" is selected

===what you need===

* the latest release of [https://github.com/hax0kartik/rehid/releases/latest Rehid] (the <code>0004013000001D02.cxi</code> and <code>rehidhelper.cia</code> files)

* [[3DS:luma3DS|Luma3DS]] updated to 13.0+

===Instructions===

# Power off your Console

# While holding {{B|SELECT}}, power on your console to enter Luma3DS configuration

# Ensure that "'''Enable loading external FIRMs and modules'''" is selected

==Usage==

===Adding configs===

# Go to [https://mikahjc.github.io/3dsRemapBuilder/config 3DS Remap Builder] to configure your key mappings

# When finished click on '''Show as QR code'''

#* If you are unable to scan QR codes on your console, instead click '''Build this remap''' and place the downloaded <code>rehid.json</code> into a <code>rehid</code> folder on the root of your SD card, or <code>rehid/(title ID)/</code> to remap a specific game. You can find the title ID of your game using [https://3dsdb.com/ 3dsdb]

# Power on your console and launch RehidHelper

# Select Scan QR Code and scan the generated QR code from the website

# Select a title from the list for the remap to be applied to, or select global for all titles

# Press {{B|start}} to exit

===Disabling Rehid===

# launch RehidHelper from the HOME menu

# Press {{B|B}} to reboot.

===Removing configs===

===Config file===

<p>Rehid stores its key mappings in <code>.json</code> files located at <code>/rehid/rehid.json</code>, or in a title ID folder within <code>/rehid/</code> to use with a specific title. You can manually create your own key mappings by creating a <code>rehid.json</code> file with the key mappings you want. Possible options include:</p>

<p><code>"keys":</code> which maps a key press to another key press.</p>

<syntaxhighlight lang="json">{"keys":[{"press":"ZR","get":"R"},{"press":"ZL","get":"L"}]}</syntaxhighlight>

<p>With the above, any time you press the {{B|ZR}} key, {{B|R}} key would be triggered, and any time you press the {{B|ZL}} key, {{B|L}} key would be triggered. Possible Keys are: <code>A</code>, <code>B</code>, <code>X</code>, <code>Y</code>, <code>SELECT</code>, <code>START</code>, <code>ZL</code>, <code>ZR</code>, <code>L</code>, <code>R</code>, <code>LEFT</code>, <code>RIGHT</code>, <code>UP</code>, <code>DOWN</code>, <code>CLEFT</code>(CPAD), <code>CRIGHT</code>(CPAD), <code>CUP</code>(CPAD), <code>CDOWN</code>(C-PAD), <code>CSLEFT</code>(C-STICK), <code>CSRIGHT</code>(C-STICK), <code>CSUP</code>(C-STICK), <code>CSDOWN</code>(C-STICK)</p>

<p>You can also do custom key combos;</p>

<syntaxhighlight lang="json">{"keys":[{"press":"X+Y","get":"R"},{"press":"SELECT","get":"L+R"}]}</syntaxhighlight>

<p>With this any time you press {{B|X+Y}}, {{B|R}} key would be triggered, and any time you press the {{B|SELECT}} button, both {{B|L}} and {{B|R}} would be triggered.</p>

<p><code>"cpad":</code>, which maps a key press to a circle pad x and y coordinate from -190 to 190;</p>

<syntaxhighlight lang="json">{"cpad":[{"press":"CUP","get":[0,190]},{"press":"CDOWN","get":[0,-190]},{"press":"CLEFT","get":[-190,0]},{"press":"CRIGHT","get":[190,0]}]}</syntaxhighlight>

<p><code>"touch":</code>, which maps a key press to a given x,y coordinate on the touchscreen from 0,0 top left to 320,240 bottom right;</p>

<syntaxhighlight lang="json">{"touch":[{"press":"LEFT+UP","get":[0,0]},{"press":"RIGHT+DOWN","get":[320,240]}]}</syntaxhighlight>

<p><code>"touchtokeys":</code> which maps a box starting at a given x,y coordinate, with a given height and width, that when tapped will output a key press;</p>

<syntaxhighlight lang="json">{"touchtokeys":[{"press":[10,20,50,100],"get":"A"}]}</syntaxhighlight>

<p>For this example, it creates a box starting at x=10 y=20, with a height of 50 and a width of 100.</p>

<p>Other options include:<br>

<code>"cpadtodpad":true</code> maps the C-pad with D-pad key presses<br>

<code>"dpadtocpad":true</code> maps the D-pad with C-pad key presses<br>

<code>"overidecpadpro":true</code> makes it so games don't recognize the circle pad pro<br>

<code>"homebutton":</code> maps the HOME button to a key press</p>

<p>These Options can be strung together into a single line, for example:</p>

<syntaxhighlight lang="json">{"keys":[{"press":"ZR","get":"R"},{"press":"ZL","get":"L"}],"cpad":[{"press":"CUP","get":[0,190]},{"press":"CDOWN","get":[0,-190]}],"touch":[{"press":"LEFT+UP","get":[0,0]},{"press":"RIGHT+DOWN","get":[320,240]}],"touchtokeys":[{"press":[10,20,50,100],"get":"A"}],"cpadtodpad":true,"dpadtocpad":true,"overridecpadpro":true,"homebutton":"ZR+ZL"}</syntaxhighlight>

===SD file layout===

*** {{Tree icon|d}} (title ID)

==Troubleshooting==

===An exception occurred===