EmuDeck Setup Guide: Steam Deck Emulation in 2025

EmuDeck is the fastest way to turn a Steam Deck into a full retro gaming machine. Instead of manually installing and configuring dozens of emulators one by one, EmuDeck runs a single installer script that sets up everything — RetroArch, Dolphin, PCSX2, PPSSPP, and more — with sane defaults, correct aspect ratios, and unified controller mappings out of the box. If you own a Steam Deck OLED or the original LCD model, this guide takes you from a fresh machine to a fully configured retro library.

Affiliate disclosure: As an Amazon Associate I earn from qualifying purchases at no extra cost to you. Links below help keep this site running.

What Is EmuDeck?

EmuDeck is not an emulator — it's an installer and configuration manager. It downloads each emulator from its official source, writes optimized configuration files for the Steam Deck's hardware, creates a standardized folder structure for your ROMs and BIOS files, and wires everything into Steam ROM Manager so your games show up in your Steam library with cover art.

Without EmuDeck, getting emulation working on the Steam Deck looks like this: install RetroArch via Flatpak, configure your cores manually, install Dolphin separately, configure Dolphin manually, repeat for PCSX2, PPSSPP, Citra, and six other emulators, then figure out how to get any of them into Game Mode. With EmuDeck, you run one script and answer a few questions.

The main alternatives and why EmuDeck wins for most people:

• Manual setup — Full control, but hours of configuration work and no easy update path. Only worth it if you have a specific emulator need EmuDeck doesn't cover well.
• RetroDeck — A single Flatpak bundle that contains all emulators in one sandboxed app. Easier to install but less flexible; see the comparison below.
• Batocera — A standalone Linux OS focused on emulation. Excellent emulation experience but requires dual-booting or replacing SteamOS entirely, losing access to your Steam library.

EmuDeck vs RetroDeck

Feature	EmuDeck	RetroDeck
Install method	Script + individual Flatpaks	Single Flatpak bundle
Update path	Per-emulator or via EmuDeck app	Update the RetroDeck Flatpak
Steam integration	Steam ROM Manager (full cover art)	Launcher shortcut only
Settings access	Native per-emulator menus	Configurator tool
Standalone emulators	Yes (Dolphin, PCSX2, PPSSPP, etc.)	Yes (bundled)
Best for	Most users who want full control	Users who want one-click simplicity

Bottom line: EmuDeck is the right choice for most people. RetroDeck has its place if you want the absolute simplest install and don't need games appearing natively in your Steam library.

What You Need

• A Steam Deck (any model — LCD or OLED). The Steam Deck OLED is the recommended pick for its battery life and screen.
• A stable WiFi connection — the installer downloads several gigabytes of emulator packages.
• Storage space — decide now whether to install to internal storage or a microSD card.

Internal vs microSD: Where to Put Your Games

Internal storage (default Steam Deck): Fast NVMe speeds, no extra hardware needed. Fine if you have a 512 GB or 1 TB model and don't mind sharing space with your Steam games.

microSD card: Keeps your emulation library separate from your Steam games. Easy to move between devices. Slightly slower reads than NVMe, but more than fast enough for everything up to PS2 and GameCube. Recommended for large libraries or if you have a 64/256 GB model.

If you're using a microSD card, get a fast one — slow cards cause stutter in GameCube and PS2 games. The Samsung Pro Plus 512 GB microSD(affiliate link) is the top recommendation: rated A2 speed class, reliable, and fast enough for any system EmuDeck supports.

Tip: You don't have to decide right now. EmuDeck will ask you which drive to use during setup, and you can change it later by rerunning the installer.

Step 1: Prepare Your Storage

If using internal storage: Nothing to do. Skip to Step 2.

If using a microSD card:

1. Insert the card into the Steam Deck's card slot (bottom edge, under the kickstand)
2. Power on the Steam Deck and switch to Desktop Mode (see Step 2)
3. Open the Dolphin file manager from the taskbar
4. Right-click the card and select Format
5. Choose ext4 as the filesystem and confirm

EmuDeck can also format the card during its own setup process — if you skip this step, the installer will handle it.

Step 2: Switch to Desktop Mode

EmuDeck's installer runs in Desktop Mode — the full KDE Plasma Linux desktop that lives underneath SteamOS.

1. Press the Steam button on your Steam Deck
2. Scroll down to Power
3. Select Switch to Desktop

The screen will briefly go black and then drop you into KDE Plasma. You'll have access to a web browser (Firefox), a file manager (Dolphin), and a terminal (Konsole). Use the right trackpad as a mouse and the right trigger as a left click — or connect a USB-C hub with a keyboard and mouse for easier navigation.

