Retro PlayApp guide Release notes Download
GUIDE Everything you can do, in short

Your retro games, tidy and ready to play

Retro Play Game Manager keeps your games in order: you add them, fix titles and covers, and install them with one click on ES-DE, MiSTer FPGA, RetroArch, RetroPie or Batocera. Each page explains one task and shows it in an animation.

0.0.3Release notes · what each version brought

How it works

01

The archive

The folder with your games and everything that describes them: titles, covers, videos, saves. On your PC, a drive or a NAS.

02

The app

Shows the archive like a game store. Here you search, fix and complete: every change goes into the archive.

03

The frontend

Where you play: ES-DE or RetroArch on your PC, a MiSTer FPGA, a RetroPie or a Batocera. The app installs games there and starts them.

All topics

Each topic has a short explanation and an animation.

  1. To start from scratch, click New archive and choose an empty folder.
  2. Already have an archive? Click Open archive and choose its folder.
  3. The library opens with all your games.
  4. The archive’s name, top left, opens its menu: space used, report, DATs, export.

Good to know

  • You can also drag the folder onto the window, or press Ctrl O.
  • Recent archives are on the start page.
  • The archive can live on your PC, a USB drive or a NAS.

Watch out

An archive made by a very old version of the app doesn’t open: it has to be made again.

  1. Click Add games, at the top of the sidebar.
  2. Choose the platform: type a few letters to find it.
  3. Click Choose the folder and pick where the ROMs are. If the folder is named after the system (e.g. snes), the platform is picked for you.
  4. Check the summary (games, space, files left out) and press Copy.
  5. You can leave the copy in the background or stop it: the games already copied stay.
  6. Done. From here you can start scraping to get titles and covers.
  7. The games are in the sidebar, under their system.

Good to know

  • Only the files ES-DE recognises for that platform are copied.
  • A game on several discs becomes one game. Games with the same title become versions of one game.
  • Games already in the archive are not touched.
  • The arrow next to Add games also imports a .zip export, or the games only the frontend has.

Move instead of copy

Turn on Move the files instead of copying them and the games’ files leave the folder: they stay only in the archive. The app asks you first, because if the move doesn’t complete you could lose data.

Arcade games

For arcade and mame you choose which ROM Set the games go into.

Retro Play Archive/the archive’s folder
snes/the games of a system
sfc/a folder per kind of file
Super Metroid (Japan, USA).sfcthe game, as it is
@metadata/everything that describes the games
snes/catalog/00.json … ff.jsontitles, dates, genres, ratings…
snes/covers/, screenshots/, videos/…covers, screenshots, videos
snes/gamelist.xmlthe same details, for ES-DE
@saves/the copies of your saves
@dats/the DATs to check the games
@collections/the collections
  1. It is a normal folder, on your PC, a drive or a NAS.
  2. The games stay as they are, split by system and by kind of file.
  3. @metadata holds everything that describes the games:
  4. the details (title, description, date…), also in a gamelist.xml for ES-DE;
  5. the media: covers, screenshots, videos, manuals.
  6. @saves holds the copies of your saves.
  7. @dats holds the systems’ DATs.
  8. @collections holds the collections.

Why it is made like this

  • The games stay normal files: you can use them without the app.
  • Each change rewrites only a small file, so even a huge archive on a NAS stays fast.
  • If another PC changed the same game, the app asks before overwriting.
  1. In the sidebar, click a system, or All games.
  2. List shows the games in a compact table.
  3. Details adds the description and the main data.
  4. Sort changes the order: title, date, rating, size…
  5. The first button goes back to the Covers.
  6. The slider at the bottom right changes the size of the covers.

Good to know

  • The marks on the covers tell how the game is in the frontend: installed, different files or to archive.
  • The ring with the percentage (details and media) tells how much information a game has. Point at it to see what is missing.
  • In the list, right-click the header to show or hide columns.
  • The … menu at the top acts on all the games shown.
  1. In the second group of view buttons, click the first: Timeline.
  2. Each system starts in the year it came out, with its games year by year.
  3. Click Fit to see all the years; the slider widens them again.
  4. Click a year: its games open below. Click a cover to open the game.
  5. Click a system’s name to see it alone, with all its covers.

Good to know

  • Drag with the mouse to move around; Ctrl + wheel zooms.
  • Games without a release year aren’t on the line: the button at the top shows them in the library.
  • Search and filters work here too.
  1. In the second group of view buttons, click the middle one: Company map.
  2. The first time, the app looks up on Wikidata where each company is: the map fills in while it searches. Stopped, it waits until you click … to look up or start the app again.
  3. Choose Developers, Publishers or All. Click a bubble to zoom in, a country to see it alone.
  4. Click a company: you see where it is, its years and its games. Show in the library filters them.
  5. Under No location, click Place it: find the company or its city, or click the spot on the map.

