Global Settings - CoinOPS-Official/RetroFE GitHub Wiki
The global settings.conf file, located in your RetroFE directory, defines how your overall system operates. See below for a list of configuration parameters that can be specified for your global settings.conf.
| Variable | Allowed values | Description |
|---|---|---|
| numScreens | 1+ | Defines the number of monitors used. Defaults to 1. |
| fullscreen | yes, true, no, false | Run the front-end in fullscreen |
| horizontal | stretch, #pixels | Screen pixel width (i.e. 1920) |
| vertical | stretch, #pixels | Screen pixel height (i.e. 1080) |
| fullscreenx | yes, true, no, false | Run the front-end in fullscreen on monitor x, e.g. fullscreen0 = no. Monitor numbers start at 0! |
| horizontalx | stretch, #pixels | Screen pixel width (i.e. 1920) for monitor x, e.g. horizontal0 = 1920. Monitor numbers start at 0! |
| verticalx | stretch, #pixels | Screen pixel height (i.e. 1080) for monitor x, e.g. vertical0 = 1080. Monitor numbers start at 0! |
| screenNumx | 0+ | Screen numbers start at 0! |
| rotationx | 0, 1, 2, 3 | Rotation for monitor x (in 90 degree angles), e.g. rotation0 = 1 will rotate the screen for monitor 0 by 90 degrees. |
| mirrorx | yes, true, no, false | Mirror mode for monitor x, e.g. mirror0 will set mirror mode for monitor 0. This will divide the screen into two halves, and display the same images in each half in a mirrored fashion. |
| layout | a folder name in /layouts | The layout/theme to use for RetroFE (i.e. Aeon Nox) |
| windowBorder | yes, true, no, false | Show window border |
| windowResize | yes, true, no, false | Allow window to be resized |
| fps | frames per second (positive) | Requested FPS while not in the idle state. Defaults to 60. |
| fpsIdle | frames per second (positive) | Requested FPS while in the idle state. Defaults to 60. |
| hideMouse | yes, true, no, false | Hide the mouse cursor on the screen when the FE is active |
| showParenthesis | yes, true, no, false | Hide item/ROM information between () |
| showSquareBrackets | yes, true, no, false | Hide item/ROM information between [] |
| firstCollection | a folder name in /collections | Specify the name of the first collection to load on start (i.e. Main) |
| videoEnable | yes, true, no, false | Enable video display |
| videoLoop | #loops | Number of times to loop video playback (enter 0 to continuously loop) |
| exitOnFirstPageBack | yes, true, no, false | Exit the frontend when the back button is pressed on the first page |
| attractModeCyclePlaylist | yes, true, no, false | Select between cycling through the full set of playlists or the ones defined in the cyclePlaylist |
| attractModeTime | time (in seconds) | Enter 0 to disable attract mode, otherwise enter the number of seconds to wait before the menu scrolls to another random point |
| attractModeNextTime | time (in seconds) | Enter the number of seconds before the menu scrolls to another random point while already in attract mode |
| attractModePlaylistTime | time (in seconds) | Enter the number of seconds before the menu switches to the next playlist. Enter 0 to disable (default). |
| attractModeSkipPlaylist | playlist name | Skip this playlist while switching playlist in attract mode. (CoinOPS) comma seperated |
| attractModeCollectionTime | time (in seconds) | Enter the number of seconds before the menu switches to the next collection. Enter 0 to disable (default). |
| attractModeSkipCollection | playlist name | Skip this collection while switching collections in attract mode. |
| attractModeMinTime | time (in ms) | Minimum time attract mode will scroll (default 0 ms) |
| attractModeMaxTime | time (in ms) | Maximum time attract mode will scroll (default 5000 ms) |
| rememberMenu | yes, true, no, false | Remember the last highlighted menu item if re-entering a menu |
| firstPlaylist | playlist name | Automatically switch to this playlist if it is available, often set to favorites. Replaces the autoFavorites parameter. |
| lastplayedSize | size (natural) | Size of the automatically generated lastplayed playlist. A size of 0 disabled this feature. |
| lastPlayedSkipCollection | collection name | Name of the collection not included in the lastplayed playlist. Generally used to exclude items from a settings collection. |
| cyclePlaylist | playlist set | Comma separated set of playlists that the playlist cycle keys cycle through. |
| minimize_on_focus_loss | yes, true, no, false | Overwrite system SDL default for SDL_VIDEO_MINIMIZE_ON_FOCUS_LOSS to force RetroFE to (not) minimize when the focus on the full-screen window is lost. |
| collectionInputClear | yes, true, no, false | Clear the input queue when entering/exiting a collection |
| playlistInputClear | yes, true, no, false | Clear the input queue when changing playlist |
| jumpInputClear | yes, true, no, false | Clear the input queue when jumping through the menu |
| enterOnCollection | yes, true, no, false | Enter the collection when using collectionUp/Down controls |
| startCollectionEnter | yes, true, no, false | Enter the first collection RetroFE boot |
| baseMediaPath | i.e.(d:/media) | Override if you choose to have your media stored outside of RetroFE. Can be used by your Collection Settings.conf. |
| baseItemPath | i.e.(d:/roms) | Override if you choose to have your roms stored outside of RetroFE. Can be used by your Collection Settings.conf. |
| unloadSDL | yes, true, no, false | Close SDL when starting a game. This is needed for some systems like RetroPie to prevent the emulator from being launched behind the front-end. |
| overwriteXML | yes, true, no, false | Allow information files (collections/<collection name>/info/<item name>.conf) to overwrite information from meta.db |
| subsSplit | yes, true, no, false | Split merged collections based on .sub files per .sub file (yes/true) or sort them as one list (no/false) |
| cfwLetterSub | yes, true, no, false | If subs exist in a collection, jump those subs by sub in stead of by letter (CoinOPS feature) |
| prevLetterSubToCurrent | yes, true, no, false | When using previous letter control, it will jump to the start of the current letter in stead of the start of the previous one |
| lastPlayedSkipCollection | collection name | Do not include items from this collection in the lastplayed playlist |
| LEDBlinkyDirectory | LEDBlinky installation directory | Setting this directory will enable LEDBlinky support |
| disableVideoRestart | yes, true, no, false | (CoinOPS) Disable for all where layouts use "restart" on selected video in layouts, for performance improvement |
| cycleCollection | csv of collections with their own layouts | (CoinOPS) able to cycle through different collection layouts and themes using buttons |
| firstCollection | collection name | (CoinOPS) Name of first collection to start on within cycle |
| controllerComboExit | yes, true, no, false | (CoinOPS) joyButton6/7 (start/select) will quit |
| randomLayout | csv of layout names | (CoinOPS) Will randomly choose a layout to launch with |
| kiosk | yes, true, no, false | (CoinOPS) Start on first playlist with navigation locked, also can't edit Favorite toggles. Able to use kiosk button to toggle this setting |
| globalFavLast | yes, true, no, false | (CoinOPS) Saving last played and favorites to a new favorites collection so all collections will write there and you can style it differently to support all collection types |
| log | log=ERROR,INFO,NOTICE,WARNING,DEBUG //any combo, log=ERROR //just error, log=ALL //subtractive log=ALL,-INFO | (CoinOPS) filter log messages |
| infoExitOnScroll | yes, true, no, false | (CoinOPS) to call on*InfoExit to hide info boxes if open when scrolling |
| animateDuringGame | default=true yes, true, no, false | (CoinOPS) stop marquee animation on game launch just incase for cpu sensitive games |
| randomStart | yes, true, no, false | (CoinOPS) Randomly select a game upon start of retrofe |
| In order to make scripted reconfiguration easier, RetroFE supports the filenames settings1.conf, settings2.conf, ..., settings9.conf as well. | ||
| settingsCollectionPlaylist | collection:playlist | (CoinOPS) used by toggle settings control to go to collection/playlist and if not set then will default to a playlist in the current collection called 'settings' |
| HardwareVideoAccel | yes, true, no, false | (CoinOPS) default false; enables gstreamer hardware video decoding |
| AvdecMaxThreads | (CoinOPS) default 2; cooresponds to this reference only for software decode | |
| MuteVideo | yes, true, no, false | (CoinOPS) default false; global mute of all videos (useful for music background) |
| SDLRenderDriver | direct3d, direct3d11, direct3d12, opengl, opengles2, opengles, metal, and software | (CoinOPS) default direct3d; different rendering methods that might improve performance |
| ScaleQuality | (CoinOPS) default 1; Improve scale quality. Continuing with low-quality settings 1 = linear. 0 = nearest, 2 = best (linear) reference | |
| highPriority | yes, true, no, false | (CoinOPS) default false; increases windows process priority of retrofe to ABOVE_NORMAL_PRIORITY_CLASS |
| attractModeFast | yes, true, no, false | (CoinOPS) default false; upon attract mode it doesn't scroll fast to next one, it nicely scrolls to next so you can see the other art |
| disablePauseOnScroll | yes, true, no, false | (CoinOPS) default false; pauses videos while scrolling for performance improvement |
| disableVideoRestart | yes, true, no, false | (CoinOPS) default false; setting to disable all layout setting video restart, used to restart video when selected; disabling for performance improvement |