Gamers who are emulator fans tend to come across the same problem over and over again. How to organize the hundreds of emulators on your disks, which ends up being a hugely boring task especially when you consider all of the ROMs and disk units involved. In an attempt to solve this problem, and avoid your emulators from getting too messy, EmulationStation puts everything in one place. It’s a frontend with one of the best interfaces out there today. Even though the process of setting things up can be tedious, the results are very well worth it.

If you are in the system selection screen of EmulationStation then you can press several buttons to perform some actions. Some basic but essential commands I'll show you in the following table.

In the table below, buttons A and B are listed with their regular Batocera configuration. But you can swap them from SYSTEM SETTINGSDEVELOPER MENU. There are also other options that may change the user experience, but here are the default mappings for Batocera 31.

If you talk to other users, as everyone use different controllers and often times remap them, we usually refer to the four action buttons as North / East / South / West. You can see in the tables below how they map to PlayStation, XBox and SNES controllers.

Press START button on your controller to show up then Main Menu of EmulationStation (system selection menu).

If you press SELECT button the menu popping up will be different whether you are on the Main/System Menu or the Game List:

Start Button in Main Menu and Game List Select Button in Main Menu Select Button in Game List
  • Start Kodi out of the menu if supported by your system
  • Show your RetroAchievements progress if you have enabled it from the Games Settings menu.
  • Configure A Controller : Clicking this option will show a window asking to hold a button on the gamepad to configure, it will then ask for a list of inputs, see also Configure A Controller.
  • Pair A Bluetooth Controller : Pressing this will make you able to pair a Bluetooth controller, for some unfortunately you might need to pair it manually using the command-line.
  • Forget Bluetooth Controllers : Choosing this will list your paired Bluetooth controllers, and let you unpair them.
  • Gamepad order : The list here can be used to affect specific gamepads to specific players.
  • Show Controller Activity : Checking this option shows the number of controllers connected with icons inside emulationstation, and they will blink when used.
  • Frontend Music : Is used to enable or disable the music in EmulationStation.
  • Display Song Titles : Used to show the name of the music file in EmulationStation when it starts playing.
  • How many seconds for song titles : How long new song pop-up badge is displayed.
  • Only Play System-Specific Music Folder : Can be used to play only specific musics when going inside a given system folder, see also EmulationStation music.
  • Play theme musics : Can be enabled to let the currently used theme use its own musics.
  • Lower Music when playing video : When a video preview is playing, reduce the music played in ES.
  • Enable Navigation Sounds : Some themes use navigation sounds, enabling this let's you hear them when moving in the menu.
  • Enable Video Audio : For video previews, enables their own audio.
  • IP Address : This displays your IP address which can be useful if you want to access your device over the network1).
  • Status : This menu option will show you information about your network and if you're connected currently. This can be useful for troubleshooting issues with online gaming or game scraping.2)
  • Show Network Indicator : Will display a small icon in EmulationStation when connected to the network if this is enabled.
  • Hostname : The hostname will be a name to distinguish your device from others on the network, this hostname followed by .local can also be used to connect to your batocera (for exemple: ssh root@batocera.local).
  • Enable WIFI : Enables or disables the WiFi, when using a wired connection, this will be turned off automatically.
  • WIFI SSID : The name of your WiFi Network
  • WIFI Key : This is the password to your wireless network that you're attempting to connect to. Be careful with special characters, they might need to be escaped with a \ (like if you have a space or a ? in your wifi password).
  • Image Source
  • Box Source - you can select if you prefer the 2D or 3D version of the game boxes (or none)
  • Logo Source - several games, in particular for arcade games, have different logos: one for the marquee of the arcade cabinet, or a wheel one.
  • Scrape Videos
  • Scrape Fanart
  • Scrape Manual - Batocera 5.27+ offers you the ability to show game manuals (by hitting select on a game) if you scraped the manuals
  • Scrape Pad2key settings - For Batocera 29+, when you use a joypad to emulate a keyboard
  • Username if you use screenscraper as a source, and you have an account with multiple threads, using your screenscraper username and password here will leverage scraping with as many parallel threads as you have access to. It's a lot faster.
  • Password


Software Updates

  • Update Type Select between stable and beta updates
  • Start Updates You'll be asked if you really want to update



  • Brightness
  • Multimedia keys: if you have an Odroid Go Advance or its clone, do you want to enable the lower system keys?
  • Overclock Only relevant for some SBC, not for PC



  • Security
  • Developer
    • VRAM Limit Setup max usage of Video RAM (Theme dependent!)
    • Show Framerate show how many FPS you can get on each emulator
    • VSYNC
    • Overscan Use Overscan feature for SBCs that support it (not PC)
    • Preload UI Pre-load UI elements like images, use it if you have 4GB or more on your system
    • Threaded Loading Use several CPU cores to accelerate loading. Use this option if you have a “high-end”ish CPU.
    • ASync Images Loading Can load several images in parallel, for a better user experience if you have no RAM/network constraints.
    • Optimize Images VRAM use FIXME
    • Optimize Video VRAM use FIXME
    • Enable Filters FIXME
    • Save Metdata on exit
    • Parse Gamelists only
    • Reset File Extension FIXME
    • Redetect Games Language/Region FIXME
    • Use Retroarch RGUI Menu Lets you switch between the new ozone GUI and the classic one
    • Switch A/B buttons in EmulationStation - this option might be useful, if you are coming to Batocera from other distributions with a different default mapping
    • Log Level
    • Create a support file Needed for error detection mostly related to developers
    • Format disk Lets you format disks (exfat, ext4, btrfs)
    • Use OMX Player (HW accelerated)

Pressing the select button at the top level menu (system selection) will give you access to the following shortcuts:

Quick access

  • Launch screensaver that you configured, for videos or pictures display
  • Skip to next song when you play a background music in EmulationStation
  • View Batocera Manual you next best friend when you don't have access to this fantastic wiki ;-)


Pressing the select button at the game level menu will give you access to the following shortcuts: Navigation

  • Filter games by text
  • Jump to : a letter
  • Sort games
  • Other filters
  • Find similar games: On Batocera 29+, you can find games that are similar to the one you are selecting. When you want to play all the games in a series, for instance.

View Options

  • Gamelist view style
  • View customization

Game Options

  • Advanced System Options
  • Advanced Game Options
  • Edit this game metadata

Batocera has a simple built-in file manager called PCManFM. It can be accessed by pressing F1 on your keyboard on the main EmulationStation menu.

If you want to configure certain Emulators for systems like Wii U, PlayStation 2 or PlayStation 3 you can find the emulator settings by opening Applications in the sidebar.

you should be able to access your device in windows through the file explorer. Type \\batocera in the address bar to gain access to the share.
Batocera checks its status by trying to reach out to the Batocera public website. If you see “NOT CONNECTED” it indicates that the website cannot be contacted by your Batocera box: there might be a temporary network issue that is not necessary on your personal network.
  • emulationstation.txt
  • Last modified: 2 months ago
  • by igno2k