This commit is contained in:
laz 2025-02-09 09:03:19 +01:00
parent 45c28f9340
commit 98058b4f4e
4 changed files with 49 additions and 51 deletions

View file

@ -6,7 +6,7 @@
1. Ensure you have flatpak support installed on your Linux desktop. Follow the official flatpak guides for your distribution: [Flatpak Setup Guide](https://flatpak.org/setup/).
2. Install the `steam-device` package for udev rules for various controllers (most gaming focused distribution have this already). Check your distribution's instructions for how to install it.
2. Install the `steam-device` package for udev rules for various controllers (most gaming focused distribution have this already). Check your distribution's instructions for how to install it.
3. It's recommended to add and launch RetroDECK from Steam to utilize the Steam Input feature for external controllers.
@ -30,7 +30,7 @@ Run the following command:
3. Put the BIOS files inside `retrodeck/bios/`.
4. Put the ROMs & game files inside `retrodeck/roms/`.
5. Choose to install Steam Controller Templates for RetroDECK (this should be checked by default) during installation.
5. Add RetroDECK to Steam: [How-to: Add RetroDECK to Steam](../../wiki_general/add-to-steam.md).
5. Add RetroDECK to Steam: [How-to: Add RetroDECK to Steam](../../wiki_management/add-to-steam.md).
6. Enable controller support in Steam: [How-to: Enable Controllers in Steam ](../../wiki_general/supported-controllers.md).
7. Connect your controller to your desktop.
8. Navigate to RetroDECK in Steam

View file

@ -1,83 +1,81 @@
# How do I install RetroDECK on the Steam Deck?
# How-to: 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 Storage`, `SD Card` or `Custom Location`.
- Put the BIOS files inside `retrodeck/bios/`.
- Put the ROMs & game files 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.
- 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**
- 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).
- 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
<img src="../../../wiki_images/logos/steam-deck-logo.png" width="75">
**NOTE:**
Depending on what language you have set in Desktop Mode things might be named differently.
Depending on what language you have set in `Desktop Mode`, things might be named differently.
## 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.
- Read up on the [RetroDECK: Steam Deck - Hotkeys](../../wiki_rd_controls/hotkeys-steamdeck-neptune.md).
- Launch RetroDECK and Enjoy!
**Other Quick 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).
## Step-by-Step Guide to Install RetroDECK on the Steam Deck
### Step 1: Go to Desktop Mode
Put the Steam Deck into Desktop Mode:
Put the Steam Deck into `Desktop Mode`:
`Steam button` > `Power` > `Switch to Desktop`
### Step 2: Install from Discover
- Open the Discover application.
- Inside Discover search for RetroDECK and press the install button.
- After the installation is finished, launch RetroDECK from Discover or in 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`.
- You will get a pre filled choice during the Setup to Install `RetroDECK Steam Controller Profiles` (highly recommended) and optional BIOS files.
- Open Steam while still in Desktop Mode.
- Inside Steam go to the `Games` tab 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.
- 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: Configure the Steam Controller Profiles
#### Step 3: Add to Steam & Add files
This step is only needed if you installed the profiles. If you missed installed the layouts you can always reinstall them from `RetroDECK Configurator` -> `Tools` -> `Install: RetroDECK Controller Layouts`.
- 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 Settings` -> `Controller Layouts` -> `Templates`
- Go to 🎮 Controller `🎮 Controller Settings` -> `Controller Layouts` -> `Templates` .
- Add one of the layouts for RetroDECK called `RetroDECK: Steam Deck - Neptune` SIMPLE or FULL.
- 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 [RetroDECK: Start Using](../../wiki_general/retrodeck-start.md)
- Read up on the [RetroDECK: Steam Deck - Hotkeys](../../wiki_rd_controls/hotkeys-steamdeck-neptune.md).
**Other quick tips**
- 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).
- 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).
## How do I update RetroDECK on the Steam Deck?
## How-to: Update RetroDECK on the Steam Deck
- Put the Steam Deck into Desktop Mode `Steam button` -> `Power` -> `Switch to Desktop`
- 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.
- If there are any updates available, they will be shown here.
- Click on the `Update` or `Update all` button.
### Decky: AutoFlatpaks
If you have Decky installed and the AutoFlatpaks plugin. You can update RetroDECK from gamemode.
If you have Decky installed and the AutoFlatpaks plugin, you can update RetroDECK from `Game Mode`.
Read more here: [Steam Deck: Software Recommendations](../../wiki_devices/steamdeck/steamdeck-software.md).

View file

@ -110,7 +110,7 @@ nav:
- Guides - Files & Game Management 📂:
- Add RetroDECK to Steam: wiki_general/add-to-steam.md
- Add RetroDECK to Steam: wiki_management/add-to-steam.md
- Manage your BIOS/Firmware: wiki_management/bios-firmware.md
- Manage your Multidisk/file games: wiki_management/multi-disk.md
- Move RetroDECK to a new device: wiki_management/retrodeck-move.md