ES-DE Setup Guide: One Frontend for Your Whole Library

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

2026-07-18 · Setup guide

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

A good frontend turns a folder full of files into something that feels like a console. ES-DE is the biggest name in that world. It grew out of EmulationStation, it powers the interface many people already know from the Steam Deck, and it now runs natively on Android. One clean interface, every system, gorgeous themes.

This guide covers installing ES-DE on Android handhelds and the Steam Deck, pointing it at your library, and making it look great. As always, we only cover playing games you legally own.

What ES-DE Is

ES-DE stands for ES-DE Frontend, formerly EmulationStation Desktop Edition. It is a launcher, not an emulator. It scans your game folders, downloads box art and metadata, and hands each game off to the right emulator when you press launch. RetroArch, standalone emulators, it does not care. It organizes everything.

Two things to know before installing:

On PC and Steam Deck it is free. EmuDeck and RetroDECK both use ES-DE as their interface, so you may already have it.
On Android it is a paid app. It costs a few dollars as a one-time purchase, sold through the developer's Patreon and the Samsung Galaxy Store rather than Google Play. There is no subscription.

Setting Up on Android

Buy and install the Android release from the official ES-DE channels.
On first launch, ES-DE asks where your games live. Point it at your ROMs folder, or let it create the folder structure for you.
ES-DE expects one subfolder per system, with standard names like snes, psx, and gba. If you let it create the directories, this is done for you. Our ROM organization guide uses the same layout.
Let it scan, then set your preferred emulator per system under Other settings, Alternative emulators. On Android that usually means RetroArch cores for the classics and standalone apps like PPSSPP, Dolphin, and Vita3K for the heavy systems.

That last step is the one that trips people up. ES-DE launches emulators, so each emulator still needs to be installed and configured once on its own. Set up RetroArch first with our RetroArch guide, then let ES-DE tie it all together.

Setting Up on Steam Deck

If you use EmuDeck, ES-DE is already installed and configured. Launch it from Gaming Mode and everything works.

For a manual install, grab the Linux AppImage from the official site, run it once in Desktop Mode to set your ROM path, then add it to Steam so it launches from Gaming Mode. Pair it with Steam ROM Manager if you also want individual games on your Steam library shelf.

Scraping Box Art and Metadata

This is where ES-DE shines. Open the menu, choose Scraper, pick ScreenScraper as the source, and let it run. It downloads box art, screenshots, descriptions, and ratings for your whole library. A free ScreenScraper account raises the rate limits. Our box art scraping guide covers the details and etiquette.

Tips that save headaches:

Scrape one system at a time on big libraries. It is easier to spot mistakes.
Verified file names scrape more accurately. Odd names can match the wrong game.
Scraped media lives in ES-DE's own downloaded media folder, so back it up when you move devices.

The Folder Structure, Which Is Where Everyone Gets Stuck

Nearly every "my games are not showing up" problem is a folder problem, so it is worth understanding the rule rather than guessing.

ES-DE looks inside your ROM directory for one subfolder per system, named exactly the way ES-DE expects. Not the way you would name it. Not the way another frontend names it. Its own list.

A typical layout looks like this:

ROMs/
  gba/        Game Boy Advance
  gbc/        Game Boy Color
  nes/        NES
  snes/       SNES
  n64/        Nintendo 64
  psx/        PlayStation 1
  ps2/        PlayStation 2
  psp/        PSP
  nds/        Nintendo DS
  gc/         GameCube
  dreamcast/  Dreamcast

Two rules that solve most problems:

Let ES-DE create the folders on first run. It generates the whole correct structure for you, and then you copy games into it. This is far more reliable than building the tree yourself and hoping the names match.

One system per folder, no nesting. A snes folder with subfolders inside it for series or publishers will confuse the scan. Keep the files flat inside each system folder.

If you already have a library organised differently, our ROM organization guide covers restructuring it without losing track of anything.

Connecting Your Emulators

ES-DE launches emulators, it does not contain them. That is the single most misunderstood thing about it.

