Guide

Batocera Setup Guide: The All-in-One Emulation OS for Handhelds

Batocera Setup Guide: The All-in-One Emulation OS for Handhelds guide cover image

Affiliate disclosure: This guide contains affiliate links. As an Amazon Associate and Anbernic affiliate, we earn from qualifying purchases at no extra cost to you. Learn more.

Batocera is one of the most versatile emulation systems around. It is a complete Linux OS built for retro gaming that runs on a huge range of hardware. You can put it on a handheld, an old PC, a Raspberry Pi, or a single-board computer, and get the same friendly EmulationStation experience everywhere. For tinkerers who want one system that works across many devices, Batocera is hard to beat.

This guide explains what Batocera is, which handhelds it supports, and how to flash it, connect WiFi, and add your games. We frame all of this around playing games you already own and preserving your personal collection.

Affiliate disclosure: This page contains affiliate links. As an Amazon Associate and Anbernic affiliate, we earn from qualifying purchases at no extra cost to you.


What Makes Batocera Different

Most custom firmware targets one chip family. Batocera aims wider. It supports many handheld chipsets, plus desktop PCs, Raspberry Pi boards, and more. Updates are simple, the WiFi and network features are strong, and it does not touch your computer's main drive when you run it from an SD card. If you own several devices, running Batocera on all of them gives you one familiar setup.

It is a read-only system by design, which makes it stable and hard to break. Your games and saves live on a separate, writable part of the card.

Batocera vs Other Firmware

✓ Pros

  • Runs on a huge range of hardware, from handhelds to PCs to single-board computers
  • Stable, read-only design that is hard to break
  • Excellent WiFi and network features, including a web interface for managing games
  • Frequent updates that are easy to apply
  • Friendly EmulationStation frontend with scraping and themes
  • One familiar setup across all your devices

✗ Cons

  • Per-device tuning is sometimes better on a dedicated firmware like ArkOS
  • The huge scope can feel like a lot for a first-time user
  • Not every handheld is supported, so check the list first
  • Heavier than minimal firmware, so boot is a little slower

Batocera, ArkOS, and AmberELEC all use EmulationStation and overlap on some devices. Batocera's edge is breadth across many machines. For the bigger picture, see our Linux vs Android handhelds guide.

What You Need

  • A supported handheld, PC, or single-board computer
  • A microSD card or USB drive, 32GB or larger
  • A card reader and a computer
  • The Batocera image for your device
  • A flashing tool such as Balena Etcher

Step 1: Download the Right Image

Go to the official Batocera website and choose the image that matches your hardware. Batocera lists builds by device type and chipset. Pick carefully, since the wrong build will not boot.

Step 2: Flash the Card

Insert your card into your computer. Open Balena Etcher, select the Batocera image, select the card, and flash it. This erases the card. The flash writes the system and leaves room for Batocera to expand on first boot.

Step 3: First Boot

Put the card in your handheld and power on. The first boot takes a little longer while Batocera expands its storage partition. When you reach the EmulationStation menu, Batocera is ready.

Step 4: Set Up WiFi and the Web Interface

Open the network settings, enable WiFi, and connect. Note the IP address shown. One of Batocera's best features is its built-in web interface. Type the device's IP address into a browser on your computer, and you get a dashboard for uploading games, managing saves, and editing settings. It is one of the easiest ways to load a library.

Step 5: Add Your Games

You have three good options.

  • Card reader. Copy games to the roms folders on the card from your computer.
  • Network share. Batocera shares its folders over the network, so you can drag games across once WiFi is on.
  • Web interface. Upload games straight from your browser using the dashboard.

Place games in the matching system folders and put BIOS files in the bios folder. You supply all games and BIOS files from hardware you own. Our how to transfer ROMs and how to organize ROMs and BIOS files guides cover the details.

Step 6: Scrape Box Art and Theme It

Batocera includes a scraper and many themes. Use the built-in scraper over WiFi, or use Skraper on your computer for the highest quality art. Our how to scrape box art guide covers both. Then pick a theme to set the look you want.

Troubleshooting

Device will not boot. You likely picked the wrong image. Re-download the build that matches your exact hardware.

WiFi or web interface not working. Confirm WiFi is connected and you are using the correct IP address. Some handhelds need a supported WiFi dongle.

Games do not appear. Check the system folder names and refresh the game list or reboot. The web interface can help you confirm where files landed.

Recommended Handhelds

Batocera runs on many devices, so pick based on your hardware. For a capable Rockchip handheld, the

is a great fit. On the PC side, a device like the can boot Batocera from a card for a dedicated retro setup without touching SteamOS.

For more firmware options, see our ArkOS setup guide, AmberELEC setup guide, and muOS vs KNULLI vs Onion OS comparison.

Related reading