# How-to: Install RetroDECK on the Linux Desktop --- ## **Before you begin start here** - [RetroDECK: Start Using](../../wiki_general/retrodeck-start.md). --- ## **TIP: Game Mode on Linux PCs** Steam Deck's **Game Mode** can be used on some Linux distributions. It helps: - Mitigate Input issues. - Provide the best RetroDECK experience. - Allow seamless Steam controller support. Here is a list of some distributions that support Game Mode: **Bazzite** - [Bazzite Webpage](https://bazzite.gg/) **Chimera OS** - [ChimeraOS Webpage](https://chimeraos.org/) - [ChimeraOS Wiki](https://github.com/ChimeraOS/chimeraos/wiki) **Nobara** - [Nobara Webpage](https://nobaraproject.org/download-nobara/) - [Nobara Wiki](https://wiki.nobaraproject.org) --- ## Prerequisites - Linux Desktop ### (Optional) Add to Steam It's recommended to add and launch RetroDECK via Steam to utilize Steam Input for external controllers during installation. --- ### Flatpak Support Ensure Flatpak is installed on your Linux system. Follow the official guide for your distribution: [Flatpak Setup Guide](https://flatpak.org/setup/) --- ### Steam: steam-devices Package > **Note:** Not required for SteamOS-based devices (e.g., Steam Deck) or gaming distributions like Bazzite, Chimera, Nobara, etc. - The `steam-devices` package is usually included with Steam on most distributions. - Required for Steam to detect controllers. - Steam will warn you if it is missing. - Install via your distribution's package manager if needed. --- ### Enable Steam Input for Controllers > **Note:** Not required for SteamOS-based devices (e.g., Steam Deck) or gaming distributions like Bazzite, Chimera, Nobara, etc. 1. Open Steam and click the **Steam** menu. 2. Navigate to **Settings → Controller**. 3. Enable Steam Input for all controllers: Xbox, PlayStation, Switch Pro, Generic. 4. Close Settings. --- ## Step-by-Step Guide to Install RetroDECK on the Linux Desktop **For your:** - HTPC - Gaming PC - PC-Console (Steam Machine) - Desktop --- ### **Install RetroDECK** Discover logo **Via an App Store** 1. Open your Flatpak-supported software manager (e.g., GNOME Software, KDE Discover, Bazaar). 2. Search for `RetroDECK` and click **Install**. **From the Terminal** Run the following command: `flatpak install net.retrodeck.retrodeck` --- ### **Launch RetroDECK for the first time** After installation from `Discover / Bazaar / Gnome Software`. Launch RetroDECK from `Discover / Bazaar / Gnome Software` or the `Software / Program Menu` under `Games` → `RetroDECK`. --- ### **Choose where to create the retrodeck/ folder** **Choose between:** - `Home Directory` - `Custom Location` --- ### **(Optional, but recommended) Add RetroDECK to Steam and Steam Controller Templates** When asked, we recommend that you select: **Yes**. RetroDECK will appear in Game Mode under **Library → Non-Steam** --- ### **(Optional) Download Firmware** RetroDECK can download firmware **only from officially distributed sources**. An active internet connection is required. After the firmware installation is complete, be sure to **close the component’s window or it's pop-ups** to finish the process. --- ### **(Optional) Enable Steam Synchronization** Srm logo This prompt appears **only if RetroDECK has been added to Steam**. Enabling Steam synchronization will scan your game library for any 🌟 **Favorited** 🌟 titles in ES-DE and automatically add them to your Steam library as individual entries. --- ### **Installation Complete: Return to Desktop or Start RetroDECK** Press **Return to Desktop** or **Start RetroDECK**. **If you have added RetroDECK to Steam:** you will need to **restart Steam** for the changes to take effect. --- ## **Adding ROMs / Games / Ports** Add your games following ES-DE’s clean and organized folder structure. This ensures that systems appear correctly in the frontend. Put ROMs / Games in the matching system folder under: `retrodeck/roms/` **Examples:** - `retrodeck/roms/nes/ExampleNESGame.nes` - `retrodeck/roms/doom/DOOM.WAD` - `retrodeck/roms/openbor/He-Man.openbor` **For Ports** RetroDECK’s **PortMaster component** manages native ports. You can: - Browse and download a variety of ports. - Install **FOSS (Free and Open Source Software) ports** directly. - Some ports require purchased game files. You will find PortMaster inside the ES-DE interface or in the Configurator. **Read more:** - [RetroDECK Folders](../../wiki_management/retrodeck-folders.md) - All Component specific guides on the wiki. --- ## **Adding BIOS & Firmware** Place required BIOS/Firmware files in (if the component require it): `retrodeck/bios/` **Read more:** - [BIOS & Firmware](../../wiki_management/bios-firmware.md) - All Component specific guides on the wiki. --- ## **Learn ES-DE Frontend** Es De logo ES-DE is the graphical interface where you browse, select and launch your games that RetroDECK uses. Understanding its basics will help you customize themes, scrape metadata, manage playlists and more. **Read more:** - [ES-DE Frontend Guide](../../wiki_frontend_guides/es-de/esde-guide.md) --- ## **Learn RetroDECK’s Hotkeys** RetroDECK uses Steam Input and each emulator has consistent hotkeys for save states, menus, fast-forward, screenshots and more. **Read more:** - [RetroDECK Hotkeys](../../wiki_rd_controls/hotkeys-retrodeck.md) --- ## **Play!** Go to RetroDECK on the Steam Grid under `Library` → `Non-Steam` → `RetroDECK`. Start RetroDECK. Any system with valid ROMs / Games should now appear in ES-DE and be ready to play. --- ### **(Optional) Apply templates to external controllers**. (This is usually automatic but for some hardware you might need apply it manually.) - Navigate to RetroDECK `Library` -> `Non-Steam`. - Go to 🎮 Controller `🎮 Controller Settings` -> `Controller Layouts` -> `Templates` . --- ## Additional Tips - **Explore the Wiki:** Read up and check more documentation for the software you want to play. - **Check recommended other software:** [Software Recommendations](../../wiki_management/software-recommendations.md) - **Update RetroDECK:** [How-to: Update RetroDECK](../../wiki_management/retrodeck-update.md) - **Uninstall RetroDECK:** [How-to: Remove RetroDECK](../../wiki_management/retrodeck-remove.md) ### Explore the Community RetroDECK is community-driven-explore, learn, or join in! - **Development updates:** [RetroDECK Blog](../../blog/index.md) - **Social links:** [Wiki Start Page](../../index.md) - **Contribute:** [How to Contribute](../../wiki_credits_social/contibute-retrodeck.md) - **Donate to FOSS Space:** [How to Contribute](../../wiki_credits_social/donations-licenses.md)