emudeck not launching fix

EmuDeck won’t open, or the shortcut does nothing. On the Steam Deck especially this shows up as “EmuDeck not launching” and “EmuDeck not launching on Steam Deck” — almost always a broken path, not a broken install.

1. The shortcut points at a dead path

EmuDeck’s Steam shortcut calls a script by an absolute path. After an update or a moved SD card, that path is gone and clicking does nothing.

1. Re-run the EmuDeck installer
   Run the installer again — it rewrites the launcher and the Steam shortcut to the current paths. Your existing config and ROMs stay put; this just fixes the entry point.
   The EmuDeck shortcut opens the app instead of doing nothing.
2. If on SD card, confirm the card is mounted
   On Steam Deck, EmuDeck often lives on the microSD. If the card didn't mount, every path is dead. Eject and reinsert, or move the install to internal storage.
   The SD card shows as mounted before you launch.

2. Steam or a script is blocking it

1. Close Steam and the parsing step, then retry
   Steam ROM Manager's parser can lock files or hang, which blocks the EmuDeck app from opening. Close Steam fully (not just the window) and retry.
   EmuDeck opens without a hang.
2. Check the parsed ROM folder
   If EmuDeck opens but games won't launch, the parsed folder is empty or wrong — see ROMs not showing. That's a different symptom from the app itself not opening.
   Your ROM directory is set and contains games.

If controls are the real problem

When EmuDeck opens fine but inputs don’t register in games, that’s the emulator inside it, not EmuDeck — see EmuDeck controls not working.