Good to know

  • The places are kept in the archive: every computer sees them, and a place you choose is never changed.
  • A person or a name that isn’t a company can be removed from the map.
  • Search and filters work here too.
  1. In the second group of view buttons, click the last: Gaming journeys, then New journey.
  2. Add games with Add games, or from a game’s menu with Add to journey….
  3. Click a step on the path to see its pictures, video and details; double-click it to play.
  4. Drag a step to move it; write a note to say why it is there.
  5. Click Export to save the journey as a .zip and send it to whoever you like.
  6. Drag a journey’s .zip onto the window (or click Import) to add it.

Good to know

  • The .zip holds only details, notes, pictures and videos: never a ROM or game file.
  • The app finds your games by file name, contents and title. A step whose game you don’t have says Game not available: Choose the game lets you pick it yourself.
  • You follow your journeys from the sofa too: in Desktop Mode (the Journeys section) and on the phone.
  1. Go to the games you are interested in.
  2. Rest the pointer on a cover.
  3. The preview opens: muted video, screenshots and the main data.

Good to know

  • It shows only for games with at least a screenshot or a video.
  • Turn it on or off in Settings → Library.
  1. Click the search bar at the top (or press Ctrl F).
  2. Type: it searches title, file name, developer, publisher and genre.
  3. Open Filters: the categories on the left, the values on the right with their number of games.
  4. To complete finds the games with no cover, description, video…
  5. Each filter becomes a label at the top: × removes it, Clear filters removes them all.

The filters

  • System, Genre, Developer, Publisher, Year, Players, Rating.
  • To complete, RetroAchievements, DAT check; at the bottom, ticked with a click, Favorites, Installable (the games the frontend can install) and Saves.
  • Use the same filters often? Save them with a name.
  1. Press Ctrl K, or the ⌘ button at the top.
  2. The list holds the actions, the places of the library and the views.
  3. Type a few letters: what matches comes first, games too.
  4. ↑ ↓ to choose, Enter to open.
  5. Views, sort orders and the pages of the settings are there too.

Good to know

  • On a game page, the first commands are for that game: play, edit, favorite, scrape.
  • Esc closes it.
  1. Search, filter or choose a system: here Genre: Platform.
  2. Click Save filters.
  3. Give it a name and press Save.
  4. The filter appears under Saved filters, with its number of games.
  5. One click and the library goes back to that search, always up to date.

Good to know

  • Right-click a saved filter to Edit or Delete it.
  • Saved filters are the same for every archive.
  1. Hover over a cover and click the star.
  2. Or right-click the game…
  3. …and Add to favorites.
  4. Click Favorites in the sidebar…
  5. …to see only the favorites, of every system.

Good to know

  • The star is also on the game page and in the selection bar.
  • With ES-DE, RetroArch, RetroPie or Batocera connected, the favorites are the same in the app and there. MiSTer FPGA has no favorites.
  1. Select some games and click Collections… in the selection bar.
  2. Choose New collection….
  3. Give it a name and press Create.
  4. Or right-click a game and choose Collections……
  5. …and tick the collection. A second click takes the game out.
  6. Click the collection in the sidebar to see only its games.

Good to know

  • Right-click a collection in the sidebar to Rename or Delete it: its games stay in the archive.
  • The + beside Collections makes an empty one; the game page shows the collections of a game.
  • If the Atelier theme of ES-DE uses the same archive, it shows them in ES-DE too.
  1. Click a game (or press Enter).
  2. At the top: screenshot, main data, Play (or Install) and the actions, like Edit and the … menu.
  3. Every picture opens full window: ← → to browse, Esc to close.
  4. Scrolling down: gallery, description, cheats, box and, at the side, details, versions, notes and files.
  5. The arrows at the top go to the previous and next game.

Good to know

  • Esc or the mouse’s back button take you back to the library.
  • A game only the frontend has shows Play and Import into the archive.
  • Play time appears once you played it: see Play time.
  1. Right-click a game: every action is there, from Play to Delete from the archive.
  2. To select several games: Ctrl+click (Shift+click for a range, Ctrl A for all).
  3. The selection bar appears at the bottom: edit, scrape, export, install, delete…
  4. A right click on a selected game acts on the whole selection.

Good to know

  • Items you can’t use are greyed out: their tooltip says why.
  • Esc clears the selection.
  1. Select 2 to 6 games and click Compare.
  2. One column per game, with videos and screenshots.
  3. Scrolling down: artwork, box and details.

Good to know

  • Every picture enlarges, and the arrows move from game to game.
  1. Open the game.
  2. Click Edit: the editor opens on the Details tab.
  3. Type in the fields: here the description.
  4. For genre, developer and publisher the app suggests the values already used.
  5. Give the rating with the stars, half stars too.
  6. Press Save (or Ctrl S).

Good to know

  • Web, next to each field, looks that detail up online: see Media and details from the web.
  • The sort title only changes the order of the list (e.g. «Legend of Zelda, The»).

Watch out

A field you empty here stays filled in ES-DE, even when you install the game again.

  1. In the editor open the Media tab: there is a box for each kind.
  2. Drag a file onto the right box. Or click it to choose one, or paste with Ctrl V.
  3. The media goes into the archive at once: no need to save.
  4. The game page and the library show it right away.

