From c4ae4929c292f4bbb63631d7b39e816b2be74648 Mon Sep 17 00:00:00 2001 From: etjanster Date: Tue, 4 Feb 2025 08:32:30 +0100 Subject: [PATCH] fixes --- wiki-rtd/docs/wiki_general/retrodeck-start.md | 112 +++++------------- 1 file changed, 28 insertions(+), 84 deletions(-) diff --git a/wiki-rtd/docs/wiki_general/retrodeck-start.md b/wiki-rtd/docs/wiki_general/retrodeck-start.md index b18ef36..fca2582 100644 --- a/wiki-rtd/docs/wiki_general/retrodeck-start.md +++ b/wiki-rtd/docs/wiki_general/retrodeck-start.md @@ -1,126 +1,70 @@ -# Getting started +# Getting started with RetroDECK ## Step 0: Prerequisites -This is a guide on how to get started with RetroDECK +Before you start, make sure you have: -### What do I need? - -You need to meet the following prerequisites before you start following this guide: - -* You need to have a device to install RetroDECK on. -* Have related BIOS & Firmware ready -* Have game backups of various formats ready that you want to play +- A device to install RetroDECK on. +- Related BIOS & Firmware ready. +- Game backups of various formats or purchased titles ready to play. +- On the Steam Deck, this guide needs to be done in Desktop Mode until a later step. ## Step 1: Installation & Configuration -Only install RetroDECK from the official channels via Flathub! - ### Steam Deck - Installation -Read and follow the following guide - -[Steam Deck - Installation and Updates](../wiki_devices/steamdeck/steamdeck-start.md) +Follow the guide: [Steam Deck - Installation and Updates](../wiki_devices/steamdeck/steamdeck-start.md) ### Linux Desktop - Installation -Read and follow the: +Follow the guide: [Linux Desktop - Installation and Updates](../wiki_devices/linux_desktop/linux-install.md) -[Linux Desktop - Installation and Updates](../wiki_devices/linux_desktop/linux-install.md) - - -### Other SteamOS / Linux gaming devices - Installation - -(more information later) - -## Step 2: BIOS & Firmware - -**NOTE:** On the Steam Deck this step needs to be done in Desktop Mode - -### Information +## Step 2: Place BIOS & Firmware Read up on [Manage your BIOS/Firmware](../wiki_management/bios-firmware.md) -* The BIOS & Firmware files go into the `~/retrodeck/bios/` directory +Place BIOS & Firmware files in the `~/retrodeck/bios/` directory. +## Step 3: Place ROMs and Games -**Example:** -You have a BIOS for the PSX called `exampleBIOSPSX.bin`, you just put that file into the `~/retrodeck/bios/` folder. +RetroDECK follows the ES-DE ROM folder structure. -## Step 3: ROMs - -**NOTE:** On the Steam Deck this step needs to be done in Desktop Mode - -### On ROMs - -Rom files needs to be put in their corresponding system directory inside the `roms` folder. -Note that the `roms` folder location can be different depending on where you choose to put it during the installation process. The following options are available during the installation: - -#### **Choice: Internal** - -If during the installation of RetroDECK you choose the Internal option for the roms folder: -The roms folder is:`~/retrodeck/roms/` - -#### **Choice: SDCard** - -If during the installation of RetroDECK you choose the SDCard option for the roms folder: -The roms folder is: `/retrodeck/roms/` - -(Please note that the `` is an example and not called so inside your Linux/SteamOS system but rather your unique per SDCard ID number). - -#### **Choice: Custom** - -If during the installation of RetroDECK you choose the Custom option for the roms folder:
-The roms folder wherever you choose. - - -### Let us get started on ROMs/Games: - -Read up on `RetroDECK Management 🗜️` section of this wiki. - -* Put the corresponding roms inside the corresponding system folder +Place ROM files in their corresponding system directory inside the roms folder. The location of the `retrodeck/roms/` folder depends on your installation location choice. **Example:** -You have an example NES game called `ExampleNESGame.nes` -You must put that game into the `/retrodeck/roms/nes` folder. +You have an example NES game called: `ExampleNESGame.nes` + +Place `ExampleNESGame.nes` in the `/retrodeck/roms/nes` folder. ## Step 4: Playing the Games -### Steam Deck - Gamemode - -Return to gamemode on the Steam Deck and start up RetroDECK. Now the systems you put rom files for should be shown and be able to be played. +Start RetroDECK via Steam or by itself. The systems you placed ROM files for should be shown and playable. **Example:** -The NES column should now be shown with our `ExampleNESGame.nes` from `Step 3` -### Linux Desktop +The NES category should now be shown in the ES-DE Frontend with `ExampleNESGame.nes` from `Step 3`. -Start up RetroDECK from Steam. Now the systems you put rom files for should be shown and be able to be played. -**Example:** -The NES column should now be shown with our `ExampleNESGame.nes` from `Step 3` - -## Step 5: Making the games "pretty" with videos, images, and art. +## Step 5: Making the Games "Pretty" with Videos, Images, and Art Do the following: 1. Make an account on [Screenscraper](https://www.screenscraper.fr/) -2. Read up on scraping and the various settings that exist for it in the [ES-DE User Guide](../wiki_system_guides/es-de/esde-guide.md) -3. Login to your screenscraper account inside RetroDECK. -4. Setup the scraping how you want it. +2. Read up on scraping and the various settings in the [ES-DE User Guide](../wiki_system_guides/es-de/esde-guide.md). +3. Log in to your Screenscraper account inside RetroDECK. +4. Set up the scraping how you want it. 5. Start scraping. -6. Look at your nice pretty games. +6. Enjoy your nice, pretty games. -## Step 6: ES-DE Themes +**ES-DE Themes** -You can download more themes for ES-DE's frontend with the built-in theme downloader you can find it in: +You can download more themes for ES-DE's frontend with the built-in theme downloader found in: -`UI Settings - Theme Downloader` +`ES-DE Configurations` -> `UI Settings` -> `Theme Downloader` -Switch between them and in: - -`UI Settings - Theme Set` +Switch between them in: +`ES-DE Configurations` -> `UI Settings` -> `Theme Set`