You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* 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
Copy file name to clipboardExpand all lines: docs/guides/controller-autoconfiguration.md
+20-11Lines changed: 20 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -285,31 +285,40 @@ When using RetroArch, not all controller buttons are automatically mapped throug
285
285
1. Identify special buttons on your controller
286
286
- Look for buttons on your physical controller not automatically mapped by Retroarch.
287
287
- 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
291
291
- Launch Retroarch.
292
292
- Navigate to: `Settings` → `Input` → `Hotkeys`.
293
293
- Select the special function you want to assign (e.g., *Menu Toggle*, *Screenshot*).
294
294
- Press the desired button on your controller to bind it.
295
295
- Exit Retroarch properly to save the settings:
296
296
- 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.
298
298
299
-
3. Transfer hotkey assignments to your controller autoconfig file
299
+
4. Transfer hotkey assignments to your controller autoconfig file
300
300
- Open your main `retroarch.cfg` file.
301
-
-Locate the hotkey assignment lines, for example:
301
+
-Find and copy the hotkey assignment lines, for example:
302
302
```
303
-
input_menu_toggle_btn = "[x]"
304
-
input_screenshot_btn = "[y]"
303
+
input_menu_toggle_btn = "[w]"
304
+
input_screenshot_btn = "[x]"
305
305
```
306
-
(The values `[x]`, `[y]` are placeholders from your config.)
306
+
*(Replace `[w]` and `[x]` with your actual button values.)*
307
307
- Open your controller’s autoconfig file, typically found at:
- 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.
313
322
314
323
### Analog L2/R2 remapping
315
324
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