Good to know

  • The kinds are ES-DE’s: cover, back cover, 3D box, physical media, screenshot, logo, fan art, video, PDF manual…
  • WebP, GIF, BMP and AVIF become PNG, because ES-DE reads only PNG and JPG.
  • The globe looks the media up online: see Media and details from the web.
  1. In the editor, Media tab.
  2. Click the globe next to the media (here the cover).
  3. Results arrive from each source: click the one you want.
  4. The media is downloaded and applied.
  5. Details work the same: Web next to the field (here the description).
  6. Pick a value…
  7. …and press Use this.
  8. Then Save.

The sources

  • ScreenScraper: media and details in every language. Needs an account.
  • libretro thumbnails: covers, screenshots and logos. No account.
  • Wikipedia and Wikidata: details and cover. No account.
  • IGDB: covers of every region and artwork. Needs a Twitch client.

Good to know

  • The game is recognised by its file, but you can search another title too.
  • On the game page, Search the web and Search YouTube open Google and YouTube.
  1. Show the games to complete (here To complete → No cover) and open the … menu at the top.
  2. Choose Scrape the games shown. It also works on the selection or on one game.
  3. Choose what to get. With Replace what is there off it gets only what is missing. Then Start scraping.
  4. You see each game with what it received, and the calls your account has left.
  5. Finished: here is the summary.
  6. Covers and details are already in the library.

Good to know

  • You need a ScreenScraper account, set in Settings → Scraping.
  • Scraping goes on in the background and can be stopped.
  • Games that already have everything are skipped.
  1. Select the games (Ctrl+click).
  2. Click Bulk edit in the selection bar.
  3. Type in the fields to change: they turn on by themselves.
  4. Press Apply.

Watch out

A field turned on and left empty is cleared in every selected game.

  1. Right-click the game (or a selection).
  2. Choose Delete from the archive… (or press Del).
  3. Check the summary and press Delete permanently.
  4. A bar shows how far it is, then it’s done.

Good to know

  • What is installed in the frontend is not touched.
  • You can delete the game’s saves too.
  • You can delete once nothing else is in progress (adding, scraping, exports, installs).

Watch out

Deleting can’t be undone.

  1. Open a game with several versions: here Super Mario Bros. 3 in USA, Europe and Japan.
  2. The page says how many versions and formats it has, and which one the frontend has.
  3. The fourth view button opens Versions and formats.
  4. Multiple files lists the games with several versions or formats…
  5. …each with its versions and their formats. The installed one is green.

What you can do in the view

  • Rename, install or separate a version.
  • Move a file to another version or another game, also by dragging it.
  • Join two games: see Join duplicates.

How a version is recognised

  • By the tags in brackets: Zelda (USA) and Zelda (Europe) are two versions.
  • Same tags but a different kind of file (.cue and .chd) are two formats of the same version.
  • When installing you choose version and format.
  1. An orange badge on the Versions and formats button means there are games to join: click it.
  2. To join puts the games in columns; the last, After joining, shows the result. Choose the game that stays and press Join.
  3. It is now one game, with two versions.
  4. You find it in Multiple files.

Good to know

  • The game that stays keeps its data and takes from the others what it lacks (in green).
  • Not the same game removes the suggestion for good.
  • Join all joins every group at once, with a bar and a count of the groups as it goes. Nothing is joined without your confirmation.
  1. Open the Versions and formats view.
  2. Choose the system in the sidebar.
  3. Click Formats, top right.
  4. For each format you see how many games have it and the space it takes. Delete removes it.
  5. First the app tells you what happens: games with only that format are deleted, the others just lose that format.

Good to know

  • What is installed in the frontend is not touched.
  1. Click Arcade in the sidebar.
  2. Next to the name is the ROM Set shown. The padlock means the frontend chooses it.
  3. Open the frontend settings (the icon next to its name).
  4. In Arcade ROM Sets choose the one the frontend uses. New ROM Set… is here too.
  5. The library shows the games of the chosen ROM Set.

Good to know

  • Only arcade and mame have ROM Sets.
  • The same game in several ROM Sets has the same details and media.
  • With no frontend connected, change the ROM Set from the button next to the platform’s name.
  1. Click Connect… in the sidebar.
  2. Choose ES-DE and pick its folder (the one with ES-DE.exe).
  3. Connected: the sidebar shows Installed and To archive.
  4. One click and you see, for example, the installed games.

The marks on the covers

  • green the frontend has the game, the same as the archive.
  • orange the frontend has it with different files: Install again updates it.
  • To archive only the frontend has it.

Good to know

  • You connect one frontend at a time. Disconnect touches neither the archive nor the frontend.
  • ES-DE, MiSTer FPGA, RetroArch, RetroPie and Batocera can be connected.
  • ES-DE sees new games only after a restart.
  1. Click Connect… in the sidebar.
  2. Choose MiSTer FPGA.
  3. Type the MiSTer’s IP address, user and password and press Connect. The app tries to find it on the network by itself.
  4. Or click Choose a folder… and pick the SD card plugged into the PC.
  5. Connected: the library shows what is on the MiSTer.
  6. Here are the games installed on the MiSTer.

