
Product Specifications
- Product Name: EmulationStation
- Compatibility: Works with systems supporting emulation
- Latest Update: 2021/10/07 01:00
Product Usage Instructions
EmulationStation Menu Trees
This is a “tree” of the menus in EmulationStation, with a short sentence or two explaining the option (sometimes with a link to the relevant page). Think of it as a glossary of sorts. [Ctrl]+[F] through here to instantly find the option you’re after!
- Still needs a bit of work, adding in all the possible menu entries. Sit tight!
Main Menu Tree
This is the one you access by pressing [START] in any list.
Kodi Media Center
Start Kodi from the menu if supported by your system.
Retroachievements
Show your RetroAchievements progress if you have enabled it from the Games Settings menu.
Games Settings
The global settings that apply by default to all games.
Tools
- Update Games Lists: Choosing this option will perform a scan of your game folders and refresh the list of available games accordingly.
Default Settings
Game Ratio Set the aspect ratio used by the games. If not using Auto, Core Provided is recommended. Square Pixel will render pixels aligned to your screen, but is not recommended as most systems did not have perfectly square pixels with their displays.
- Video Mode: The output resolution sent to your display. This is (usually) independent of the emulated system’s rendering resolution. Smooth Games enables bilinear filtering or the equivalent of that in the emulator. Not available on all emulators. Automatically disabled if the rendering resolution is set to the video mode resolution. Rewind lets you use the [HOTKEY]+[D-pad Left] shortcut to rewind time during a game. See other commands at Hotkey shortcuts. Auto Save/Load When enabled, will do a save state when quitting a game, and load it when starting it back, letting anyone quit and start a game without losing progress.
- Shaders Set: This is used to select a preset shader set for games. See Shader Sets for more info. Integer Scale (Pixel Perfect) Older games are ordinarily expanded to fit a bigger screen, however, the pixel geometry may be warped if the image is scaled by a value that is not an integer. This forces the games to be scaled only by an integer factor; it will appear smaller on the display as a result (unless the display is exactly a multiple of the original resolution of the game). See Anti-aliasing for more.
(change to relevant header when added in the future) - Decoration: You can choose which bezel collections to use with this setting. Auto will use a per-system bezel. See Decorations (and The Bezel Project) for more information.
- Stretch Bezels: (4K & Ultrawide) Overlays are typically designed for 16/9 1080p monitors. If your screen uses a higher resolution or a different aspect ratio, this option can be used to make the bezel correctly fit the screen. See Display Issues for more info.
- Latency Reduction: Enables run-ahead in libretro cores. See Run-ahead input-lag reduction for more info.
- AI Game Translation: A menu used to set up the AI Translation. See AI game translation for more info.
- Per System Advanced Configuration: This will let you set up most system-specific configurations. Refer to the system’s page in systems for info on each particular system’s settings. If you have games settings and system specific settings conflicting,
the(confirm this) system specific one will take priority.
System Settings
- RoetroAchievements Settings: This submenu is used to set up RetroAchievements. See RetroAchievements for more information.
- Netplay: This submenu is used to set up netplay. See Netplay for more information. Missing BIOS Will list every missing BIOS. See BIOS files and how to add them.
- Check BIOSes before running a game
: When launching a game on a system requiring BIOSes, you can either tell batocera to warn you about missing ones, or not.
Controllers Settings
Configure your supported_controllers and player order here.
- 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 Configure A Controller for more info.
- Pair A Bluetooth Controller: Pressing this will make you to pair a Bluetooth controller, for some, 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.
UI Settings
Tweak your UI! Check out EmulationStation UI Settings.
EmulationStation UI Settings
Appearance
- Theme Set: This is used to choose the theme you are using, additional themes can be downloaded from the Updates & Download category in the main menu, see Theme Set for reference.
- Theme Configuration: This opens a submenu to customize your currently used theme, customization options are specific to the used theme.
- UI Mode : You can select different modes for Batocera, Kiosk mode and Kid mode will reduce the amount of possibilities, see also UI mode.
- Start on System
: Select which system is selected as default - Start on Gamelist
: Start ES on gamelist view of selected system - Overscan
: Option only relevant for SBC supporting overscan settings, can be used in case the image is cropped improperly on the screen. - Systems displayed
: This is used to choose which systems to display, and which ones to hide.
Display Options
- Transition Style: This is used to decide if the menu should have a fade-in transition effect, a moving effect, or change instantly when starting a game.
- Carousel Transitions
Instantly show next/previous system - Screen Saver Settings
- Screen Saver After
: This is used to decide how long the system must stay unused before triggerring the screensaver. - Screen Saver Behavior: This is used to choose what the screensaver will do, see ScreenSaver Behavior.
- Stop Music on Screensaver
: Enabling this will stop the main menu music from playing when the screensaver is used, if video files are used as a screensaver, their audio will be then used instead. - Random Video Screensaver Settings: see Random Video Screensaver settings Slideshow Screensaver Settings : see Slideshow Screensaver settings
- Screen Saver Controls
: Enable the use of the buttons to perform different actions during the screensaver.
- Screen Saver After
- Game Launch Transition: auto, fade, slide or instant
- Show Clock
: Displays the hour on EmulationStation - On-Screen Help
: Displays the buttons’ actions in EmulationStation - Quick System Select
: This option let’s you use change the currently selected system using the left and right buttons when using a basic list of games. - Show Battery Status: for battery-powered devices, chose between Nothing, icon or icon and text (percentage)
Gamelist Options
- Show Favorites on top
: When active, the favorite games will be put on top of the list. - Show hidden files
: When enabled, the files described as hidden by the gamelist.xml file ill be displayed. - Show folder
: This option makes it possible to show the folder hierarchy inside a system, or to display all games as if they were directly put inside the folder. - Show ‘..’ parent folders
: When subfolders are shown, enabling this will show a KK entry to go back one folder; this entry can be hidden. - Show Filenames in Lists
: Shows the filename instead of the scraped game name.
Game Collection Settings
Collections to display
Game Collection Settings
- Automatic Game Collections
: Add some predefined collections in the menu (2-player, 4-player games…) - Custom Game Collection
Select from your custom game collection
Create Custom Collection
- Create New Game Collection Game Collections are stored in
- AeljbLconfigs/emulationstation/collections Create New Dynamic Collection
Options
- Sort Systems: Alphabetically, by manufacturer, by hardware type, by release year
- Start on System: Restore last selected, or choose your favorite system to start with
- Start on Gamelist

