{"id":13494678,"url":"https://github.com/n1ckoates/steamdeck-emulation","last_synced_at":"2025-03-28T14:31:41.160Z","repository":{"id":37003454,"uuid":"467177905","full_name":"n1ckoates/steamdeck-emulation","owner":"n1ckoates","description":"🎮 Guide to play emulated games on Steam Deck","archived":true,"fork":false,"pushed_at":"2023-07-11T23:29:10.000Z","size":71,"stargazers_count":623,"open_issues_count":0,"forks_count":26,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-11-07T16:03:10.572Z","etag":null,"topics":["dolphin","emulation","emulator","guide","hacktoberfest","linux","nintendo","pcsx2","steam","steamdeck","yuzu"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/n1ckoates.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2022-03-07T16:43:30.000Z","updated_at":"2024-11-06T13:37:46.000Z","dependencies_parsed_at":"2024-01-06T00:04:18.140Z","dependency_job_id":"f3ef975d-0001-4f29-9297-0e9692a4dc54","html_url":"https://github.com/n1ckoates/steamdeck-emulation","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n1ckoates%2Fsteamdeck-emulation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n1ckoates%2Fsteamdeck-emulation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n1ckoates%2Fsteamdeck-emulation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n1ckoates%2Fsteamdeck-emulation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/n1ckoates","download_url":"https://codeload.github.com/n1ckoates/steamdeck-emulation/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246046053,"owners_count":20714893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dolphin","emulation","emulator","guide","hacktoberfest","linux","nintendo","pcsx2","steam","steamdeck","yuzu"],"created_at":"2024-07-31T19:01:27.119Z","updated_at":"2025-03-28T14:31:40.788Z","avatar_url":"https://github.com/n1ckoates.png","language":null,"funding_links":[],"categories":["Others"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eSteam Deck Emulation Guide\u003c/h1\u003e\n\nThis guide covers how to install emulators on a Steam Deck, setting up controls, playing games with optimal settings, and integrating them into Steam itself. It uses [Steam ROM Manager](https://steamgriddb.github.io/steam-rom-manager/), which automatically downloads cover art for each game and adds a shortcut to Steam. The end result will look like this, with Steam collections for each system:\n\n![A screenshot of the Steam Deck interface showing a library of various emulated video games.](https://github.com/n1ckoates/steamdeck-emulation/assets/58091943/bc18a983-265b-45da-a371-2e811436123c)\n\n**This is an unofficial guide**, not affiliated with Valve or any of the emulator developers. To my knowledge, it's not possible to mess up your Deck from this guide, but I take no responsibility if you do. This guide **does not** cover getting ROMs or other copyrighted material.\n\n\u003e **Want to automate all of this?** Check out [EmuDeck](https://www.emudeck.com/), a program that sets all of this - and more - up for you.\n\n### Current Systems Supported\n\n-   [x] Nintendo Switch (Yuzu)\n-   [x] Wii (Dolphin)\n-   [x] GameCube (Dolphin)\n-   [x] Nintendo 64 (simple64)\n-   [x] SNES (Snes9x)\n-   [x] PlayStation 2 (PCSX2)\n-   [x] 3DS (Citra)\n-   [x] DS (melonDS)\n-   [x] PSP (PPSSPP)\n-   [x] PC Engine (CD) / TurboGrafx-16 (-CD) / SuperGrafx (Mednaffe)\n\n[Open a GitHub issue](https://github.com/nchristopher/steamdeck-emulation/issues/new) to request support for a system.\n\n### Storage\n\nThis guide assumes your ROMs are under `~/roms` (a folder in your home directory), with a file structure like this:\n\n```\nroms\n├── switch\n├── wii\n├── gamecube\n├── n64\n├── snes\n├── ps2\n├── 3ds\n├── ds\n├── psp\n└── pce\n```\n\n### SD Cards\n\nIf you store your roms on an SD card, substitute `~/roms` with `/run/media/mmcblk0p1/roms` in each guide. You'll have to give each Flatpak access to your SD card. Open up a terminal and run\n\n```bash\nflatpak override \u003cemulator\u003e --filesystem=/run/media/\n```\n\nSubstitute `\u003cemulator\u003e` with the emulator's Flatpak name (specified in each guide). For example, Snes9x's Flatpak name is `com.snes9x.Snes9x`, so you'd run\n\n```bash\nflatpak override com.snes9x.Snes9x --filesystem=/run/media/\n```\n\n## Getting Started\n\nTo start off, switch to Desktop mode by pressing the **Steam** button, navigating to **Power**, then **Switch to Desktop**.\n\nOpen Firefox, then navigate to [Steam ROM Manager's latest release](https://github.com/SteamGridDB/steam-rom-manager/releases/latest), and download the file ending in `.AppImage` that **DOES NOT** contain `i386`. It should be named something like `Steam-ROM-Manager-2.3.40.AppImage`.\n\nOpen SteamOS' file manager Dolphin (it's different from the emulator Dolphin), then navigate to wherever you saved the file, probably in **Downloads**. You can run it by just double-tapping the file. If prompted for Steam's directory, enter `/home/deck/.local/share/Steam`.\n\nFrom here, the guide branches off for each system you want to emulate:\n\n-   [Nintendo Switch](./emulators/yuzu.md)\n-   [GameCube and/or Wii](./emulators/dolphin.md)\n-   [Nintendo 64](./emulators/simple64.md)\n-   [SNES](./emulators/snes9x.md)\n-   [PC Engine (CD) / TurboGrafx-16 (-CD) / SuperGrafx](./emulators/mednaffe.md)\n-   [PlayStation 2](./emulators/pcsx2.md)\n-   [Nintendo DS](./emulators/melonds.md)\n-   [Nintendo 3DS](./emulators/citra.md)\n-   [PlayStation Portable (PSP)](./emulators/ppsspp.md)\n\n## ⚠ Common Issues\n\n-   If you've successfully performed the setup steps for an emulator but you get a blank screen when booting a ROM, the emulator may not have access to your ROMs directory. Open a terminal and run `flatpak override \u003cname\u003e --filesystem=~/roms` to allow it to find your ROMs. Replace `\u003cname\u003e` with the Flatpak name found in the guide for the emulator.\n\n## ❓ Support\n\nIf you need any help, try asking in the `#emulation` channel over in the [Steam Deck Discord](https://discord.gg/myS7JkUtvA).\n\n## 📜 License\n\nCopyright \u0026copy; 2022-2023 Nicholas Christopher\n\nUnless otherwise stated, this guide is licensed under [Creative Commons BY 4.0](https://creativecommons.org/licenses/by/4.0/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fn1ckoates%2Fsteamdeck-emulation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fn1ckoates%2Fsteamdeck-emulation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fn1ckoates%2Fsteamdeck-emulation/lists"}