mirror of
https://git.eden-emu.dev/eden-emu/eden
synced 2026-04-10 18:28:54 +02:00
11ad71b1e7
Signed-off-by: lizzie <lizzie@eden-emu.dev> Reviewed-on: https://git.eden-emu.dev/eden-emu/eden/pulls/3678 Reviewed-by: DraVee <chimera@dravee.dev> Reviewed-by: CamilleLaVey <camillelavey99@gmail.com> Co-authored-by: lizzie <lizzie@eden-emu.dev> Co-committed-by: lizzie <lizzie@eden-emu.dev>
265 lines
11 KiB
Markdown
265 lines
11 KiB
Markdown
# User Handbook - Configuring Steam ROM Manager
|
||
|
||
## Importing Eden into Steam with Steam Rom Manager
|
||
|
||
Use this when you want to import the Eden AppImage into your Steam Library along with artwork using *Steam ROM Manager.*
|
||
|
||
**Click [Here](https://evilperson1337.notion.site/Importing-Eden-into-Steam-with-Steam-Rom-Manager-2b757c2edaf68054851bc287b6382cb5) for a version of this guide with images & visual elements.**
|
||
|
||
---
|
||
|
||
#### Pre-Requisites
|
||
|
||
- Eden set up and configured
|
||
- Internet Connection
|
||
- Comfort Accessing and Navigating SteamOS Desktop Mode
|
||
|
||
---
|
||
|
||
### Steps
|
||
|
||
#### Initial Setup
|
||
|
||
1. Press the **STEAM** button and then go to *Power → Switch to Desktop* to enter the Desktop mode.
|
||
|
||
2. Install ***Steam ROM Manager*** (if needed), there are 2 ways you can accomplish this, either manually or through [*EmuDeck*](https://www.emudeck.com/#downloads).
|
||
|
||
---
|
||
|
||
#### Manual Installation
|
||
|
||
1. Open the *Discover Store* and search for *Steam ROM Manager.*
|
||
2. Select the **Install** button to install the program.
|
||
|
||
---
|
||
|
||
#### Installing Through *EmuDeck*
|
||
|
||
<aside>
|
||
|
||
***NOTE***: This assumes you have already set up EmuDeck, if not - just run through the guided installation and select *Steam ROM Manager* as one of the options.
|
||
|
||
</aside>
|
||
|
||
1. Open **EmuDeck**, then navigate to *Manage Emulators.*
|
||
2. Scroll down to the bottom of the page to the *Manage your Tools & Frontends* section. Click **Steam ROM Manager**.
|
||
3. Click the **Install** button on the right hand side to install it.
|
||
|
||
---
|
||
|
||
#### Adding Eden into *Steam ROM Manager*
|
||
|
||
#### EmuDeck Users
|
||
|
||
EmuDeck will automatically create an *Emulators - Emulators* parser for ***Steam ROM Manager*** that uses shell scripts to launch them. We will follow this convention.
|
||
|
||
1. In the file explorer go to your **EmuDeck installation folder → tools → launchers**
|
||
2. Right-Click some empty space and hit **Create New → Text File,** call this new file ***eden.sh*** instead of ***Text File.txt***
|
||
3. Right-Click the ***eden.sh*** file you created and hit ***Open with Kate***.
|
||
4. Paste the following code into the contents of the file, save and close the file.
|
||
|
||
```bash
|
||
#!/bin/bash
|
||
emuName="eden" #parameterize me
|
||
|
||
. "$HOME/.config/EmuDeck/backend/functions/all.sh"
|
||
emulatorInit "$emuName"
|
||
|
||
# find full path to emulator appimage
|
||
appimage=$(find "$emusFolder" -iname "${emuName}*.AppImage" -print -quit 2>/dev/null)
|
||
|
||
# make sure the appimage is executable
|
||
chmod +x "$appimage"
|
||
set -- "$appimage" "$@"
|
||
|
||
echo "Launching ${emuName} with:" "$@"
|
||
"$@"
|
||
|
||
cloud_sync_uploadForced
|
||
rm -rf "$savesPath/.gaming"
|
||
```
|
||
|
||
5. Open a terminal in the directory containing the ***eden.sh*** file and run the following command to make it executable.
|
||
|
||
```bash
|
||
chmod u+x ./eden.sh
|
||
```
|
||
|
||
6. Proceed to the Adding the Emulator section
|
||
|
||
---
|
||
|
||
#### Non-EmuDeck Users
|
||
|
||
We will need to create a new parser for the Emulators. Unlike with the EmuDeck model, we will have the parser look for AppImages.
|
||
|
||
<aside>
|
||
|
||
***TIP***: In order to ensure that the matches occur correctly, it is recommended that you name the Eden Appimage as ***eden.AppImage***, rather than what it downloads as.
|
||
|
||
</aside>
|
||
|
||
1. Open *Steam ROM Manager* and choose **Create Parser**.
|
||
|
||
<aside>
|
||
|
||
***TIP***: You may need to go to **Settings → Theme** and set it to *Classic* to view this option.
|
||
|
||
</aside>
|
||
|
||
2. Add the following settings to create the parser.
|
||
|
||
1. Basic Configuration
|
||
1. **Parser Type**: *Blob*
|
||
2. **Parser Title**: *Emulators - Emulators*
|
||
3. **Steam Directory**: *${steamdirglobal}*
|
||
4. **User Accounts**: *Global*
|
||
5. **ROMs Directory**: <path to directory containing eden AppImage>
|
||
6. **Steam Collections**: *Emulation* (OPTIONAL)
|
||
2. Parser Specific Configuration
|
||
1. **Search Glob**: *${title}@(.AppImage|.APPIMAGE|.appimage)*
|
||
3. Executable Configuration
|
||
1. **Executable Modifier**: *"${exePath}”*
|
||
4. Title Modification Configuration
|
||
1. **Title Modifier**: *${fuzzyTitle}*
|
||
|
||
3. Hit the **Test** button to ensure your emulator AppImages.
|
||
4. Hit **Save** to save the Parser.
|
||
|
||
---
|
||
|
||
#### Adding Eden to Steam
|
||
|
||
Now that we have the parser or shell script created, we can actually add it to Steam.
|
||
|
||
1. Open *Steam ROM Manager* if it is not already open.
|
||
2. Toggle the **Emulators - Emulators** parser on and hit ***Add Games*** in the top left.
|
||
3. Click **Parse** to identify the emulators.
|
||
4. Make sure all your emulators are showing up and have the right matches.
|
||
|
||
---
|
||
|
||
#### Correcting a Mismatch
|
||
|
||
If the emulator is not identified correctly, you may need to tell *Steam ROM Manager* what the game is manually.
|
||
|
||
1. Hover over the emulator card and click the magnifying glass icon. Here it incorrectly identified *Eden* as a game by a similar name. **
|
||
2. Search for *Eden Emulator* on the *Search SteamGridDB* section and scroll through the results, selecting the one you want.
|
||
3. Ensure the *Name* and *Game ID* update in the **Per-App Exceptions** and press **Save and close**. The game should now update.
|
||
|
||
---
|
||
|
||
#### Excluding Matches
|
||
|
||
You may want to tell Steam ROM Manager to ignore some files that it finds in the directory. This is how you do so.
|
||
|
||
1. Hit the **Exclude Games** button in the bottom right.
|
||
2. Deselect the game you want to exclude, the poster artwork should go dim and the **Number Excluded** number should increment up. Repeat with any other exclusions you want to add.
|
||
3. Hit **Save Excludes** when you are happy with your selections.
|
||
|
||
---
|
||
|
||
5. The program will now start writing the entries into the Steam Library. You should get pop up notifications of the progress, but you can monitor the progress by selecting the **Log** on the left-hand side if needed.
|
||
6. Restart Steam to have the changes take effect. Check your library to ensure that your games are there, in a category if you defined one in the parser.
|
||
7. Try to launch the Emulator from Steam and ensure everything is working. You are now good to go.
|
||
|
||
## Importing Games into Steam with Steam Rom Manager
|
||
|
||
Use this when you want to import your games inside Eden into Steam to launch with artwork from Steam Game Mode without needing to launch Eden first.
|
||
|
||
**Click [Here](https://evilperson1337.notion.site/Importing-Games-into-Steam-with-Steam-Rom-Manager-2b757c2edaf680d7a491c92b138f1fcc) for a version of this guide with images & visual elements.**
|
||
|
||
---
|
||
|
||
#### Pre-Requisites
|
||
|
||
- Steam Deck Set up and Configured
|
||
- Eden set up and Configured
|
||
- Internet Access
|
||
|
||
---
|
||
|
||
### Steps
|
||
|
||
1. Press the **STEAM** button and then go to *Power → Switch to Desktop* to enter the Desktop mode.
|
||
|
||
1. Install ***Steam ROM Manager***, there are 2 ways you can accomplish this, either manually or through [*EmuDeck*](https://www.emudeck.com/#downloads).
|
||
|
||
---
|
||
|
||
#### Manual Installation
|
||
|
||
1. Open the *Discover Store* and search for *Steam ROM Manager.*
|
||
2. Select the **Install** button to install the program.
|
||
|
||
---
|
||
|
||
#### Installing Through *EmuDeck*
|
||
|
||
<aside>
|
||
|
||
***NOTE***: This assumes you have already set up EmuDeck, if not - just run through the guided installation and select *Steam ROM Manager* as one of the options.
|
||
|
||
</aside>
|
||
|
||
1. Open **EmuDeck**, then navigate to *Manage Emulators.*
|
||
2. Scroll down to the bottom of the page to the *Manage your Tools & Frontends* section. Click **Steam ROM Manager**.
|
||
|
||
3. Click the **Install** button on the right hand side to install it.
|
||
|
||
---
|
||
|
||
2. Open the Start Menu and Launch ***Steam ROM Manager***
|
||
|
||
1. The program will now launch and show you a window with parsers.
|
||
|
||
<aside>
|
||
|
||
***TIP***: Your layout may look different depending on how you installed *Steam ROM Manager*. You may need to go to **Settings → Theme** and change it to *Classic* to follow along.
|
||
|
||
</aside>
|
||
|
||
2. Switch off all Parsers by hitting the *Toggle Parsers* switch.
|
||
3. Scroll down the list on the left-hand side and look for a parser called *Nintendo Switch - Eden* and switch it on. This parser may not exist depending on how you installed *Steam ROM Manager* (EmuDeck creates it for you). Follow these steps to create it if it is missing.
|
||
|
||
---
|
||
#### Creating the Eden Parser
|
||
|
||
1. Select Create Parser and in the *Community Presets* option look for **Nintendo Switch - Yuzu**.
|
||
2. Change the **Parser title** from *Nintendo Switch - Yuzu* to *Nintendo Switch - Eden.*
|
||
3. Hit the **Browse** option under the *ROMs directory* section. Select the directory containing your Switch ROMs.
|
||
4. Under *Steam collections*, you can add a Steam category name. This just organizes the games under a common category in your Steam Library, this is optional but recommended.
|
||
5. Scroll down slightly to the **Executable Configuration → Executable**, select **Browse** and select the Eden AppImage.
|
||
6. Leave everything else the same and hit **Save** to save the parser.
|
||
---
|
||
|
||
4. Click the Eden parser to view the options on the right, select **Test** at the bottom of the screen to ensure that *Steam ROM Manager* detects your games correctly.
|
||
1. *Steam ROM Manager* will start to scan the specified ROMs directory and match them to games. Look over the results to ensure they are accurate. If you do not see any entries - check your parsers ROMs directory field.
|
||
1. When you are happy with the results, click the **Add Games** → **Parse** to start the actual Parsing.
|
||
1. The program will now identify the games and pull artwork from [*SteamGridDB*](https://www.steamgriddb.com/).
|
||
2. Review the game matches and ensure everything is there.
|
||
|
||
---
|
||
|
||
#### Correcting a Mismatch
|
||
|
||
If the game is not identified correctly, you may need to tell *Steam ROM Manager* what the game is manually.
|
||
|
||
1. Hover over the game card and click the magnifying glass icon.
|
||
2. Search for the game on the *Search SteamGridDB* section and scroll through the results, selecting the one you want.
|
||
3. Ensure the *Name* and *Game ID* update in the **Per-App Exceptions** and press **Save and close**. The game should now update.
|
||
|
||
---
|
||
|
||
#### Excluding Matches
|
||
|
||
You may want to tell Steam ROM Manager to ignore some files (updates/DLC/etc.) that it finds in the directory. This is how you do so.
|
||
|
||
1. Hit the **Exclude Games** button in the bottom right.
|
||
2. Deselect the game you want to exclude, the poster artwork should go dim and the **Number Excluded** number should increment up. Repeat with any other exclusions you want to add.
|
||
3. Hit **Save Excludes** when you are happy with your selections.
|
||
---
|
||
3. When you are happy with the results, select **Save to Steam** to save the results.
|
||
1. The program will now start writing the entries into the Steam Library. You should get pop up notifications of the progress, but you can monitor the progress by selecting the **Log** on the left-hand side if needed.
|
||
2. Restart Steam to have the changes take effect. Check your library to ensure that your games are there, in a category if you defined one in the parser.
|
||
3. Try to launch a game and ensure everything is working. You are now good to go.
|