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 |