Skip to content

recalbox.conf (DE)

rockaddicted edited this page Dec 20, 2017 · 11 revisions

Einleitung

Deine Recalbox verfügt über ein fortgeschrittenes Konfigurationswerkzeug namens recalbox.conf, mit dem Du einige Optionen, die in EmulationStation nicht verfügbar sind, ändern kannst.

Du kannst diese Datei bearbeiten, indem Du eine der unten angegebenen Möglichkeiten nutzt:

  • Die einfachste Methode ist über den Webmanager. Den Webmanager erreicht man wie folgt:
    Windows Nutzer: http://recalbox/ oder die IP Adresse eingeben.
    Linux/Mac Nutzer: http://recalbox.local/ oder die IP Adresse eingeben.
    Anschließend auf recalbox.conf drücken.
  • Benutze die im Netzwerk freigegebenen Ordner von Recalbox. Die Datei befindet sich im Verzeichnis system dieses beinhaltet recalbox.conf
  • Du kannst Dich als root Benutzer verbinden und die Datei im System in /recalbox/share/system/recalbox.conf bearbeiten

Windows Benutzer : Falls du nicht über den Webmanager gehst, musst du ein richtiges Textbearbeitungs-Programm benutzen, wie z.B. NotePad++. Der Standard Windows Text Editor würde ungültige Zeichen in die Datei einfügen.

Das ; bei Zeilenbeginn bedeutet, dass diese Zeile deaktiviert ist. Lösche ; um die Zeile zu aktivieren.

I - Verfügbare Einstellungen

  • A - Systemoptionen

    • Lege einen An-/Aus-Schalter fest
    • Aktiviere/deaktiviere fbcp (Framebuffer für TFT-Monitore an gpio/spi)
    • Aktiviere/deaktiviere den Autostart des Recalbox-Managers
    • Lege die Recalbox-Manager Version fest
    • Aktiviere/deaktiviere den Sicherheitsmodus
    • Lege den Videomodus von EmulationStation fest
    • Lege die Menüart von EmulationStation fest
    • Lege Start-/Anzeigeoptionen von EmulationStation fest
    • Lege Spezialknöpfe für Emulatoren fest (special keys)
    • Verstecke Kodi in EmulationStation
    • Starte Kodi beim Systemstart
    • Deaktiviere das Starten von Kodi mit dem x Knopf
    • Lege den Videomodus von Kodi fest
    • Lege die Kodi Netzwerkverzögerung fest (network delay)
  • B - Netzwerk

    • Lege Netzwerknamen Deiner Recalbox fest
    • Lege WLAN (SSID) und Passwort (Schlüssel) fest
    • Lege bis zu 3 verschiedene WLAN-Netzwerke fest (das System nutzt das erste, das funktioniert)
    • Aktiviere/deaktiviere samba
    • Aktiviere/deaktiviere virtual-gamepads
    • Aktiviere/deaktiviere ssh
  • C - Audio

    • Ausgabegerät einstellen
    • Lautstärke einstellen
    • Aktivieren/deaktivieren der Hintergrundmusik in ES
  • D - Controller

    • Aktiviere Bluetooth Controller
    • PS3 Treiber auswählen
    • Aktivieren/deaktivieren von Controllern über gpio
    • Aktivieren/deaktivieren von Controllern über DB9
    • Aktivieren/deaktivieren von Controllern über gamecon
    • Aktivieren/deaktivieren von xarcade Controllern
  • F - Sprache und Tastatur

    • Sprache einstellen
    • Tastaturlayout einstellen
    • Zeitzone einstellen
  • G - Aktualisierungen

    • Aktivieren/deaktivieren der Aktualisierungsprüfung
    • Typ der Aktualisierung einstellen
  • H - Emulatoreinstellungen - unten ausführlich beschrieben

II - Emulatoreinstellungen

1 - Globale Einstellungen

Du kannst Emulatoren in recalbox.conf feintunen. Die globalen Einstellungen überschreiben die aller Emulatoren.

