This commit is contained in:
etjanster 2025-02-04 10:02:31 +01:00
parent 32e0a96e29
commit 4f5f3b52cb
2 changed files with 37 additions and 29 deletions

View file

@ -1,62 +1,70 @@
# How do I install RetroDECK on the Linux Desktop?
# How-to: Install RetroDECK on the Linux Desktop
<img src="../../../wiki_images/logos/linux-tux-logo.svg" width="150">
## Prerequisites
1. You need to have flatpak support installed on your Linux desktop. <br>
Follow the official flatpak guides on how to install it for your distribution:<br>
[Flatpak Setup Guide](https://flatpak.org/setup/)
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. We recommend that you have the `steam-devices` and/or `game-devices-udev` package installed as it comes with udev rules for many different controllers. You will have to check your distribution on 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. We currently recommend that you add and launch RetroDECK from Steam so you can utilize the Steam Input feature to change various aspects of the external controllers. We will be looking into other alternative solutions later for those that do not want to use Steam.
3. It's recommended to add and launch RetroDECK from Steam to utilize the Steam Input feature for external controllers.
## From the Desktop GUI
## RetroDECK Installation
- Go into your flatpak supported software manager in your desktop environment, this is different depending on what desktop you use. Example: for GNOME is often `GNOME Software` and for KDE it is `KDE Discover`.
**From the Desktop**
- Open your flatpak-supported software manager (e.g., GNOME Software for GNOME, KDE Discover for KDE).
- Search for RetroDECK and press install.
## From the terminal
**From the terminal**
- Run the following command `flatpak install Flathub net.retrodeck.retrodeck`
Run the following command:
`flatpak install Flathub net.retrodeck.retrodeck`
## First Run - Quick Start
1. Start RetroDECK for the first time
2. Choose where RetroDECK should create the `roms` folders `Internal`, `SDCard` or `Custom`.
3. Put the BIOS inside `~/retrodeck/bios/` folder [How to: Manage BIOS and Firmware](../../wiki_management/bios-firmware.md)
4. Put the ROMS inside `~/retrodeck/roms/` folder.
5. Add RetroDECK to Steam [How to: Add RetroDECK to Steam](../../wiki_general/add-to-steam.md)
6. Make sure you have enabled controller support in Steam [How to: Enable Controllers in Steam ](../../wiki_general/supported-controllers.md)
7. Connect your controller to your Desktop.
8. Launch RetroDECK from Steam and enjoy
2. Choose where RetroDECK should create the main folder `retrodeck/`: `Internal Storage`, `SD Card` or `Custom Location`.
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).
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
9. Go to `🎮 Controller Settings` -> `Controller Layouts` -> `Templates` and enable the template for the controller you are using.
10. Launch RetroDECK and enjoy!
## Updates
Updates to RetroDECK are handled automatically via your software manager when there is an updated version released.
Updates to RetroDECK are handled automatically via your software manager when a new version is released. To update from the terminal, type:
Or if you want to update from the terminal you can type: <br>
`flatpak update`
## I got a distribution that have implemented Steam Deck's Game Mode, can I utilize that?
## Game Mode on Your Linux PC?
Yes, you can.
You can utilize Steam Deck's Game Mode on your Linux PC if your distribution supports it and specific hardware requirements apply for Game Mode to work.
Specific hardware requirements apply if you want `Game Mode` to work.
It mitigates several issues with Steam Input and provides the best RetroDECK experience and playing Steam games with controllers out of the box.
`Game Mode` on your PC will mitgate several issues with Steam Input that exists in various distributions and will probably give you the best RetroDECK experience and playing Steam Games with controllers out of the box.
Here is a list of some distributions that support Game Mode:
### Bazzite
**Bazzite**
[Bazzite Webpage](https://bazzite.gg/)
[Bazzite: Steam Game Mode](https://universal-blue.discourse.group/t/steam-gaming-mode-overview-for-handheld-htpc-images/)
For Bazzite you install the HTPC / Steam Deck image on your PC.
### Chimera OS
**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)

View file

@ -8,8 +8,8 @@
- 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 fiels inside`retrodeck/roms/`.
- 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`