User Tools

Site Tools


global_settings.conf

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
global_settings.conf [2017/05/13 10:44]
phulshof
global_settings.conf [2020/09/24 13:01]
phulshof
Line 1: Line 1:
 ====== Global settings.conf ====== ====== Global settings.conf ======
  
-The global settings.conf file defines how your overall system operates. +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.
-See below for a list of configuration parameters that can be specified for your global settings.conf.+
  
 ^  Variable ​             ^  Allowed values ​                 ^  Description ​ ^ ^  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 ​ | ^ fullscreen ​            ​| ​ yes, true, no, false            | Run the front-end in fullscreen ​ |
 ^ horizontal ​            ​| ​ stretch, #​pixels ​               | Screen pixel width (i.e. 1920)  | ^ horizontal ​            ​| ​ stretch, #​pixels ​               | Screen pixel width (i.e. 1920)  |
 ^ vertical ​              ​| ​ stretch, #​pixels ​               | Screen pixel height (i.e. 1080)  | ^ 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!  |
 ^ layout ​                ​| ​ a folder name in /​layouts ​      | The layout/​theme to use for RetroFE (i.e. Aeon Nox)  | ^ layout ​                ​| ​ a folder name in /​layouts ​      | The layout/​theme to use for RetroFE (i.e. Aeon Nox)  |
 +^ 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 ​ | ^ 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 ()  | ^ showParenthesis ​       |  yes, true, no, false            | Hide item/ROM information between ()  |
Line 17: Line 22:
 ^ exitOnFirstPageBack ​   |  yes, true, no, false            | Exit the frontend when the back button is pressed on the first page  | ^ exitOnFirstPageBack ​   |  yes, true, no, false            | Exit the frontend when the back button is pressed on the first page  |
 ^ 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  | ^ 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. |
 +^ 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. |
 ^ rememberMenu ​          ​| ​ yes, true, no, false            | Remember the last highlighted menu item if re-entering a menu  | ^ rememberMenu ​          ​| ​ yes, true, no, false            | Remember the last highlighted menu item if re-entering a menu  |
-autoFavorites ​         ​|  ​yes, true, no, false            ​| Automatically switch to the Favorites ​playlist if it is available ​ |+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.  | ^ 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 ​ | ^ collectionInputClear ​  ​| ​ yes, true, no, false            | Clear the input queue when entering/​exiting a collection ​ |
 +^ 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. ​ | ^ 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. ​ | ^ 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 ​ |
  
 +In order to make scripted reconfiguration easier, RetroFE supports the filenames settings1.conf,​ settings2.conf,​ ..., settings9.conf as well.
global_settings.conf.txt · Last modified: 2020/09/24 13:01 by phulshof