Skip to content

Commit b614773

Browse files
authored
Update controller-autoconfiguration.md (#1072)
* Update controller-autoconfiguration.md Add input_menu_toggle_btn_label, and input_screenshot_btn_label, to the "Add hotkey(s)" section * Update controller-autoconfiguration.md Explain how to apply hotkey button labels * Update controller-autoconfiguration.md Improved step 5 in the "Add hotkey(s)" section
1 parent 51dc254 commit b614773

File tree

1 file changed

+20
-11
lines changed

1 file changed

+20
-11
lines changed

docs/guides/controller-autoconfiguration.md

Lines changed: 20 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -285,31 +285,40 @@ When using RetroArch, not all controller buttons are automatically mapped throug
285285
1. Identify special buttons on your controller
286286
- Look for buttons on your physical controller not automatically mapped by Retroarch.
287287
- Examples include
288-
- *Menu Toggle* (virtually all controllers has them)
289-
- Additional special buttons may be found on some controllers. For example, the *Capture* (screenshot) button and the *HOME* button on the Nintendo Switch Pro Controller are examples of such special buttons.
290-
2. Assign hotkeys in Retroarch
288+
- *Menu Toggle* (virtually all controllers have them)
289+
- Additional special buttons may be found on some controllers. For example, the *Capture* (screenshot) and the "Home" button on Nintendo Switch Pro Controller.
290+
3. Assign hotkeys in Retroarch
291291
- Launch Retroarch.
292292
- Navigate to: `Settings``Input``Hotkeys`.
293293
- Select the special function you want to assign (e.g., *Menu Toggle*, *Screenshot*).
294294
- Press the desired button on your controller to bind it.
295295
- Exit Retroarch properly to save the settings:
296296
- On most platforms, just closing Retroarch saves the config.
297-
- On Android, explicitly quit via `Main Menu``Quit` to ensure save.
297+
- On Android, explicitly quit via `Main Menu``Quit` to ensure settings are saved.
298298

299-
3. Transfer hotkey assignments to your controller autoconfig file
299+
4. Transfer hotkey assignments to your controller autoconfig file
300300
- Open your main `retroarch.cfg` file.
301-
- Locate the hotkey assignment lines, for example:
301+
- Find and copy the hotkey assignment lines, for example:
302302
```
303-
input_menu_toggle_btn = "[x]"
304-
input_screenshot_btn = "[y]"
303+
input_menu_toggle_btn = "[w]"
304+
input_screenshot_btn = "[x]"
305305
```
306-
(The values `[x]`, `[y]` are placeholders from your config.)
306+
*(Replace `[w]` and `[x]` with your actual button values.)*
307307
- Open your controller’s autoconfig file, typically found at:
308308
```
309309
retroarch/autoconfig/[platform]/[controller-name].cfg
310310
```
311-
- Append the copied hotkey lines to the bottom of this autoconfig file.
312-
- Save the autoconfig file.
311+
- Append the copied hotkey lines to the bottom of the autoconfig file.
312+
5. Add labels. They will be visible in `Settings` → `Input` → `Hotkeys`.
313+
- Add variable names. Complement the variables that you just added to the autoconfig file with the corresponding label variables ([variable name]+"_label") at the absolute bottom of the file, for example:
314+
```
315+
input_menu_toggle_btn_label = "[y]"
316+
input_screenshot_btn_label = "[z]"
317+
```
318+
*(Replace `[y]` and `[z]` with the appropriate label values described below.)*
319+
- Add the corresponding variable label values. Refer to the manufacturer’s official labeling for each button, but avoid using all capital letters unless the name is an abbreviation. Use standard capitalization with an initial capital letter to improve readability. Also, do not add the word “button” if it is already part of the official name. For instance, Nintendo refers to the “HOME button” on the Switch Pro Controller, but you should label it simply as “Home.” Similarly, the menu toggle label for Sony PlayStation controllers is “PS.” This approach balances clarity and respect for official naming.
320+
6. Save the autoconfig file.
321+
7. Restart RetroArch and navigate to `Settings` → `Input` → `Hotkeys` to confirm that they look as intended.
313322
314323
### Analog L2/R2 remapping
315324
RetroArch has a bug([ref1](https://github.com/libretro/RetroArch/issues/6920), [ref2](https://github.com/libretro/RetroArch/issues/16767)) that causes analog L2/R2 triggers to be incorrectly mapped as digital buttons instead of analog axes when configuring controls through the UI. This affects pressure-sensitive triggers on controllers like PlayStation 2 and later, making some games unplayable due to the lack of analog input.

0 commit comments

Comments
 (0)