Collection Settings - CoinOPS-Official/RetroFE GitHub Wiki

The settings.conf file in a collection defines the settings for that particular collection. See below for a list of configuration parameters that can be specified in your collection's settings.conf file. (CoinOPS) For both global settings and collection settings, you can add a number at the end (settings14.conf) and it will overide the previous settings files with the numbers below.

Variable Default value Description
list.path /collections/<collection name>/roms;/path/to/another/location Location of your roms, add multiple locations with ;
list.includeMissingItems false Include games in the include.txt even if the rom does not exist.
list.extensions Comma separated rom extensions (e.g. zip,nes)
list.menuSort false Defines whether the items in a collection will be sorted alphabetically
list.romHierarchy false Defines whether the roms directory should be searched hierarchically. There is a performance hit by enabling this, so only use it when needed.
list.truRIP false Defines whether the roms directory should be searched hierarchically based on truRIP format. There is a performance hit by enabling this, so only use it when needed.
launcher <collection name> Specifies which launcher is used when a game is selected from the menu (reads from launchers/<launcher name>.conf). This value can be overwritten per game by putting the launcher name in a single line .conf file in collections/<collection name>/launchers/<game name>.conf.
metadata.type <collection name> Specifies the meta file used in the meta.db to pull additional information like manufacturer, year, genre, etc. from
meda.<filetype> collections/<collection name>/medium_artwork/<filetype> Overwrites the path used to pull medium artwork from
media.system_artwork collections/<collection name>/system_artwork Overwrites the path used to pull system artwork from
ignoreDefaultLayout false (CoinOPS) Collection menu to use current "collection layout" and not load default layout.xml if the selected collection doesn't have a "collection layout"
firstPlaylist, autoPlaylist, attractModeCyclePlaylist, cyclePlaylist, attractModeSkipPlaylist (CoinOPS) These settings used to be in global, but can be overwritten by collection settings now
layout name of theme in the layouts/ from which to find layout/resources for collection (CoinOPS) This "layout" that overides global setting, so different themes can be loaded under one collection menu

All the settings above can take advantage of the following variables:

Variable Description
%BASE_MEDIA_PATH% The root directory where all artwork resides, defined by baseMediaPath in the global settings.conf file
%BASE_ITEM_PATH% The root directory where all roms resides, defined by baseMediaPath in the global settings.conf file
%ITEM_COLLECTION_NAME% The name of the current collection
⚠️ **GitHub.com Fallback** ⚠️