Every emulator you want to use has to be installed and working on its own first. Launch a game directly in RetroArch or PPSSPP and confirm it runs. Only then point ES-DE at it.

Doing it in the other order produces the classic frustration where a game launches, flashes, and drops you straight back to the frontend. That is nearly always an emulator that was never configured, not an ES-DE fault.

Per system emulator choice lives under Other settings, Alternative emulators. It is worth going through your systems once and setting these deliberately rather than accepting defaults, because the best emulator per system is a real decision. Our best emulation frontends guide and the individual setup guides cover which to pick.

Moving to a New Device

Worth planning before you need it, because the pieces live in different places.

Three things make up your setup: your games, your scraped media, and your ES-DE configuration. The media folder is the one people forget, and rescraping a large library from scratch takes hours and hammers the scraper service unnecessarily.

Copy the downloaded media folder along with your ROMs when you migrate, and your new device comes up fully illustrated on the first scan. Our save state management guide covers the saves side of the same move.

When Things Go Wrong

Games do not appear. Folder names, almost always. Check against ES-DE's supported systems list and rescan. Our ROMs not showing up guide covers the wider set of causes.

A game launches and immediately returns to ES-DE. The emulator behind it is not configured. Test that emulator directly before blaming the frontend.

Scraping matches the wrong game. Usually odd file names. Cleaner, more standard names match far more accurately, and scraping one system at a time makes mistakes easy to spot.

The interface feels sluggish. Large libraries with full media are heavy. A lighter theme helps a lot, and on low power Linux handhelds the native OS frontend may simply be a better fit than ES-DE.

Box art is missing after a move. The downloaded media folder did not come with you. Copy it across rather than rescraping.

Themes

ES-DE ships with a solid default theme and supports a deep theme engine. The built-in theme downloader lists dozens of options, from minimal grids to full console recreations. Download a couple, then switch under UI settings, Theme. Themes are where ES-DE goes from useful to genuinely lovely, and it is worth ten minutes of browsing.

Is ES-DE Right for You?

ES-DE is the most complete frontend you can run on a handheld. It is also heavier than some alternatives, and on low-power Linux devices the native OS frontend may be snappier. We compare the options in our best emulation frontends guide, including Daijishō, a free alternative many people love, and iiSU, the visuals-first newcomer.

Frequently Asked Questions

Is ES-DE free?

On PC and Steam Deck, yes. The Android version is a paid app with a small one-time price, sold outside Google Play through the developer's official channels.

Is ES-DE an emulator?

No. It is a frontend that organizes your library and launches your installed emulators. You still need RetroArch or standalone emulators underneath it.

ES-DE or Daijishō?

ES-DE is richer and more theme-driven, Daijishō is free and lighter. We break the choice down in our frontends comparison.

Why are my games not showing up?

Almost always folder names. ES-DE expects its standard system folder names, one system per folder, with the files flat inside rather than nested in subfolders. Check the name against ES-DE's supported systems list, then rescan. The most reliable fix is letting ES-DE create the folder structure itself on first run, then copying games into it.

Why does a game launch and immediately close?

The emulator behind it is not set up. ES-DE only hands the game off, so every emulator has to be installed and working on its own first. Test the game directly in RetroArch or the standalone emulator before blaming the frontend.

How much does ES-DE cost on Android?

A few dollars as a one-time purchase, sold through the developer's Patreon and the Samsung Galaxy Store rather than Google Play. There is no subscription, and the PC and Steam Deck versions are free.

How do I move ES-DE to a new device?

Copy three things: your ROMs, your ES-DE configuration, and the downloaded media folder. That last one is the one people forget, and leaving it behind means rescraping a whole library from scratch.

Does ES-DE work offline?

Yes. Only scraping needs a connection. Once box art and metadata are downloaded, everything runs locally.

Is ES-DE too heavy for a low power handheld?

It can be. Large libraries with full media are demanding, and on cheap Linux handhelds the built-in OS frontend is often snappier. A lighter theme helps if you want to stay with ES-DE.