Good to know

  • Only games one of its cores loads go onto the MiSTer. The others are Cannot be installed, and the tooltip says why: Install anyway copies them all the same.
  • Play starts the game right on the MiSTer.
  • User and password are saved only once the connection works.

The MiSTer’s files

In Settings → Frontend, Browse… opens the MiSTer’s SD card: you can send, receive, rename and delete files.

  1. Click Connect… in the sidebar.
  2. Choose RetroArch and pick its folder (the one with retroarch.exe).
  3. Connected: the sidebar shows Installed and To archive.
  4. Here are the games installed in RetroArch.

Good to know

  • The games go in the roms folder inside RetroArch’s, one folder per system.
  • RetroArch shows only the name and the pictures: the other details stay in the archive.
  • A system needs its core: download it in RetroArch (Online Updater) and Play starts it.
  1. Click Connect… in the sidebar.
  2. Choose RetroPie.
  3. Type the Raspberry’s IP address, user and password. The app tries to find it on the network by itself.
  4. Press Connect. Or click Choose a folder… and pick its roms folder.
  5. Connected: the library shows what is on RetroPie.
  6. Here are the games installed on RetroPie.

Good to know

  • RetroPie’s Samba shares must be on (RetroPie Setup → Configuration / tools → samba).
  • Play starts the game right on the Raspberry, in the place of EmulationStation.
  • User and password are saved only once the connection works.
  1. Click Connect… in the sidebar.
  2. Choose Batocera.
  3. Type Batocera’s IP address, user and password. The app tries to find it on the network by itself.
  4. Press Connect. Or click Choose a folder… and pick its data folder (the one with roms).
  5. Connected: the library shows what is on Batocera.
  6. Here are the games installed on Batocera.

Good to know

  • Play starts the game right on Batocera. After installing, Batocera updates its game lists by itself.
  • Some systems have another name on Batocera (Amiga is amiga500, Genesis goes with Mega Drive): the app puts each game in the right folder.
  • User and password are saved only once the connection works.
  1. Select the games, or open a game’s page.
  2. Right click → Install in ES-DE… (on the game page: Install).
  3. If a game has several versions or formats, choose which one to install.
  4. Check the summary and press Install.
  5. Done: the games are in the frontend.

Good to know

  • To show only the games it can install: Filters → Installable. To install every game shown: the … menu at the top.
  • Install again puts the archive’s files back into a game with the orange mark.
  • The MiSTer gets only the games’ files; RetroArch also gets the name and the pictures.
  • A game in a format the frontend doesn’t load stays out: Install anyway on its page (in the menu, point at Install → Force install) copies it all the same, but it isn’t guaranteed to work.
  1. Right-click an installed game (or a selection).
  2. Choose Uninstall from ES-DE…
  3. Check what will be removed and confirm.
  4. The game is no longer in the frontend, but it is still in the archive.

Good to know

  • Before uninstalling, the app archives any new saves.
  • If a game is only in the frontend the app warns you: archive it first.
  1. Click To archive in the sidebar.
  2. The button at the top imports them all (or choose which ones).
  3. Check and confirm.

Good to know

  • From ES-DE come details and media too, from the MiSTer only the files.
  • A single game is imported from its page, with Import into the archive.
  1. Open the frontend settings: the button next to its name, or Settings → Frontend.
  2. In Compatible formats, click View and edit….
  3. Choose a platform on the left.
  4. On the right are the formats taken: × takes one out (here ADF).
  5. Below you see the effect: ADF is now Not taken.
  6. Restore defaults puts the original formats back.
  7. Close: the changes are already saved.

Good to know

  • To add a format, type its extension (e.g. lha) and press Add.
  • Taking a format out doesn’t uninstall the games already in the frontend.

Watch out

  • ES-DE sees only the extensions of its es_systems.xml: a format added here must be added there too.
  • MiSTer FPGA: a format no core loads is opened from the core’s menu, not with Play.
  1. Open the game.
  2. Click Play.
  3. The game starts, and the app tells you with which emulator.

Good to know

  • With ES-DE the game starts the way ES-DE would start it, unless you choose otherwise in Emulators and commands.
  • With MiSTer FPGA it starts on the MiSTer, which must be connected over the network.
  • If the game doesn’t start, the app tells you why: the emulator or the core is missing, or the emulator closed right away, and then you also see its error message.
  1. Open the frontend settings: the button next to its name, or Settings → Frontend.
  2. In Emulators and commands, click View and edit….
  3. Choose a system on the left.
  4. Pick the emulator for all its games: each says whether it is installed.
  5. Change the command line and click Save command: the preview shows the line a game starts with.
  6. In Single games, pick a game to give it its own emulator or command.
  7. Close: the changes are already saved.

Good to know

  • Only Play in Retro Play uses them: a game started from the frontend starts its own way.
  • Restore defaults (or Restore, for a game) goes back to the frontend’s emulator and command.
  • From a game’s menu, Emulator and command… opens it on that game.

