rgui_config_directory: Rename 'Configuration files' label to `Configurations` and add `Configuration Files, Overrides, and Manage Core Options` to the sub-label
Nobody has claimed this yet.
- Dominant language
- C
- Stars
- 14.1k
- Forks
- 2.2k
- Avg merge
- 7h 35m
- Merged PRs (30d)
- 51
Description
Is there an existing issue for this?
- This is a bug in RetroArch frontend
- I have searched the existing issues
Description
Currently, the directory setting located at Settings → Directory (defined in settings_def_dir_core.h) outputs:
Configuration files
Default configuration file is stored in this directory.
is causing significant confusion among users. Many mistakenly interpret this setting as the location for the primary retroarch.cfg file:
- https://github.com/libretro/RetroArch/issues/19196
- https://github.com/libretro/RetroArch/issues/16490
"Configuration files" behavior
As clarified in previous discussions, this directory is specifically intended for per-core, per-directory, and per-content override .cfg files.
Examples of "Configuration files" directory generated content:
- Without content loaded:
Main Menu → Configuration File → Save New Configurationsaves a timestampedretroarch-[YYMMDD-HHMMSS].cfgfile.- Not automatically loaded the when RetroArch starts again.
- With loaded content (Main menu → Load Content):
Main Menu → Configuration File → Save New Configurationsaves a[corename].cfgfile.- Not automatically loaded when content is loaded.
- When RetroArch is closed (or Close Content)
[corename]/[corename].optis saved.- Automatically loaded the content is loaded next time.
- Any changed setting in RetroArch (eg
Settings → User Interface → Apperance → Color Theme) followed byQuick Menu → Overrides → Save Core Overridescreates directory and saves file[corename]/[corename].cfg- Not automatically loaded when content is loaded.
Quick Menu → Core Options → Manage Core Options- This sub-menu does not have menu items for all cores.
Todo
Update Settings → Directory → Configuration files
Edit settings_def_dir_core.h.
Replace:
Configuration files
Default configuration file is stored in this directory.
With:
See PR (which also includes the rationale):
Steps to reproduce the bug
- Navigate to Settings > Directory.
- Observe the entry labeled "Configuration files".
- The lack of specificity leads to the assumption that this manages global configurations, rather than the intended override files.
Version/Commit
1.22.2
Bisect Results
No response
Present in the nightly version
Yes, this is reproduced in the nightly build
Platform & operating system
GNU/Linux
Affected Cores
No response
Environment information
No response
Relevant log output
References
1: Press the 'Select' button on this item for further guidance. This follows the existing help pattern used in areas like 'Main Menu → Quit' and 'Settings → User Interface → Language'.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start in settings/settings_def_dir_core.h and review the referenced pull request for the intended wording and rationale. Verify the Settings → Directory entry uses the requested label and sub-label, then confirm the updated text appears correctly in the frontend.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- c
- Domain
- frontend
- Issue type
- Bug
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 30/100