libretro / libretro/RetroArch

rgui_config_directory: Rename 'Configuration files' label to `Configurations` and add `Configuration Files, Overrides, and Manage Core Options` to the sub-label

Open
#19,200 14 comments 0 reactions 0 assignees View on GitHub

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:

"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 Configuration saves a timestamped retroarch-[YYMMDD-HHMMSS].cfg file.
      • Not automatically loaded the when RetroArch starts again.
  • With loaded content (Main menu → Load Content):
    • Main Menu → Configuration File → Save New Configuration saves a [corename].cfg file.
      • Not automatically loaded when content is loaded.
    • When RetroArch is closed (or Close Content) [corename]/[corename].opt is saved.
      • Automatically loaded the content is loaded next time.
    • Any changed setting in RetroArch (eg Settings → User Interface → Apperance → Color Theme) followed by Quick Menu → Overrides → Save Core Overrides creates 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
  1. Navigate to Settings > Directory.
  2. Observe the entry labeled "Configuration files".
  3. 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.