Watch out

  • Batocera: only the emulator and the core, no command line.
  • MiSTer FPGA: not available, its cores load what the MiSTer menu opens.
  1. In the Settings, open More settings: the DIP switches are in the Arcade area.
  2. On the ROM Set, click Give XML… and choose the MAME XML of its version.
  3. Open an arcade game of that ROM Set: its page shows the board and what each switch does.
  4. Click a lever, or choose a setting from the switch’s menu.
  5. Restore defaults puts them back as the board comes.

Good to know

  • Each ROM Set needs the full XML of its own MAME version (-listxml). Without it, its games have no switches, but on MiSTer FPGA: it reads them from its .mra files.
  • They work with the MAME cores of RetroArch (in ES-DE or on its own) and with MiSTer FPGA. With another emulator, the page tells you.
  • MAME 2003-Plus, 2003 and 2000 need the game played once: the switches count from the game after.
  1. Open the game page: the cheats are under the description.
  2. Click Find cheats.
  3. Pick a file (the one named like the game has a tick) and click Use.
  4. Turn on the cheats you want.
  5. Play the game from the app: they are already on.

Good to know

  • They work with RetroArch, inside ES-DE or on its own. With another emulator the page tells you.
  • Have a .cht file of your own? Use From file….
  • With RetroAchievements in hardcore mode, a cheat on switches RetroArch to normal mode for that game.
  1. Each card says when you played or saved, where, and for how long.
  2. The arrows at the sides show the other games; you can also drag the row with the mouse.
  3. The button changes: Resume when the archive has a newer save, otherwise Play or Install.
  4. The save goes back to the frontend and the game starts.
  5. One click on the card opens the game page.

Good to know

  • The row uses the plays ES-DE notes, the games started from the app and the dates of the saves.
  • It shows in the covers view, when you are neither searching nor filtering.
  • The time is the play time the app counted.
  1. Start a game with Play: from the app, from Desktop Mode or from the phone.
  2. Play. When you close the game, the app adds the time.
  3. You see it on the game page (Play time), in Continue playing and in Desktop Mode.
  4. To see the games you played most, sort by Play time: the list view has its column.

Good to know

  • Games started from the frontend itself aren’t timed, but RetroArch and Batocera count their own time and the app adds it.
  • A game that closes at once, or with an error, doesn’t count.
  • The time stays on this computer.
  1. In the Settings, open Discord, the last of the integrations.
  2. Turn on Show on Discord what you’re playing.
  3. Start a game: the preview shows what your friends see.

Good to know

  • Discord must be open on this PC. The status is off until you turn it on.
  • Only games started from the app show: from the window, the phone or Desktop Mode.
  • The cover comes from libretro’s public thumbnails; without one, the console’s picture shows.
  1. Each card shows the year and how many years ago. Round anniversaries stand out.
  2. The button on the card plays the game, or installs it.
  3. One click on the card opens the game page.

Good to know

  • The same row is on the Home of Desktop Mode.
  • Games whose date has only the year are left out.
  • You turn it off in Settings → Library.
  1. Click the dice in the library’s bar.
  2. The wheel spins and slows down…
  3. …and stops on a game: Play it (or Install it) or open its page.
  4. Not this one? Spin again.

Good to know

  • Above the wheel you choose where it picks: the games shown, favorites, never played, installed.
  • In Desktop Mode: the Spin the wheel card on the Home, or the menu.
  • You turn it off in Settings → Library.
  1. Open a game’s page.
  2. Scroll to the bottom: More like this. Under each game, what it shares: Same series, the developer or the genre.
  3. Click one to open its page.

Good to know

  • The same game on another system isn’t listed.
  • In Desktop Mode: the Similar button on a game’s page.
  • You turn it off in Settings → Library.
  1. Click the joypad at the top right, press F10 or the joypad’s Menu button.
  2. Home: at the top the game you are on, with its video. Below, the rows: Continue playing, favorites, systems, added last…
  3. LB and RB change section: Home, Systems, Favorites, Journeys, Search.
  4. A opens a system’s games. LT and RT jump from letter to letter.
  5. On the game page: Play, Favorite and the pictures, large.
  6. The game starts. When you close it, you are back in Desktop Mode.
  7. In Journeys, A opens a gaming journey: move along its steps, A plays the step’s game.
  8. Menu opens the menu: Attract mode, Theme (see Desktop Mode themes), sounds, videos’ sound, Exit Desktop Mode, Close Retro Play.
  9. Leave the joypad alone for a few minutes: the games’ videos play one after the other, like an arcade cabinet. A plays the one shown, any other button goes back.
  10. When you exit, the library is as you left it.
JoypadKeyboardWhat it does
D-pad · left stick← → ↑ ↓Move
A · ✕EnterOpen, confirm
B · ○Esc · BackspaceBack
X · □FFavorite
Y · △/ · Ctrl FSearch
LB RB · L1 R1Q ESection; on a game, previous and next game
LT RT · L2 R2PgUp PgDnPrevious and next letter
View · CreateTabInstalled games only; on a game, the whole description
Menu · OptionsMThe menu
F10Exit Desktop Mode