Verfügbare Variablen :

  • videomode : Lege den Videomodus fest (Nutze tvservice, um kompatible Werte zu erfahren). Wähle default, um das Umschalten des Videomodus' zu deaktivieren (für Röhrenbildschirme)
    Beispiel : global.videomode=CEA 4 HDMI
  • shaderset : Wähle ein Shader-Set für alle Emulatoren (none, retro, scanlines) siehe Shader konfigurieren
    Beispiel : global.shaderset=retro
  • integerscale : Aktiviere integerscale (ganzzahlige Skalierung) "pixel perfect" in Spielen
    Beispiel : global.integerscale=0
  • shaders : Lege einen absoluten Pfad zu einem Shader oder Shaderpreset (glsl or glslp) fest
    Beispiel : global.shaders=/recalbox/share_init/shaders/scanline.glslp
  • ratio : Lege das Seitenverhältnis (16/9, 4/3, 16/10, auto or custom) für Spiele fest
    Beispiel : global.ratio=16/9
  • smooth : Glättungsfilter für Spiele
    Beispiel : global.smooth=0
  • rewind : Zurückspulen in Spielen aktivieren (kann Emulatoren verlangsamen)
    Beispiel : global.rewind=1
  • autosave : Aktiviere automatisches Speichern/Laden von Savestates während dem Starten/Beenden von Spielen
    Beispiel : global.autosave=0
  • retroachievements : Aktiviere retroachievements in Spielen
    Beispiel : global.retroachievements=0
  • retroachievements hardcore mode : Aktiviere den hardcore Modus von retroachievements in Spielen (deaktiviert Zurückspulen and Savestates)
    Beispiel : global.retroachievements.hardcore=0
  • retroachievements username : Lege deinen retroachievements Nutzernamen fest
    Beispiel : global.retroachievements.username=
  • retroachievements password : Lege dein retroachievements Passwort fest
    Beispiel : global.retroachievements.password=
  • inputdriver : Erzwinge Eingabetreiber für retroarch (auto, sdl2, udev)
    Beispiel : global.inputdriver=auto

Die Standardkonfiguration :

global.videomode=CEA 4 HDMI
global.shaderset=none
global.integerscale=0
global.shaders=
global.ratio=auto
global.smooth=1
global.rewind=1
global.autosave=0
global.retroachievements=0
global.retroachievements.hardcore=0
global.retroachievements.username=
global.retroachievements.password=
global.inputdriver=auto

Wenn Du Glättung (smoothing) für alle Emulatoren aktivieren möchtest, wähle global.smooth=1. Wenn Du den Scanline-Shader für alle Emulatoren hinzufügen möchtest, wähle global.shaders=/recalbox/share_init/shaders/scanline.glslp.

2 - Konfiguration einzelner Emulatoren

Jeder Emulator kann hier einzeln konfiguriert werden. Nutze einfach den Namen des Systems und setze die Variablen.

Verfügbare Systeme:

snes , nes , n64 , gba , gb , gbc , fds , gamecube , wii , virtualboy , sg1000 , mastersystem , megadrive , gamegear , sega32x , segacd , dreamcast , neogeo , mame , fba , fba_libretro , ngp , ngpc , gw , vectrex , lynx , lutro , wswan , wswanc , pcengine , pcenginecd , supergrafx , atari2600 , atari7800 , atarist , apple2 , amstradcpc , c64 , colecovision , msx , msx1 , msx2 , dos , scummvm , o2em , zxspectrum , zx81 , prboom , cavestory , psx , psp , moonlight

Verfügbare libretro cores :

  • snes : pocketsnes - snes9x_next - catsfc - snes9x
  • nes / fds : fceumm - fceunext - nestopia
  • n64 : mupen64plus - glupen64
  • gamecube / wii : dolphin
  • gb / gbc : gambatte - tgbdual
  • gba : gpsp - mgba - meteor
  • virtualboy : vb
  • megadrive / mastersystem / gamegear / sega32x / segacd / sg1000 : genesisplusgx - picodrive
  • dreamcast : reicast
  • neogeo : imame4all - mame2003 - mame2010 - fba
  • mame : imame4all - mame2003 - mame2010
  • fba_libretro : fba
  • ngp / ngpc : mednafen_ngp
  • gw : gw
  • vectrex : vecx
  • lynx : mednafen_lynx
  • lutro : lutro
  • wswan / wswanc : mednafen_wswan
  • pcengine / pcenginecd /supergrafx : mednafen_supergrafx - pce
  • atari2600 : stella
  • atari7800 : prosystem
  • atarist : hatari
  • c64 : vice
  • amstradcpc : cap32
  • apple2 : lineapple
  • zx81 : zx81
  • zxspectrum : fuse
  • o2em : o2em
  • colecovision : bluemsx
  • dos : dosbox
  • scummvm : scummvm
  • msx / msx1 / msx2: bluemsx - fmsx
  • prboom : prboom
  • psx : pcsx_rearmed
  • psp : ppsspp
  • cavestory : nxengine
  • moonlight : moonlight

