rommapp_docs/docs/Getting-Started/Configuration-File.md

Below is a breakdown of each section of the config.yml file and its purpose:

exclude

This section lets you tell RomM which platforms, ROMs, or files to ignore during scanning.

• platforms Exclude entire platforms (folders) from being scanned. Example:

  platforms: ["ps", "ngc", "gba"]
  

• roms Fine-tune which ROMs or files are excluded.

  • single_file Applies to ROMs that are single files (not in subfolders).

    • extensions: Exclude files by extension. Example:

      extensions: ["xml", "txt"]
      

    • names: Exclude files by name or pattern (supports Unix wildcards). Example:

      names: ["info.txt", "._*", "*.nfo"]
      

  • multi_file Applies to ROMs stored as folders (multi-disc, with DLC, etc.).

    • names: Exclude entire folders by name. Example:

      names: ["final fantasy VII", "DLC"]
      

    • parts: Exclude specific files inside multi-file ROM folders.
      • names: Exclude files by name or pattern. Example:

        names: ["data.xml", "._*"]
        

      • extensions: Exclude files by extension. Example:

        extensions: ["xml", "txt"]
        

---

system

Customize how RomM interprets your folder and platform names.

• platforms Map your custom folder names to RomM's recognized platform names. Example:

  platforms: { gc: "ngc", psx: "ps" }
  

  This treats a gc folder as GameCube (ngc) and psx as PlayStation (ps).

• versions Associate a platform with its main version. This also tells RomM to fetch medatata from the main version source. Example:

  versions: { naomi: "arcade" }
  

---

filesystem

Specify the folder name where your ROMs are located if it differs from the default. For example, if your roms folder it's named my_roms (/home/user/library/my_roms), set this accordingly.

Example:

filesystem: { roms_folder: "my_roms" }

---

!!! tip You can find examples of full binded batocera or es-de config files.

!!! warning Only uncomment or add the lines you need. Any omitted or empty sections will use RomM's defaults. For a full example, see the config.example.yml file.