# How do I install RetroDECK on the Steam Deck?

<img src="../../../wiki_images/logos/steam-deck-logo.png" width="150">

## Quickstart guide

- Switch the Steam Deck to Desktop Mode: `Steam button` -> `Power` -> `Switch to Desktop`.
- Install RetroDECK from Discover.
- Start RetroDECK for the first time in Desktop Mode.
- Choose where RetroDECK should create the main folder `retrodeck/`: Internal, Custom or SDCard.
- Put the BIOS files inside  `retrodeck/bios/`.
- Put the ROMs & game fiels inside`retrodeck/roms/`.
- Choose to install Steam Controller Templates for RetroDECK (this should be checked by default) during installation.
- In Steam desktop, go to the `Games` tab, press `Add non-Steam game to My library`, and select RetroDECK to add it to your library. If that doesn't work, right-click on the RetroDECK desktop icon and press Add to Steam in the menu.
- **Optional SteamgridDB Art:** Get RetroDECK Steam Grid art and add it to your Steam library with BoilR, or add the art manually from [SteamgridDB](https://www.steamgriddb.com/search/grids?term=RetroDeck).
- Switch to game mode and go to RetroDECK on the Steam Grid under `Library > Non-Steam`
- Add the  `RetroDECK: Steam Deck - Neptune` Official Template under `Controller Settings` -> `Controller Layouts` -> `Templates`. Choose either the SIMPLE raidal layout or FULL radial layout. 
- Launch RetroDECK and enjoy!

**Other quick tips**

- Read up on the: [RetroDECK: Steam Deck - Hotkeys](../../wiki_rd_controls/hotkeys-steamdeck-neptune.md).
- Read up on the: [ES-DE: User Guide](../../wiki_system_guides/es-de/esde-guide.md).
- Explore our other software recommendations for the Steam Deck: [Steam Deck: Software Recommendations](../../wiki_devices/steamdeck/steamdeck-software.md).
- Check various optional optimizations that can make some systems run even better: [Steam Deck: Optimizations](../../wiki_devices/steamdeck/steamdeck-optimize.md).


## Full step by step guide

### Step 1: Go to Desktop Mode

- Put the Steam Deck into Desktop Mode `Steam button` > `Power` > `Switch to Desktop`

### Step 2: Install from Discover

- Open the Discover application.
- **NOTE:** Depending on what language you have set in Desktop mode your Discover application can be named differently.
- Inside Discover search for RetroDECK and press the install button.
- After the installation is finished, launch RetroDECK from Discover or in the program menu under `Games > RetroDECK`.
- Follow the first-time setup instructions and choose where RetroDECK should create the `roms` folders `Internal` or `SDCard`.
- You will get a choice during the Setup to Install `The Official RetroDECK Steam Deck Controller Layout` this is highly recommended.
- Open Steam while still in desktop mode.
- Inside Steam go to the tab `Games` press `Add non Steam game to My library` and select RetroDECK to add it into your library.
- After this is done you can now see RetroDECK in Steam Deck's gamemode after you return to it from desktop mode.

### Step 3: Configure the official controller layouts

This step is only needed if you installed the layouts. If you missed installed the layout you can always reinstall it from the `RetroDECK Configurator` in `Desktop Mode` or within `Game Mode` from within RetroDECK from the `Main Menu` - `RetroDECK Configurator` <br>
Then `Tools` - `Install: RetroDECK Controller Layouts`.

- Go back into gamemode by pressing the return to gamemode icon on the desktop.
- Go to RetroDECK on the Steam Grid under `Library > Non-Steam`
- Press the `Controller Icon`
- Go into `Controller Layouts` and press `Templates`
- Add one of the layouts for RetroDECK called `RetroDECK: Steam Deck - Neptune` SIMPLE or FULL with a version number.
- You can now use RetroDECK and it's ready to populate with ROMS.
- If you are unsure on how to add ROMS and BIOS to RetroDECK follow the [Start using RetroDECK](../../wiki_general/retrodeck-start.md)

### Step 4 (Optional): Extras

- Get RetroDECK Steam Grid art with BoilR or add it manually from [SteamgridDB](https://www.steamgriddb.com/search/grids?term=RetroDeck) for the Steam Grid.
- Read up on the [Steam Deck - Controller](../../wiki_rd_controls/hotkeys-steamdeck-neptune.md) to ease your navigation.
- Read up on the [ES DE: User Guide](../../wiki_system_guides/es-de/esde-guide.md)
- Check out our other software recommendations for the Steam Deck [Steam Deck - Software Recommendations](../../wiki_devices/steamdeck/steamdeck-software.md).
- Check various optional optimizations that can make some emulators run even better [Steam Deck - Optimizations](../../wiki_devices/steamdeck/steamdeck-optimize.md).


## How do I update RetroDECK on the Steam Deck?

### From Desktop Mode
- Put the Steam Deck into Desktop Mode `Steam button` > `Power` > `Switch to Desktop`
- Open the Discover application.
- Click on the updates tab.
- If there are any updates available it will be shown here.
- Click on the `Update` or `Update all` buttons.

### Decky: AutoFlatpaks

If you have Decky installed and the AutoFlatpaks plugin. You can update RetroDECK from gamemode. <br>
Read more here: [Steam Deck - Software Recommendations](../../wiki_devices/steamdeck/steamdeck-software.md).