Note: You can also connect a Bluetooth keyboard and mouse before switching modes. Press Steam + X to bring up the virtual keyboard if you need to type without one.

Step 3: Download and Run the EmuDeck Installer

1. Open Firefox from the taskbar or application launcher
2. Go to emudeck.com and click the Download button
3. Save the file to your Downloads folder — it will be named something like EmuDeck.desktop
4. Open the Dolphin file manager and navigate to your Downloads folder
5. Right-click EmuDeck.desktop and select Run (or double-click it)

The EmuDeck installer GUI will launch. If nothing happens on double-click, open Konsole and run:

cd ~/Downloads && chmod +x EmuDeck.desktop && ./EmuDeck.desktop

Warning: Only download EmuDeck from the official emudeck.com website. Third-party mirrors may bundle outdated or modified versions.

Step 4: Easy Mode vs Custom Mode

The installer opens with a choice between Easy Mode and Custom Mode.

Easy Mode installs everything with one click using EmuDeck's default settings. It assumes you want to install to your microSD card if one is present, and it enables every emulator. This sounds ideal but has a catch: if your card isn't formatted correctly or you want to install to internal storage, Easy Mode may not do what you expect.

Custom Mode walks you through the same installation but prompts you at each decision point:

• Which drive to install to (internal or microSD)
• Which emulators to enable or skip
• Aspect ratio preferences (4:3 vs widescreen where applicable)
• Bezels and borders for 4:3 content

Recommendation: choose Custom Mode, even if you're a complete beginner. The extra prompts take about two minutes and ensure EmuDeck puts your games exactly where you want them. Every question has a clearly labeled recommended default — you can accept all of them and still get the same result as Easy Mode, but with the storage question answered correctly.

Tip: You can rerun the EmuDeck installer at any time to change any of these settings. Nothing is permanent.

Step 5: The Folder Structure EmuDeck Creates

After installation, EmuDeck creates a standardized folder tree. On microSD this lives at /run/media/mmcblk0p1/Emulation/; on internal storage at ~/Emulation/.

Emulation/
├── bios/          ← BIOS files go here
├── roms/          ← ROM files, organized by system
│   ├── gba/
│   ├── snes/
│   ├── psx/
│   ├── n64/
│   ├── ps2/
│   ├── gc/
│   ├── wii/
│   ├── nds/
│   ├── psp/
│   └── (many more)
├── saves/         ← Save files and save states
└── storage/       ← Emulator-specific data

Key ROM folder names to know:

System	Folder name
Game Boy Advance	gba
Super Nintendo	snes
Nintendo 64	n64
Nintendo DS	nds
PlayStation 1	psx
PlayStation 2	ps2
PSP	psp
GameCube	gc
Wii	wii
Sega Genesis	genesis
Game Boy / GBC	gb / gbc

The full list is visible inside the roms/ folder once EmuDeck has run.

Step 6: Adding BIOS Files

A BIOS is the original firmware that shipped inside a console — the low-level code that boots the system. Some emulators require it to run games at all; others use it for higher accuracy. EmuDeck cannot include BIOS files for legal reasons. You need to provide your own, sourced from consoles you own.

Place BIOS files directly into the Emulation/bios/ folder. Filenames are case-sensitive.

System	BIOS filename(s)	Required?
PlayStation 1	scph1001.bin	Required
PlayStation 2	ps2-0200a-20040614.bin (or similar)	Required
Sega CD	bios_CD_U.bin, bios_CD_E.bin, bios_CD_J.bin	Required
Nintendo DS	bios7.bin, bios9.bin, firmware.bin	Required
Game Boy Advance	gba_bios.bin	Optional

For a deeper explanation of what BIOS files are and the legal landscape around them, see the RetroArch setup guide.

Note: Only use BIOS files dumped from consoles you personally own. EmuDeck's BIOS Checker tool (in the EmuDeck app) will confirm which files are present and correctly named.

Step 7: Adding Your Game Library

Copy your ROM files into the appropriate system subfolder inside Emulation/roms/. Only add games from your own collection.

Three ways to transfer files:

USB drive or hub: Connect a USB-C hub with a USB-A port to the Steam Deck. Plug in your drive, navigate to it in the Dolphin file manager, and drag files to the correct roms/ subfolders.

Network transfer (recommended for large libraries): With the Steam Deck and your PC on the same WiFi network, you can transfer files via SFTP. Open a terminal on your PC and use any SFTP client (FileZilla, WinSCP, Cyberduck) to connect to the Steam Deck's IP address on port 22. The default username is deck — you'll need to set a password first in Desktop Mode via System Settings → Users.