Good to know

  • The bottom always shows the buttons of your joypad (Xbox, PlayStation, Nintendo) or the keyboard’s keys.
  • A game not installed yet is installed right there, then Play now.
  • For a living-room PC: Settings → General → Open in Desktop Mode. There you also choose after how many minutes the attract mode starts, or never.
  1. In Settings → Appearance, under Desktop Mode themes, click a theme: it is used at once.
  2. Try in Desktop Mode (the joypad under each theme) opens Desktop Mode in it.
  3. In Desktop Mode, Menu → Theme changes theme with the joypad; RB shows its options: its Layout, a CRT, a color, music…
  4. The app comes with examples: Atlas, Neon Arcade, Horizon, Terminal.
  5. A theme can lay out every screen its own way: the games as a wheel, a gallery or a table of contents, each system in its own colors.
  6. New theme makes one of your own and opens it with its editor beside Desktop Mode: under Layout you choose how each screen is laid out.

Good to know

  1. Open the Settings and choose Phone.
  2. Turn on Open the library to the phones at home.
  3. Scan the QR code with the phone’s camera and tap the link.
  4. On the phone, the bar at the bottom leads to Games, Favorites, Platforms, Collections and, when you have one, Journeys.
  5. Tap a platform or a collection to see its games. Installed only keeps those already in the frontend.
  6. Tap a journey to see its steps one after the other, with their notes; tap a step to open its game.
  7. Tap a game: Play starts it on the computer, Install puts it in the frontend, the star makes it a favorite.
  8. While you play, the bar at the bottom shows the game and how long it’s been.
  9. Tap it: the phone becomes the game’s second screen, with the clock, your notes, the manual, the cheats on and the RetroAchievements.
  10. Write passwords or where you got to: the notes save by themselves and show on the game page too.

Good to know

  • The phone must be on the same Wi-Fi as the computer, and the app open.
  • The first time, Windows may ask for network access: allow it on private networks.
  • Add the page to the phone’s Home screen to have it at hand.

Safety

  • Only the phones of your network that scanned the code can open it. New code disconnects them all.
  • From the phone nothing can be deleted.
  1. Update saves shows up in the sidebar when some saves need seeing to. Click it.
  2. To keep safe: new saves, not in the archive yet. Click Archive.
  3. To bring back: the archive has newer ones. Click Resume.
  4. All up to date.

Tips

  • Update all does both in one click.
  • Before bringing a save back, the app archives what the frontend has: nothing is lost.
  • The Saves section on a game’s page shows all the archive’s copies.

Good to know

  • It works with RetroArch (in ES-DE, in RetroPie, in Batocera or on its own) and with MiSTer FPGA.
  • Between RetroArch and MiSTer only the game save goes over, for NES, Super Nintendo, Game Boy and Game Boy Color.
  • While RetroArch is open, saves aren’t brought back.
  1. Select the games and click Export.
  2. Choose what to export and the content: Games and metadata or Games only. Then Export.
  3. Done: Show in folder takes you to the file.

Good to know

  • Games and metadata can be brought back in with Import.
  • Games only: just the files, to copy where you play.
  • The export goes on in the background and can be stopped.
  1. Drag the .zip file onto the window (or use the arrow next to Add games → From an export).
  2. See what it holds and choose where it goes: Into the archive or into the frontend. Then Import.
  3. Import finished.
  4. The games are in the archive, with details and covers.

Good to know

  • For games already there, choose whether to update or replace them.
  • An import never deletes games.
  • From the start page you can install an export into the frontend even without opening an archive.
  1. Open the archive’s menu (its name, top left).
  2. Choose Verify with DATs…
  3. For each system click Choose DAT…, then Verify all.
  4. For each system you see how complete it is and the state of its games.
  5. At the top choose how to count: Every dump or One version per game.
  6. Missing… lists the DAT’s games you don’t have.
  7. One click on a state shows those games in the library.

The states

  • Verified the files match the DAT.
  • Bad dump the DAT marks it as bad.
  • Differs from the DAT there are files too many or missing.
  • Not in the DAT, Unverifiable (7z, CHD), To verify.

Good to know

  • Verifying is fast even on a NAS.
  • A game’s state is also on its page and in the Filters.
  1. Open the archive menu, at the top of the sidebar.
  2. Choose Check archive…: the check starts at once.
  3. You see the orphan media by system, and how much space they take.
  4. Click a system to see the files.
  5. Delete all, then confirm.
  6. It tells you how much space was freed.

Good to know

  • Orphans are left when a program replaces a cover without removing the old one, or when a game is taken out by hand.
  • Files written in the last minutes are left alone, and a file a game uses again before you confirm stays.
  • You also find it in the command palette.

Watch out

Deleted files can’t be brought back.

  1. Open the archive’s menu.
  2. Choose Make a report.
  3. Choose the theme, the order of the systems and the media shown: the preview updates.
  4. Press Save image… or Copy.

