Wiki/wiki-rtd/docs/wiki_devices/steamdeck/steamdeck-start.md
2025-03-07 15:18:02 +01:00

76 lines
5 KiB
Markdown

# How-to: Install RetroDECK on the Steam Deck
<img src="../../../wiki_icons/pixelitos/steam.png" width="75">
**NOTE:**
Depending on what language you have set in `Desktop Mode`, things might be named differently.
### SD Card Tips
If you plan to use RetroDECK on your SD Card know that SD cards can be tricky and there are many scams out there.
Follow these tips when buying a new SD Card:
- Buy from a reputable brand and store.
- Ensure the card has good read and write speeds (check current reviews online).
- Format the card when you get it: Press `Steam` - `Storage` - `Select the Card` - Press `Y` for Options - `Format Drive`.
- Avoid using special characters, emojis, or spaces in the card's name. Stick to A-Z and 1-9.
- There are online solutions to test if an SD card is fake, like the software `f3` for Linux.
## Quickstart Guide
- Switch to `Desktop Mode`: Press the `Steam button` -> `Power` -> `Switch to Desktop`
- Install RetroDECK: Open the Discover application and search for RetroDECK. Press the install button.
- First-Time Setup: Launch RetroDECK from Discover or the KDE program menu under Games -> RetroDECK.
- Choose where to create the main folder `retrodeck/`: `Internal Storage`, `SD Card` or `Custom Location`.
- Install Steam Controller Templates: During installation, choose to install Steam Controller Templates for RetroDECK (this should be checked by default).
- Add RetroDECK to Steam Library: In Steam desktop, go to the `Games` tab, press `Add non-Steam game to My library`, and select RetroDECK. If that doesn't work, right-click on the RetroDECK desktop icon and press `Add to Steam`.
- **Optional** 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).
- Add BIOS and ROMs: Put the BIOS files inside `retrodeck/bios/` and ROMs & game files inside `retrodeck/roms/`.
- Switch back to `Game Mode`: Go to RetroDECK on the Steam Grid under `Library` -> `Non-Steam`.
- Configure Controller Layouts: Add the RetroDECK: `Steam Deck - Neptune Official Template` under `🎮 Controller Settings` -> `Controller Layouts` -> `Templates`. Choose either the SIMPLE radial layout or FULL radial layout.
- **Optional** If you have external controllers connected you can also apply those templates via `🎮 Controller Settings` -> `Controller Layouts` -> `Templates`.
- Read up on the [RetroDECK: Controller Hotkeys](../../wiki_rd_controls/hotkeys-retrodeck.md)..
- Launch RetroDECK and Enjoy!
## Step-by-Step Guide to Install RetroDECK on the Steam Deck
### 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.
- Search for RetroDECK and press the install button.
- After installation, launch RetroDECK from Discover or the KDE program menu under `Games` -> `RetroDECK`.
- Follow the first-time setup instructions and choose where RetroDECK should create the `retrodeck/` folder: `Internal Storage`, `SD Card` or `Custom Location`.
- During setup, choose to install `RetroDECK Steam Controller Profiles`s (highly recommended) and optional BIOS files.
#### Step 3: Add to Steam & Add files
- Read the guide on: [How-to: Add RetroDECK to Steam](../../wiki_management/add-to-steam.md).
- Add BIOS and ROMs: Put the BIOS files inside `retrodeck/bios/` and ROMs & game files inside `retrodeck/roms/`. If you are unsure how to add ROMs and BIOS to RetroDECK [RetroDECK: Start Using](../../wiki_general/retrodeck-start.md).
- After this, you can see RetroDECK in Steam Deck's `Game Mode` after returning from `Desktop Mode`.
### Step 4: Configure the Steam Controller Profiles
This step is only needed if you installed the profiles. If you missed installing the layouts, you can always reinstall them from `RetroDECK Configurator` -> `Tools` -> `Install: RetroDECK Controller Layouts`.
- Go back into `Game Mode` by pressing the `Return to Game Mode` icon on the desktop.
- Navigate to RetroDECK `Library` -> `Non-Steam`.
- Go to 🎮 Controller `🎮 Controller Settings` -> `Controller Layouts` -> `Templates` .
- Add one of the layouts for RetroDECK called `RetroDECK: Steam Deck - Neptune` SIMPLE or FULL.
- **Optional** If you have external controllers connected you can also apply those templates via `🎮 Controller Settings` -> `Controller Layouts` -> `Templates`.
- Read up on the [RetroDECK: Controller Hotkeys](../../wiki_rd_controls/hotkeys-retrodeck.md).
## Other Tips
- 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).
- Check on: [How-to: Update RetroDECK](../../wiki_management/retrodeck-update.md).
- If you no longer want RetroDECK, you can find the removal guide at: [How-to: Remove RetroDECK](../../wiki_management/retrodeck-remove.md).