Verfügbare Variablen :

  • retroachievements : Aktiviere retroachievements in Spielen
    Beispiel : global.retroachievements=0

  • retroachievements hardcore mode : Aktiviere den hardcore Modus von retroachievements in Spielen (deaktiviert Zurückspulen and Savestates)
    Beispiel : global.retroachievements.hardcore=0

  • retroachievements username : Lege Deinen retroachievements Nutzernamen fest
    Beispiel : global.retroachievements.username=

  • retroachievements password : Lege Dein retroachievements Passwort fest
    Beispiel : global.retroachievements.password=

  • inputdriver : Erzwinge Eingabetreiber für retroarch (auto, sdl2, udev)
    Beispiel : global.inputdriver=auto

  • videomode : Lege den Videomodus fest (Nutze tvservice um kompatible Werte zu erfahren).
    Beispiel : snes.videomode=CEA 4 HDMI

  • integerscale : Aktiviere integerscale (ganzzahlige Skalierung) "pixel perfect" in Spielen
    Beispiel : snes.integerscale=0

  • shaders : Lege einen absoluten Pfad zu einem Shader oder Shaderpreset (glsl or glslp) fest
    Beispiel : snes.shaders=/recalbox/share_init/shaders/scanline.glslp

  • ratio : Lege das Seitenverhältnis (16/9, 4/3, 16/10, auto or custom) für Spiele fest
    Beispiel : snes.ratio=4/3

  • smooth : Glättungsfilter für Spiele
    Beispiel : snes.smooth=0

  • rewind : Zurückspulen in Spielen aktivieren (kann Emulatoren verlangsamen)
    Beispiel : snes.rewind=1

  • autosave : Aktiviere automatisches Speichern/Laden von Savestates während dem Starten/Beenden von Spielen
    Beispiel : snes.autosave=0

  • core : Wähle den Core für die Emulation (die libretro-Cores liegen in /usr/lib/libretro)
    Beispiel : snes.core=snes9x_next

  • emulator : Wähle den Emulator für die Emulation (Emulatoren sind retroarch, fba2x, mupen64)
    Beispiel : neogeo.emulator=fba2x

  • configfile : Erzwinge, dass Deine eigene Konfigurationsdatei geladen wird. Recalbox wird die Konfiguration des Emulators dann nicht automatisch vornehmen.
    Beispiel : snes.configfile=/path/to/my/configfile.cfg

III - Die standardmäßige recalbox.conf für rpi3

# System Variable
# You can configure your recalbox from here
# To set a variable, remove the first ; on the line



# ------------ A - System Options ----------- #
#    Uncomment the system.power.switch you use
;system.power.switch=ATX_RASPI_R2_6      # http://lowpowerlab.com/atxraspi/#installation
;system.power.switch=MAUSBERRY           # http://mausberry-circuits.myshopify.com/pages/setup
;system.power.switch=REMOTEPIBOARD_2003  # http://www.msldigital.com/pages/support-for-remotepi-board-2013
;system.power.switch=REMOTEPIBOARD_2005  # http://www.msldigital.com/pages/support-for-remotepi-board-plus-2015
;system.power.switch=WITTYPI             # http://www.uugear.com/witty-pi-realtime-clock-power-management-for-raspberry-pi
;system.power.switch=PIN56ONOFF          # https://github.com/recalbox/recalbox-os/wiki/Add-a-start-stop-button-to-your-recalbox-(EN)
;system.power.switch=PIN56PUSH           # https://github.com/recalbox/recalbox-os/wiki/Add-a-start-stop-button-to-your-recalbox-(EN)
;system.power.switch=PIN356ONOFFRESET    # https://github.com/recalbox/recalbox-os/wiki/Add-a-start-stop-button-to-your-recalbox-(EN)
;system.power.switch=PIN356PUSHRESET     # https://github.com/recalbox/recalbox-os/wiki/Add-a-start-stop-button-to-your-recalbox-(EN)