Good to know

  • It counts only the archive’s games.
  • If you verified systems against a DAT, it also shows how complete they are.
  1. Open the archive’s menu (the card at the top left) and choose Your retro year.
  2. The story goes on by itself. ← → or a click move it, the space bar pauses it.
  3. The hours you played, the games, your most played, your console of the year…
  4. …when you play, your decade, the oldest game.
  5. At the end, the card of your year and the kind of player you were: Save image or Copy to share it.

Good to know

  • It counts the games you start from the app, Desktop Mode or the phone: the more you play from here, the richer it gets.
  • In December and January a card above the covers reminds you. You turn it off in Settings → Library.
  • At the top right you pick another year.
  1. On retroachievements.org copy your Web API key. The button in Settings → RetroAchievements opens the right page.
  2. In Settings → RetroAchievements type your user name and the key, and press Save.
  3. The app looks the games up by itself. For a large archive: archive menu → RetroAchievements… → Look up all.
  4. Under each cover a trophy shows the achievements; it turns gold when you master the game.
  5. On the game page you find every achievement and your progress.

Good to know

  • Games on disc (PlayStation, Saturn…) and games in 7z aren’t recognised yet.
  • In the Filters there is RetroAchievements: games with achievements, started, mastered…
  1. Open the Settings.
  2. Go to MCP server.
  3. Turn the server on: it starts off.
  4. Copy for Claude Code copies the command to paste in a terminal. Copy JSON is for other clients.

What the AI can do

  • Search games and make statistics.
  • Fix details and media, scrape, manage versions, formats and collections.
  • Add, export, install and start games; manage saves and DATs.
  • Tell how long you played, find the media no game uses, and make a Desktop Mode theme from your description.

Safety

  • The server answers only from this PC and needs a secret token.
  • Before anything that can’t be undone, the AI shows you what it will do.
  • It works only while the app is open.
  1. Click the gear, top right.
  2. General: language (English or Italian), reopening the last archive, starting in Desktop Mode and its attract mode, updating at start.
  3. Under Windows: Start with Windows, and Close to tray so the X leaves the app running beside the clock.
  4. Library: preview on hover, On this day, What should I play today?, More like this, Your retro year, thumbnails.
  5. Appearance: theme and dark, light or system mode; the Desktop Mode themes.
  6. Here is the app in the light theme.

The themes

  • Default: the app’s own style.
  • Mica: the look of Windows 11, with Windows’ accent colour.

The other pages

  1. At start, a small window looks for a new version.
  2. If there is one, it downloads it and shows how far along it is.
  3. Open without waiting opens the app right away: the update installs when you close it.
  4. Then it installs it, and the app opens again updated.
  5. What’s new shows what the version brings, each novelty with its animation. Tick Don’t show again at start once you’ve seen it.
  6. An update ready to install shows as a green arrow at the top: click it to restart.
  7. In Settings → About you see the version, check by hand and reopen What’s new in this version.
  8. Release notes, beside it, opens the page with every version in your browser.
  9. Settings → General → Update at start turns the check on or off.

Good to know

  • Without internet the app simply opens, as always.
  • The portable version updates itself too: the new .exe takes the place of the old one, in the same folder and with the same name.

0.0.6

Latest 22 November 2026 Download

Add games by moving their files instead of copying them, and delete many games much faster.

  • Move instead of copy

    In Add games, Move the files instead of copying them empties the folder into the archive without taking twice the space. On the same disk it is almost instant. Off until you turn it on, and the app asks first.

And also

  • The files leave the folder only at the end, once the games are in the archive.
  • Deleting many games is much faster, with a bar showing how far it is.
  • Join all shows a bar and how many groups it has joined so far.

0.0.5

21 November 2026 Download

Choose the emulator and the command Retro Play starts your games with.

  • Emulators and commands

    For each system, the emulator Play starts its games with and its whole command line; a single game can have its own. ES-DE, RetroArch, RetroPie and Batocera. The frontend stays as it is.

And also

  • From a game’s menu, Emulator and command… opens them on that game.
  • Cheats turn on even when ES-DE’s command already gives RetroArch a configuration of its own.
  • RetroPie: the emulator chosen for a single game is now read right.

0.0.4

21 November 2026 Download

The portable version now updates itself too.

  • The portable updates itself

    Like the installed app: at start it downloads the new version and puts it in place of the old .exe, same folder, same name. Shortcuts and Start with Windows keep working.

And also

  • On a portable 0.0.3 or older? Download this version by hand once: from here on it updates itself.
  • If its folder can’t be changed, Settings → About says so and leads to the download page.

0.0.3

21 November 2026 Download

Themes for Desktop Mode, a world map of the companies, gaming journeys to share and the app starting with Windows.

  • Desktop Mode themes

    Colors, fonts, music, even what each screen is made of. Four themes included, an editor to make your own, and a guide to go further.

  • Company map

    The developers and publishers of your games on a world in the colors of the app. The missing places you set with a click.

  • Gaming journeys

    Games in a row, a note for each step. Shared as a .zip with no game files: whoever imports it plays the steps they have.

  • Start with Windows

    The app opens when you sign in and, closed, stays beside the clock.

