recalbox.conf 9.34 KB
Newer Older
1 2 3 4
# System Variable
# You can configure your recalbox from here
# To set a variable, remove the first ; on the line

5 6


7
# ------------ A - System Options ----------- #
8 9 10 11 12 13
## Splash screen duration
## 0: Video will be played for 20 seconds (default)
## -1: All the video will be played (it won't be stopped automatically)
## >0 : Time before the video will be stopped (in seconds)
system.splash.length=0

14 15
## Recalbox Manager (http manager)
system.manager.enabled=1
Michael Baudino's avatar
Michael Baudino committed
16
## Currently, only version 2 is available
17
system.manager.version=2
18 19 20

## Recalbox security
# enforce security
21 22
# samba password required
# disable virtual gamepads
23 24 25 26 27
system.security.enabled=0

## Recalbox API (REST)
system.api.enabled=0

28 29 30 31 32
## EmulationStation
### menu style
### default -> default all options menu
### none -> no menu except the game search menu
### bartop -> less menu, only needed for bartops
33
emulationstation.menu=default
34
### Select a system to show on boot (use rom directory name) (string)
35
emulationstation.selectedsystem=favorites
36
### Show the gamelist of the first or selected system on boot (0,1)
37
emulationstation.bootongamelist=0
38
### Disable system view. ES will boot and show ONLY the first or selected system (0,1)
39
emulationstation.hidesystemview=0
40
### Parse Gamelists only. Show only games listed in gamelist.xml files (0,1)
41
emulationstation.gamelistonly=0
42 43
### Force basicgameList view to be displayed, even if your game systems are scraped (0,1)
emulationstation.forcebasicgamelistview=0
44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62

## Emulator special keys
## default -> default all special keys
## nomenu -> cannot popup the emulator menu
## none -> no special keys in emulators
system.emulators.specialkeys=default

## Show or hide kodi in emulationstation (0,1)
kodi.enabled=1
## Start kodi at launch (0,1)
kodi.atstartup=0
## set x button shortcut (0,1)
kodi.xbutton=1

## Kodi can wait for a network component before starting
## waithost is the ip or hostname that must answer to a ping to validate the availability
## waittime is the maximum time waited when kodi boots
## if waitmode is required, kodi will not start if the component is not available
## if waitmode is wish, kodi will start if the component is not available
63
## if waitmode is not set or has another value, kodi will start immediately
64 65 66 67 68 69 70 71 72
;kodi.network.waitmode=required
;kodi.network.waittime=10
;kodi.network.waithost=192.168.0.50

# ------------ B - Network ------------ #
## Set system hostname
system.hostname=RECALBOX
## Activate wifi (0,1)
wifi.enabled=0
73
## Set wifi region
74
## More info here: https://github.com/recalbox/recalbox-os/wiki/Wifi-country-code-(EN)
75
wifi.region=US
76 77 78 79 80
## Wifi SSID (string)
;wifi.ssid=new ssid
## Wifi KEY (string)
## after rebooting the recalbox, the "new key" is replace by a hidden value "enc:xxxxx"
## you can edit the "enc:xxxxx" value to replace by a clear value, it will be updated again at the following reboot
81
## Escape your special chars (# ; $) with a backslash : $ => \$
82 83
;wifi.key=new key

84 85 86 87 88 89 90 91
## Wifi - static IP
## if you want a static IP address, you must set all 3 values (ip, gateway, and netmask)
## if any value is missing or all lines are commented out, it will fall back to the
## default of DHCP
;wifi.ip=manual ip address
;wifi.gateway=new gateway
;wifi.netmask=new netmask

92 93 94
# secondary wifi (not configurable via the user interface)
;wifi2.ssid=new ssid
;wifi2.key=new key
95 96 97 98
# defaults to dhcp. uncomment for static ip
;wifi2.ip=manual ip address
;wifi2.gateway=new gateway
;wifi2.netmask=new netmask
99 100 101 102

# third wifi (not configurable via the user interface)
;wifi3.ssid=new ssid
;wifi3.key=new key
103 104 105 106
# defaults to dhcp. uncomment for static ip
;wifi3.ip=manual ip address
;wifi3.gateway=new gateway
;wifi3.netmask=new netmask
107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133

## Samba share
system.samba.enabled=1
### Virtual Gamepads
system.virtual-gamepads.enabled=1
### SSH
system.ssh.enabled=1

# ------------ C - Audio ------------ #
## Set the audio device (auto, hdmi, jack)
audio.device=auto
## Set system volume (0..100)
audio.volume=90
## Enable or disable system sounds in ES (0,1)
audio.bgmusic=1



# -------------- D - Controllers ----------------- #
# Enable support for standard bluetooth controllers
controllers.bluetooth.enabled=1


## Please enable only one of these
# -------------- D1 - PS3 Controllers ------------ #
##Enable PS3 controllers support
controllers.ps3.enabled=1
134 135 136 137 138
## Choose a driver between bluez, official and shanwan
## bluez -> bluez 5 + kernel drivers, support official and shanwan sisaxis
## official -> sixad drivers, support official and gasia sisaxis
## shanwan -> shanwan drivers, support official and shanwan sisaxis
controllers.ps3.driver=bluez
139 140


141
# ------------ D2 - GPIO Controllers ------------ #
142 143 144 145 146 147 148 149 150 151 152 153 154 155
## GPIO Controllers
## enable controllers on GPIO with mk_arcarde_joystick_rpi (0,1)
controllers.gpio.enabled=0
## mk_gpio arguments, map=1 for one controller, map=1,2 for 2 (map=1,map=1,2)
controllers.gpio.args=map=1,2


