Skip to content

Configuration File

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.