And also

  • Journeys in Desktop Mode and on the phone too.
  • The app is in English by default: Italian is in Settings → General.
  • View buttons in two groups; the cover size sits at the bottom right of the grid.
  • Clearer More settings, each area in a panel of its own, and the release notes in Settings → About.
  • New MCP tools: themes, company map, journeys.

0.0.2

19 November 2026 Download

Your retro year, cheats, the phone as a second screen and a palette to do it all from the keyboard.

  • Your retro year

    Hours, favorite games and consoles, the times you play: your year told as a story, down to a card to share.

  • Play time

    The app times the games you start from it, on every frontend.

  • Cheats

    Find a game’s cheats in the libretro database, turn on the ones you want, and they start with the game. For RetroArch.

  • The phone as a second screen

    While you play: the clock, your notes, the manual, the cheats on and the RetroAchievements.

  • Command palette

    Ctrl K and a few letters: games, systems, views, settings and actions in one box.

  • More like this

    At the foot of each game’s page, the games of your archive most like it.

  • Discord status

    Your friends see what you’re playing. Off until you turn it on.

  • Check archive

    Finds the media no game uses any more and deletes them in one click.

And also

  • Desktop Mode: leave the joypad alone and the games’ videos play.
  • If a game doesn’t start, the app tells you why.
  • Notes for each game, on its page and on the phone.
  • The What’s new window after each update.
  • New MCP tools: cheats, notes, similar games, retro year, unused media.

0.0.1

19 November 2026 Download

The first public version: your retro games, tidy and ready to play.

And also

  1. The arrows move you between games.
  2. Enter opens the highlighted game.
  3. On the page, ← → go to the previous and next game.
  4. Esc goes back to the library.
  5. Ctrl F goes to the search.
KeysWhat they do
Ctrl OOpen an archive
Ctrl FSearch
Ctrl KThe command palette
F5 · Ctrl RRead the archive again (when nothing else is in progress)
← → ↑ ↓Move between games
EnterOpen the highlighted game
← →On a game page: previous or next game
Esc · Alt ←Back to the library
Ctrl+click · Shift+click · Ctrl ASelect several games
Ctrl SSave the details
Right click · Menu · Shift F10The game menu
DelDelete the selected games
F10Into and out of Desktop Mode
Archive

The folder with your games and everything that describes them. What it looks like.

Frontend

The program or hardware you play on: ES-DE, MiSTer FPGA, RetroArch, RetroPie, Batocera.

ES-DE

EmulationStation Desktop Edition: the PC frontend that starts the emulators.

MiSTer FPGA

Hardware that recreates consoles instead of emulating them.

ROM

The file of a game: a cartridge, a disc, a floppy.

Details

Title, description, release date, developer, publisher, genre, players, rating.

Media

Covers, screenshots, logos, fan art, videos, manuals.

Metadata

Details and media together.

Details and media

The percentage beside a game: how much information it has, not how far you played it.

Marquee

The game’s logo, on a transparent background.

Fan art

A large picture of the game, used as the background of its page.

Scraping

Getting details and media automatically from an online service.

Collection

A list of games made by hand, kept in the archive. Collections.

Version

A variant of the same game: USA, Europe, Rev 1, v1.2…

Format

A kind of file of the same game: LHA or ADF, CUE or CHD, ZIP… Two versions both in ZIP are one format.

ROM Set

The arcade games of one MAME version (e.g. 0.289).

DAT

The list of a system’s good dumps, to check your files.

CRC

A file’s fingerprint: two files with the same CRC are the same.

Export

A .zip file with games, to import elsewhere.

To archive

A game only the frontend has, not the archive.

Save

A game’s progress.

MCP

The protocol an AI assistant uses to work with the app’s tools.

If I edit a game in the app, does it change in ES-DE too?

Not right away: the change goes into the archive. ES-DE gets it when you install the game again.

Can I use the archive from several computers?

Yes, for example from a NAS. If two PCs change the same game, the app asks what to do. F5 reads the archive again.

Does uninstalling a game delete it?

No, it only removes it from the frontend: it stays in the archive. To delete it, use Delete from the archive.

Why does a game say «Cannot be installed»?

The frontend can’t load it: it doesn’t have that system, it takes none of the game’s formats (see Compatible formats), or it is an arcade game of another ROM Set. The tooltip says why. When it’s only the format, Install anyway installs it all the same.

Do I need an account for scraping?

For automatic scraping yes, a ScreenScraper account. To look things up on the web by hand, no.

Can I lose my saves?

No: the copies in the archive are never overwritten, and before bringing one back the app archives the frontend’s.

What languages is the app in?

English, the default, and Italian: switch in Settings → General → Language.

How do I update the app?

It does it by itself: at start it downloads and installs the new version. See Updates.

Windows warns me the first time I start it, is that normal?

Yes: the app isn’t signed, so the first time SmartScreen asks for confirmation.