- Group Unthemed Custom Collections
- Short Custom Collections and Systems
- Show System Name in Collections. Add a system description to a ROM file e.g. Sonic [Megadrive]
Sound Settings
- 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 music
: Can be enabled to let the currently used theme use its own music. - Lower Music when playing video
: When a video preview is playing, reduce the music played in ES. Sounds
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.
Network Settings
- Informations
- IP Address This displays your IP address, which can be useful if you want to access your device over the network (you should be able to access your device in Windows through the file explorer. Type \\(IP address of Batocera) in the address bar to gain access to the share.)
- Status: This menu option will show you information about your network and if you’re connected to the internet (not your local network). This can be useful for troubleshooting issues with online gaming or game scraping. 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.
- Show Network Indicator
: Will display a small icon in EmulationStation when connected to the network if this is enabled.
Settings
- Hostname The hostname will be a name to distinguish your device from others on the network. Your router may append .local or .lan to it, check its settings.
- Enable WiFi Enables or disables the Wi-Fi, useful for handhelds to save power. When using a wired connection, this will be turned off automatically.
- WiFi SSID Set up your Wi-Fi SSID.
- <List of Wi-Fi networks scanned> You may need to use “Refresh” if you had just turned it on.
- Refresh Scan for networks again.
- Manual Input: Manually type out your network’s SSID. Special characters may need to be escaped with a preceding \.
- WIFI Key: This is the password to your wireless network that you’re attempting to connect to. Special characters may need to be escaped with a preceding \.
Scrape
Allows you to scrape boxart/marquees for your game collection from an online database.
Updates & Downloads
Download freely distributed content for Batocera! See Content downloader/updates for more info.
- Downloads
- Content Downloader Lets you download additional content for Batocera, such as games, bezels, cheats, graphics packs and homebrew.
- Themes Customize the way Batocera looks!
- The Bezel Project Download additional bezels for (nearly) all your games!
- Software Updates
- Check for Updates
Shows a pop-up window when a new update is available. Update Type Select between stable and beta updates. - Start Updates Start the update! You’ll be asked for confirmation.
System Settings
- System
- Information
- Your System Version ✔
- Disk Usage ✔
- Temperature ✔
- Architecture ✔
- System ✔
- CPU Model ✔
- CPU Number ✔
- CPU Max Frequency
- Language
- Power Saver Modes
- Kodi Settings
- Enable Kodi

- Kodi at Start
: Directly start Kodi on boot - Start Kodi with X
Start Kodi by pressing the X button on your controller
- Enable Kodi
- Hardware
- Brightness

- Video Output
- Audio Output
- 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
- Storage
- Storage Device
- Backup User Data
- Install Batocera on a new disk
- Advanced
- Security
- Enforce Security
To protect Samba/SSH with a custom password, it must be used along with the instructions in Changing the default root (ssh) password. - Root Password Set your custom root password for SSH Login
- Enforce 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
the 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


- Optimize Video VRAM use


- Enable Filters


- Save metadata on exit

- Parse Gamelists only

- Reset File Extension

- Redetect Games Language/Region

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

- VRAM Limit
Quick Access
Pressing [SELECT] at the system list (top level) will give you access to the following shortcuts:
Quick Access
- Launch the screensaver that you configured, for videos or pictures display
- Skip to next song when you play a background music in EmulationStation
- View Batocera Manual, your next best friend when you don’t have access to this fantastic wiki. Quit
- Restart Syste:m Reboot the machine. The #1 troubleshooting procedure. If Batocera isn’t the default boot drive, this will return you to your main operating system.
- Shutdown System Powers down the device. By default,it will send the halt signal to your device, so that you can power it back on again using a button.
- Fast Shutdown System shuts down the system without first saving modifications made to gamelist.xml. Only use this for troubleshooting purposes, as it can undo changes made during the session.
Options menu
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
From:
Permanent link
- https://wiki.batocera.org/menu_tree?rev=1633561240
- Last update: 2021/10/07 01:00

Frequently Asked Questions
How do I configure controllers?
Go to Controllers Settings to configure supported controllers and player order.
What is the purpose of UI Settings?
UI Settings allow you to tweak the appearance and themes of EmulationStation. You can choose themes, customize theme configurations, and select different UI modes like Kiosk mode or Kid mode.
Documents / Resources
![]() |
Batocera linux linux EmulationStation Menu Trees [pdf] User Manual linux EmulationStation Menu Trees, linux, EmulationStation Menu Trees, Menu Trees, Trees |