## DB9 Controllers
## Enable DB9 drivers for atari, megadrive, amiga controllers (0,1)
controllers.db9.enabled=0
## db9 arguments
controllers.db9.args=map=1

## Gamecon controllers
156
## Enable gamecon controllers, for nes, snes, psx (0,1) 
157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179
controllers.gamecon.enabled=0
## gamecon_args
controllers.gamecon.args=map=1

## XGaming's XArcade Tankstik and other compatible devices
controllers.xarcade.enabled=1



# ------------ F - Language and keyboard ------------ #
## Set the language of the system (fr_FR,en_US,en_GB,de_DE,pt_BR,es_ES,it_IT,eu_ES,tr_TR,zh_CN)
system.language=en_US
## set the keyboard layout (fr,en,de,us,es)
;system.kblayout=us
## Set you local time
## Select your timezone from : ls /usr/share/zoneinfo/ (string)
;system.timezone=Europe/Paris



# ------------ G - UPDATES ------------ #
## Automatically check for updates at start (0,1)
updates.enabled=1
digitalLumberjack's avatar
digitalLumberjack committed
180
# Update type : default to stable
181 182 183 184
updates.type=stable


# ------------ H - HERE IT IS - GLOBAL EMULATOR CONFIGURATION ------------ #
185 186
## The global value will be used for all emulators, except if the value
## is redefined in the emulator
187 188

## Set game resolution for emulators
189 190
## Please don't modify this setting
## This arch does not support the video mode switch
191 192 193 194 195 196 197 198
## (string)
global.videomode=CEA 1 HDMI

## Shader set 
## Automatically select shaders for all systems
## (none, retro, scanlines)
global.shaderset=none

199 200 201
## Once enabled, your screen will be cropped, and you will have a pixel perfect image (0,1)
global.integerscale=0

202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218
## Set gpslp shader for all emulators (prefer shadersets above). Absolute path (string)
global.shaders=

## Set ratio for all emulators (auto,4/3,16/9,16/10,custom)
global.ratio=auto

## Set smooth for all emulators (0,1)
global.smooth=1

## Set rewind for all emulators (0,1)
global.rewind=1

## Set autosave/load savestate for all emulators (0,1)
global.autosave=0

## Enable retroarchievements (0,1)
## Set your www.retroachievements.org username/password
219
## Escape your special chars (# ; $) with a backslash : $ => \$
220 221 222 223 224 225 226 227 228 229 230 231
global.retroachievements=0
global.retroachievements.hardcore=0
global.retroachievements.username=
global.retroachievements.password=

## Set retroarch input driver (auto, udev, sdl2)
## If you don't have issues with your controllers, let auto
global.inputdriver=auto

## If you do not want recalboxOS to generate the configuration for all emulators (string)
;global.configfile=/path/to/my/configfile.cfg

232 233
## Demo screensaver parameters
## Set the system list from which ES will run random games
234 235
## Empty list or unexisting key means all available systems
global.demo.systemlist=3do,amigacd32,atari2600,atari5200,atari7800,daphne,fba_libretro,fds,gamegear,gba,lynx,mame,mastersystem,megadrive,neogeo,nes,ngpc,pcengine,sega32x,sg1000,snes
236 237
## Default demo game sessions last 90s. Change this value if you want shorter or longer sessions
;global.demo.duration=90
238 239 240
## Default game info screen duration lasts 6s. Change this value if you want shorter or longer info screens.
;global.demo.infoscreenduration=6

241

242
# ------------ I - EMULATORS CHOICES ----------- #
243
## You can override the global configurations here
244
## Here is the snes example
245
;snes.core=snes9x2010
246 247 248 249 250 251
;snes.shaders=/recalbox/share/shaders/shaders_glsl/mysnesshader.gplsp
;snes.ratio=16/9
;snes.smooth=0
;snes.rewind=1
;snes.autosave=0
;snes.emulator=libretro
252
;snes.integerscale=0
253
## If you do not want recalboxOS to generate the configuration for the emulator: 
254 255 256
;snes.configfile=/path/to/my/configfile.cfg

## Default cores for x86
257
snes.core=snes9x2010
258
n64.core=glide64mk2
259
psx.core=mednafen_psx_hw
260 261 262 263

## NeoGeo emulator 
## You can use pifba or a libretro core (fba2x,libretro)
neogeo.emulator=libretro
264 265
## If you set libretro as neogeo.emulator, the line below sets the retroarch core (fbneo, mame2000)
neogeo.core=fbneo
266

267 268
## Wiimotes
## Real wiimotes must not be paired with recalbox system so that they can work with the wii emulator
269 270 271
## set emulatedwiimotes to 1 to emulate wiimotes with standard pads
wii.emulatedwiimotes=0

272 273 274 275 276 277 278
## Demo screensaver parameters
## Include or exclude a particular system from the demo screensaver
## You may change the global.demo.systemlist key or include/exclude every single system
;snes.demo.include=0
## Set the session duration for a particular system
;snes.demo.duration=90

Subs's avatar
Subs committed
279
# ------------ J - NETPLAY PARAMETERS ----------- #
280
## All these values are handled by Recalbox itself
Subs's avatar
Subs committed
281 282 283 284 285 286 287
global.netplay=1
global.netplay.nickname=
global.netplay.port=55435
global.netplay.relay=
global.netplay.systems=fba_libretro,mame,mastersystem,megadrive,neogeo,nes,pcengine,sega32x,sg1000,snes,supergrafx
global.netplay.lobby=http://lobby.libretro.com/list/

288
## Configurations generated by Recalbox