How to Set Up EmuDeck on Steam Deck — Complete Guide 2026

What EmuDeck is: EmuDeck is NOT an emulator — it's a setup and configuration manager. When you run it, EmuDeck (1) creates a standard folder structure for ROMs and BIOS files, (2) installs emulators as Flatpaks from Flathub, (3) configures each emulator with optimised Steam Deck settings, and (4) installs ES-DE, a unified frontend for all your games. Because it uses Flatpaks, EmuDeck installs cleanly into your home directory and survives SteamOS updates without touching the read-only system partition.

Step 1 — Switch to Desktop Mode:

EmuDeck requires Desktop Mode. Press the Steam button → Power → Switch to Desktop. The Steam Deck reloads into KDE Plasma. Connect a keyboard/mouse via USB-C or Bluetooth for easier navigation, or use the on-screen keyboard and touchpad.

Step 2 — Download and launch EmuDeck:

1. Open Firefox and go to emudeck.com → download the Steam Deck / Linux AppImage
2. Open Konsole (terminal) from the app launcher
3. Make it executable: chmod +x ~/Downloads/EmuDeck.AppImage
4. Double-click the AppImage in the file manager or Desktop to launch the setup wizard

If EmuDeck won't open after chmod+x: right-click → Properties → Permissions → tick "Is executable", then try again. For deeper issues, see EmuDeck not installing fix.

Step 3 — Run the setup wizard:

• Easy Mode (recommended): installs a curated set of emulators with optimised defaults — choose this unless you have specific requirements
• Expert Mode: lets you choose which emulators to install and customise paths during setup

The wizard asks where to store ROMs:

• Internal storage: ROMs go to ~/Emulation/roms/ on the internal drive
• MicroSD card (recommended for large libraries): path will be /run/media/mmcblk0p1/Emulation/roms/

Click Install. EmuDeck downloads and configures all emulators. Expect 10–20 minutes depending on internet speed.

Emulators installed (Easy Mode):

• PS1: DuckStation | PS2: PCSX2 | PS3: RPCS3 | PSP: PPSSPP | PS Vita: Vita3K
• GameCube/Wii: Dolphin | Wii U: Cemu | Switch: Eden (current community fork — Yuzu/Ryujinx both shut down 2024)
• Nintendo DS: melonDS | Nintendo 3DS: Lime3DS | GBA/SNES/NES/N64+: RetroArch

ROM folder structure: after setup, open the file manager and navigate to your ROM directory. EmuDeck creates system subfolders automatically:

• ~/Emulation/roms/psx/ — PlayStation 1
• ~/Emulation/roms/ps2/ — PlayStation 2
• ~/Emulation/roms/ps3/ — PlayStation 3 (folder-based installs)
• ~/Emulation/roms/gc/ — GameCube | wii/ — Wii | wiiu/ — Wii U
• ~/Emulation/roms/switch/ — Switch | 3ds/ — 3DS | nds/ — DS | gba/ — GBA
• ~/Emulation/roms/psp/ — PSP | snes/ — SNES | nes/ — NES | n64/ — N64

Copy your ROM files into the correct system folder. Recommended formats:

• PS1: CHD or BIN/CUE | PS2: CHD or ISO | GameCube/Wii: RVZ or ISO | Switch: XCI or NSP
• GBA/SNES/NES: ZIP or uncompressed | PSP: ISO or CSO

CHD and RVZ are compressed formats that save disk space without quality loss. Convert ISOs with chdman (for PS1/PS2) or Dolphin's compression tool (for GC/Wii).

BIOS file placement: emulators that require BIOS files look in ~/Emulation/bios/. Copy your BIOS files here. Key requirements by system:

• PS1 (DuckStation): requires a PS1 BIOS file (e.g. scph5501.bin for US region)
• PS2 (PCSX2): requires a PS2 BIOS file (e.g. ps2-0230j-20080220.bin)
• PS3 (RPCS3): installs firmware from a .PUP file downloaded from Sony's official website — not placed in bios/
• Switch (Eden): requires prod.keys and firmware files
• GameCube/Wii (Dolphin): BIOS optional — most games run without it
• GBA (RetroArch/mGBA): BIOS optional for most games

EmuDeck does not provide BIOS files. Dump them from hardware you own.

This is the step most new users miss. EmuDeck does not automatically add your games to Steam — you need to run the Add to Steam tool after placing your ROMs.

Option A — ES-DE (recommended for most users):

Instead of adding hundreds of individual shortcuts, add ES-DE once as a single Steam entry, then browse all your games from inside it.

1. Open EmuDeck (run the AppImage again) → Tools and Stuff → Add to Steam
2. Tick ES-DE and click Add to Steam
3. Switch to Game Mode — ES-DE appears in your library under Non-Steam games
4. Launch ES-DE — it scans your ROM folders and shows your full library sorted by system

Option B — Steam ROM Manager (individual shortcuts):

Adds each game as its own shortcut with boxart and metadata.

1. Open EmuDeck → Steam ROM Manager
2. Toggle parsers for the systems you want, click Preview → Generate App List
3. Steam ROM Manager matches your ROMs to boxart from online databases
4. Click Save to Steam (Steam must be closed first)

Configure Game Mode controller layouts:

From Game Mode, launch ES-DE or any emulator → press Steam button → Controller Settings → Browse Community Layouts → search "EmuDeck" → apply the recommended community layout.

EmuDeck default hotkeys (require the community layout or custom mapping):

• Select + Start → exit emulator (return to ES-DE)
• Select + R1 → save state | Select + L1 → load state
• Select + A → pause/resume | Select + Y → quick menu / RetroAchievements

Keeping EmuDeck and emulators updated:

• EmuDeck itself: re-run the AppImage when a new version releases — it updates its own configuration scripts
• Emulators (Flatpaks): open Desktop Mode → open Discover (software centre) → check for Flatpak updates; or run flatpak update in Konsole
• RetroArch cores: open RetroArch → Online Updater → Update Installed Cores. For core download issues, see RetroArch Online Updater fix

Common issues:

• EmuDeck AppImage won't open: chmod +x step missed, or right-click → Properties → Permissions → tick "Is executable"; see EmuDeck not installing fix
• Games not showing in ES-DE: ROMs in wrong subfolder — double-check the system folder (e.g. PS2 ROMs go in roms/ps2/ not roms/PlayStation2/); re-run ES-DE scanner from its main menu
• Emulator launches but game is black screen: missing BIOS file — place the correct file in ~/Emulation/bios/ and check the per-emulator guide for the exact filename
• Games show in ES-DE but not Game Mode: run Add to Steam / Steam ROM Manager step; Steam ROM Manager requires Steam closed while running
• Hotkeys not working in Game Mode: Steam Deck controller layout not applied — browse community layouts and apply the EmuDeck layout
• RPCS3 PS3 game needs firmware: download the official PS3 firmware .PUP from Sony's website, open RPCS3, go to File → Install Firmware
• Switch games not launching (Eden): missing prod.keys — keys must be placed in Eden's keys directory (check Eden setup guide for exact path)
• MicroSD ROMs not found after reboot: SD card mount path can change — re-run EmuDeck setup to re-point to the current SD card mount point