## fbcp FrameBuffer Copy Program
## For small TFT screen on GPIO and SPI
## See https://github.com/recalbox/recalbox-os/wiki/Utility---Use-of-fbcp-for-small-TFT-screen-%28EN%29 for details
## Needed for Waveshare 3.2" 3.5" TFT screen, 2.8" Adafruit screen
## See https://github.com/recalbox/recalbox-os/wiki/TFT-Screen-SPI-Bus-%28EN%29
## for support and configuration details needed by /boot/config.txt
system.fbcp.enabled=0

## Recalbox Manager (http manager)
system.manager.enabled=1
## 1 or 2, depending on the manager version you wish
system.manager.version=2

## Recalbox security
# enforce security
#   samba password required
#   disable virtual gamepads
system.security.enabled=0

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

## Allow a specific resolution for ES only from the command : tvservice -m [MODE]
## Leave commented for the default usual behaviour
;system.es.videomode=CEA 4 HDMI

## EmulationStation
### menu style
### default -> default all options menu
### none -> no menu except the game search menu
### bartop -> less menu, only needed for bartops
emulationstation.menu=default
### Select a system to show on boot (use rom directory name) (string)
emulationstation.selectedsystem=favorites
### Show the gamelist of the first or selected system on boot (0,1)
emulationstation.bootongamelist=0
### Disable system view ES will boot and show ONLY the first or selected system (0,1)
emulationstation.hidesystemview=0
### Parse Gamelists only. Show only games listed in gamelist.xml files (0,1)
emulationstation.gamelistonly=0
### Force basicgameList view to be displayed, even if your game systems are scraped (0,1)
emulationstation.forcebasicgamelistview=0

## 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

## Allow a specific resolution for Kodi only from the command : tvservice -m [MODE]
## By default is using the default resolution of your screen
kodi.videomode=default

## 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
## if waitmode is not set or has another value, kodi will start immediately
;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
## 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
## Escape your special chars (# ; $) with a backslash : $ => \$
;wifi.key=new key

# secondary wifi (not configurable via the user interface)
;wifi2.ssid=new ssid
;wifi2.key=new key

# third wifi (not configurable via the user interface)
;wifi3.ssid=new ssid
;wifi3.key=new key

## 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
## 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


# ------------ D2 - GPIO Controllers ------------ #
## 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
## Enable gamecon controllers, for nes, snes psx (0,1) 
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
# Update type : default to stable
updates.type=stable


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

## Set game resolution for emulators
## select your mode from the command : tvservice -m [MODE]
## CEA 5 HDMI : 1920x1080 @ 60Hz 16:9, clock:74MHz interlaced 
## CEA 4 HDMI : 1280x720 @ 60Hz 16:9, clock:74MHz progressive
## use 'default' for using the default resolution
## (string)
global.videomode=CEA 4 HDMI

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

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

## 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
## Escape your special chars (# ; $) with a backslash : $ => \$
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

# ------------ I - EMULATORS CHOICES ----------- #
## You can override the global configuration here
## Here is the snes example
;snes.videomode=CEA 4 HDMI
;snes.core=snes9x_next
;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
;snes.integerscale=0
## If you do not want recalboxOS to generate the configuration for the emulator : 
;snes.configfile=/path/to/my/configfile.cfg

## Default cores for RPi3
snes.core=snes9x_next
gba.core=mgba
mame.core=mame078
nes.core=fceunext

## NeoGeo emulator 
## You can use pifba or a libretro core (fba2x,libretro)
neogeo.emulator=libretro
## If you set libretro as neogeo.emulator, the line below sets the retroarch core (fba,imame4all)
neogeo.core=fba

## N64 emulator is configured to display a screen with a 640x480 resolution (native n64 resolution)
## So you must use one of these video modes (DMT 4 HDMI,CEA 1 HDMI).
## If your screen is not compatible with one of these video modes, please check the recalbox's wiki.
n64.videomode=DMT 4 HDMI
## If you are using a CRT screen, please change the setting above with this one : 
# n64.videomode=default

## Dreamcast emulator
## Like N64, such a CPU intensive emulator needs a small resolution
## Consider DMT 4 HDMI (640*480) or DMT 9 HDMI (800*600). If you have a black screen on dreamcast, try DMT 9 HDMI here
dreamcast.videomode=DMT 4 HDMI

## Configurations generated by Recalbox

English

Basic

Advanced


Français

Basique

Avancée


Deutsch

Basic

Fortgeschritten


Español

Basic

Avanzado


Português

Básico

Avançado


Italiano

Di base

Avanzate

Clone this wiki locally
You can’t perform that action at this time.