microSD directly: If your games are already on a microSD card from another device, format a copy on the Steam Deck-compatible card and copy the folder structure over before inserting.

After copying files, you don't need to trigger a rescan manually — Steam ROM Manager (next step) reads the folders directly.

Step 8: Steam ROM Manager

Steam ROM Manager is the tool that adds your games to your Steam library with cover art, metadata, and proper launch shortcuts. Without it, you can still launch games from Desktop Mode, but they won't appear in Game Mode's library.

1. In Desktop Mode, open the EmuDeck app from the desktop or application launcher
2. Click Steam ROM Manager
3. Steam ROM Manager will warn you to close Steam before continuing — do this
4. In Steam ROM Manager, verify that the parsers for your systems are toggled on (they are by default)
5. Click Preview in the left sidebar
6. Click Generate App List — this scans your ROM folders and pulls artwork from online databases
7. Review the results. Most games will have cover art populated automatically. You can manually fix any that didn't match.
8. Click Save App List to write the shortcuts to Steam

Warning: The "Save App List" step can take several minutes if you have a large library. Don't close Steam ROM Manager while it's writing. When it finishes, reopen Steam and switch back to Game Mode.

Step 9: Launching Games from Game Mode

1. Press the Steam button or tap Return to Gaming Mode on the Desktop
2. In your Steam library, scroll to the Non-Steam section — or look for system-named collections like "Nintendo 64" or "PlayStation"
3. Select any game to launch it

Each game launches through its configured emulator automatically. You don't need to select a core or emulator manually — EmuDeck has already set the correct one for each system.

The Steam button still works in-game: it opens the Steam overlay, which gives you access to screenshots, the on-screen keyboard, and performance overlays. The emulator's own menu (for save states, shaders, etc.) is accessed separately — usually via the Select + Start combination or the emulator's configured hotkey.

Step 10: Updating EmuDeck

EmuDeck and its emulators update independently.

Update EmuDeck itself:

1. Switch to Desktop Mode
2. Open the EmuDeck app
3. Click Manage Emulators → Update All

This updates EmuDeck's configuration scripts and pulls the latest versions of each installed emulator Flatpak.

Individual emulators can also be updated via the Discover software center in KDE Plasma, which lists all installed Flatpaks.

Check for updates after major SteamOS updates. Valve's SteamOS updates occasionally change system paths or Flatpak sandboxing rules that can break emulator configs. Running the EmuDeck updater after a SteamOS update fixes most issues automatically.

RetroArch-Based Cores vs Standalone Emulators

EmuDeck installs two categories of emulators, and understanding the difference helps when you need to tweak settings.

RetroArch cores handle most older systems. RetroArch provides the interface — save states, shaders, rewind, controller remapping — while the core handles the actual emulation. For a full explanation of how RetroArch works, see the RetroArch setup guide.

Standalone emulators are used for systems that run better outside of RetroArch. These have their own settings menus accessed from the EmuDeck app or directly in Desktop Mode.

System	Emulator	Type	Notes
NES	Nestopia UE	RetroArch core	Accurate, low overhead
SNES	Snes9x	RetroArch core	Best compatibility
Game Boy / GBC	Gambatte	RetroArch core	Accurate color palettes
Game Boy Advance	mGBA	RetroArch core	Best GBA core available
Nintendo 64	Mupen64Plus-Next	RetroArch core	Most compatible
Sega Genesis	Genesis Plus GX	RetroArch core	Excellent compatibility
PlayStation 1	PCSX ReARMed	RetroArch core	Best for ARM-adjacent hardware
Nintendo DS	melonDS	RetroArch core	Good DS accuracy
PSP	PPSSPP	Standalone	Better performance standalone
GameCube / Wii	Dolphin	Standalone	Required for full speed
PlayStation 2	PCSX2	Standalone	Required for compatibility
3DS	Citra / Lime3DS	Standalone	Better settings control

You don't need to manually select these — EmuDeck configures the right emulator for each system automatically when it creates your Steam ROM Manager shortcuts.

RetroAchievements

RetroAchievements adds achievement systems to classic games via RetroArch. EmuDeck sets up RetroArch correctly for achievement support — you just need to log in. See the RetroAchievements setup guide for account creation and enabling achievements per-core.

Related Guides

• Steam Deck OLED Review — The hardware this guide is built for
• How to Set Up RetroArch — Deep dive into cores, shaders, save states, and BIOS files
• How to Set Up RetroAchievements — Add achievements to your retro library