Steam ROM Manager - dragoonDorise/EmuDeck GitHub Wiki

THIS WIKI IS NO LONGER MAINTAINED. VISIT https://emudeck.github.io/ FOR THE NEW EMUDECK WIKI.


Steam ROM Manager is a tool to add ROMs as Non-Steam Game Shortcuts.

Introduction

EmuDeck installs Steam ROM Manager https://github.com/SteamGridDB/steam-rom-manager, which allows you to add your ROMs directly to your library. It can either be used as an alternative or in tandem with EmulationStation-DE (a frontend application to manage your ROMs.).

Steam ROM Manager's Website: https://github.com/SteamGridDB/steam-rom-manager

Steam ROM Manager sources art from SteamGridDB: https://www.steamgriddb.com/

Read https://github.com/dragoonDorise/EmuDeck/wiki/EmulationStation-DE to learn more about EmulationStation-DE and how it can be used in tandem with Steam ROM Manager!


Steam ROM Manager Table of Contents

  1. Getting started with Steam ROM Manager

  2. Common Issues

  3. Steam ROM Manager Tips and Tricks


Getting started with Steam ROM Manager

Back to the Top

Steam ROM Manager is a powerful tool used to add ROMs, emulators, and tools as non-Steam shortcuts to your Steam library. Fortunately, with EmuDeck, Steam ROM Manager comes fully pre-configured with a user friendly theme.

Open Steam ROM Manager through the EmuDeck application on your desktop or through the applications launcher (Steam icon in the bottom left of your taskbar). Do note that it will exit out of Steam and switch your controls into "Lizard Mode". You will retain use of the trackpad but will need to use R2 to left click and L2 to right click instead of clicking with the trackpad.

First, place your ROMs with the expected file formats into their respective system folders in Emulation/roms. Read the the Cheat Sheet if you have not done so already, it will cover the expected file formats as well as expected BIOS for the various systems.

After you place your ROMs in their respective system folders, learn how to generate and parse an app list here: #how-to-generate-and-save-an-app-list.

If you open Steam ROM Manager, and you do not see any parsers, read this section: #why-does-steam-rom-manager-have-no-parsers to fix the issue.

After you have parsed and saved an app list, your ROMs will be added to the non-Steam section. You will now be ready to play your games directly from Game Mode.

If you prefer, you may use the EmulationStation-DE parser to add EmulationStation-DE to Steam and play your ROMs directly from this all-in-one front-end.


Configuration

Back to the Top

  • Executable Location: Emulation/tools/srm/Steam-ROM-Manager.AppImage
  • Config Location: /home/deck/.config/steam-rom-manager
  • Art Location: /home/deck/.steam/steam/userdata/<steamuseridnumber>/config/grid

Note:

  • ~/.config and ~/.steam are invisible folders by default. In Dolphin (file manager), click the hamburger menu in the top right, click Show Hidden Files to see these folders.

How to Update Steam ROM Manager

Back to the Top

How to Update Steam ROM Manager


How to Launch Steam ROM Manager in Desktop Mode

Back to the Top

How to Launch Steam ROM Manager in Desktop Mode

  • Launch Steam ROM Manager through EmuDeck
  • Launch Steam ROM Manager from the Applications Launcher (Steam Deck icon in the bottom left of the taskbar)
  • Launch the AppImage in Emulation/tools/srm/Steam-ROM-Manager.AppImage

How to Reset Steam ROM Manager

Back to the Top

Sometimes after installing EmuDeck, Steam ROM Manager may not be configured correctly and you will be missing EmuDeck's pre-created parsers. Or you may have tinkered with Steam ROM Manager and want to reset it back to EmuDeck's defaults.

You can reset Steam ROM Manager's configurations in the Emulator Guides page.

Tutorial

  1. Open EmuDeck on your desktop
  2. Click the Manage Emulators button
  3. Click the Steam ROM Manager Parsers button
  4. Click Reset configuration, wait a moment.
    1. Visual Reference:
  5. Steam ROM Manager has been reset.

A backup of your original Steam ROM Manager configurations is automatically created after resetting. You can find this backup in /home/deck/.config/steam-rom-manager/userData. The backup file is named: userConfigurations.json.bak.


Common Issues

Back to the Top


I hit remove all from settings, but the Entries weren't removed!

Back to the Top

If you used the remove all button and entries weren't removed, but they were uncategorized:

This is due to some backend changes in a recent Steam Rom Manager update. The easiest way to deal with this will be to use the remove function. Open Steam Rom Manager, make sure all parsers are enabled. Parse, then hit Remove from Steam. This should take care of it. For any stragglers you can remove them manually.

The other option (removes all non-steam entries, regardless as to how they were added):

  1. Exit steam
  2. Navigate to ~/.steam/steam/userdata/YOURSTEAMUSERID/
  3. Delete the config folder
  4. Delete the 760 folder
  5. reopen steam and validate it's all clean.

Help, I just opened Steam ROM Manager and I have no controls!

Back to the Top

When you open Steam ROM Manager, it will exit out of Steam. Since your controls are tied to Steam being open, your controls will revert to Lizard Mode. You can use L2 to right click, R2 to left click, and the Right Trackpad to move the mouse.

Alternatively, you can either use a mouse/keyboard (Bluetooth or through a USB-C Hub) or remote into your Steam Deck.

Learn how to remotely control your Steam Deck: https://github.com/dragoonDorise/EmuDeck/wiki/frequently-asked-questions#how-do-i-remotely-control-my-steam-deck


Why does Steam ROM Manager have no parsers?

Back to the Top

If you recently installed EmuDeck for the first time and Steam ROM Manager is empty, that means you did not select Steam ROM Manager's configurations to be set up in the installation of EmuDeck.

For reference, de-selecting Steam ROM Manager on this screen will prevent EmuDeck from properly setting it up:


You can fix this by choosing one of the following methods:

Method 1: Reset Steam ROM Manager

  1. Open EmuDeck on your desktop
  2. Click the Manage Emulators button
  3. Click the Steam ROM Manager Parsers button
  4. Click Reset configuration, wait a moment.
    1. Visual Reference:
  5. Steam ROM Manager has been reset.

A backup of your original Steam ROM Manager configurations is automatically created after resetting. You can find this backup in /home/deck/.config/steam-rom-manager/userData. The backup file is named: userConfigurations.json.bak.


Method 2: Custom Reset

  • Open EmuDeck on your desktop and run through a Custom Reset. This may be recommended over Method 1 in case you accidentally de-selected any other icons on the Emulator Configurations screen. Any de-selected icons on this screen will not be set up by EmuDeck
    • You do not need to uninstall EmuDeck to do this method

"Please shutdown Steam if it is running"

Back to the Top

This message is a warning to confirm that you have closed Steam. EmuDeck's shortcut for Steam ROM Manager closes out of Steam for you. You may ignore this warning if you are opening through the applications launcher in the bottom left of the taskbar or through the EmuDeck GUI.

If you are trying to generate an app list and no ROMs are displaying in the app list, read this section: #why-are-my-games-not-showing-up-in-steam-rom-manager

Running Steam ROM Manager external to EmuDeck's script will not exit out of Steam for you. You will need to verify Steam is closed, if you do not use EmuDeck's script. You do not have to worry about this if you are running Steam ROM Manager from its shortcut in the Applications Launcher or the button in the EmuDeck application.


Large ROM Collections

Back to the Top

If you have a large ROM collection, generally over 1,000 ROMs, it is recommended you use EmulationStation-DE for some of your larger sets.

Do not turn on all of the parsers in Steam ROM Manager, instead pick smaller sets that you would like to appear in your Steam library. Keep in mind that using all parsers will mean that every ROM will show up in your Steam library. Unexpected behavior or bugs may occur with larger ROM counts in Game Mode.

To use EmulationStation-DE, it is recommended to turn on at least the EmulationStation-DE and the Emulators parser in Steam ROM Manager. These will allow you to manage EmulationStation-DE (to launch your ROMs) and emulators (to do any additional configurations) in Game Mode. In addition to these two parsers, limit the amount of parsers you toggle to prevent any bugs or unexpected behavior in Game Mode.


Known Issues With Large ROM Collections in Game Mode

  • Lagging menus and scrolling while browsing games
  • Unexpected behavior with collections and games displaying in Game Mode
  • Unexpected bugs

Why Are My Games Not Showing Up in Steam ROM Manager?

Back to the Top

Your games may not show up for a few reasons:

  • Make sure your file path is correct. Refer to the EmuDeck Cheat Sheet for which folders correlate to which system.
    • Example: Nintendo DS games are placed in Emulation/roms/nds
  • Make sure your ROMs are in the correct file format. Refer to the EmuDeck Cheat Sheet for the correct file format.
    • Example: Many emulators are not compatible with .7z or .zip files. You will need to extract these files to use them. The cheat sheet will list which emulators can and cannot use zip files.
  • Make sure you know how to generate an App List, refer to #how-to-generate-and-save-an-app-list, for further instructions.
  • Steam ROM Manager's UI sometimes does not scale properly and the scrollbar on the right does not let you scroll down. However, you can either resize the window or scroll in the middle to see the rest of your generated app list.

Why do some of my multi-disc games not show up in Steam ROM Manager?

Back to the Top

Primarily with the Playstation 2 parser, turning on Remove (...) and [...] brackets will trim the ROM name and cause Steam ROM Manager to deem multiple discs of the same game as the same file. When you generate an app list, only one of your discs will show up.

To fix this, do one of the following solutions:

  • Remove the () in the file name
    • Open the respective folder with the ROMs, and rename each disc to remove the ()
    • Example:
      • Original File Name: Xenosaga: Episode 2 (Disc 1) and Xenosaga: Episode 2 (Disc 2)
      • Updated File Name: Xenosaga: Episode 2 Disc 1 and Xenosaga: Episode 2 Disc 2
  • Turn off Remove (...) and [...] brackets in the respective parser
    • Visual Reference (Using Playstation 2 as an example):
    • Note: With this setting off, Steam ROM Manager will include any content in the parantheses of the file name when parsing ROMs. This means that if you include region names or any other information in parantheses, your ROM will include this information in a generated app list

Unexpected end of JSON input

Back to the Top

If you receive an error while trying to save the App List that is similar to this:

syntax error: /home/deck/.steam/steam/userdata/<USERID>/config/addeditemsv2.json: unexpected end of JSON input

You will need to delete the file by opening the path in the error message. After deleting the file, try generating your app list again. It's possible to have more than one corrupted file in this way and is related to the Steam ROM Manager process being terminated before it is done saving.


Error occurred while loading configuration presets

Back to the Top

If you see: Error occurred while loading configuration presets in the bottom right when you open Steam ROM Manager, you will need to update your presets.

Here's How

  1. Click the Settings button
  2. Click Force download config presets under Community variable/preset settings
  3. Once you force download the new config presets, the error will no longer appear

A JavaScript error occurred in the main process

Back to the Top

If you see a pop-up with the message: A JavaScript error occurred in the main process when you open Steam ROM Manager, you may click Ok to proceed. This error does not mean there is anything wrong with your configurations.


Steam ROM Manager Tips and Tricks

Back to the Top


How to Generate and Save an App List

Back to the Top

Preface

Generating and saving an App List is how you add your ROMs to your Steam library. It's generally recommended that you turn on at least the Emulators parser and the EmulationStation-DE parser.

Here's a quick rundown:

  • The Emulators parser allows you to manage your emulators in game mode (game settings, controls, tweaks, etc).
  • The EmulationStation-DE parser adds EmulationStation-DE as a shortcut to Steam.

Tutorial

  1. Open Steam ROM Manager
    1. Read: How to Launch Steam ROM Manager in Desktop Mode
  2. Choose which parsers you would like to use (Active parsers are indicated with a green toggle)
  3. Click Preview
  4. Click Parse
  5. Wait for all the images to download, click Save apps to Steam (It may take a few moments, check the Event Log tab to confirm that it is finished)

For a tutorial, watch one of the videos below:


How to Fix a Mismatched Entry

Back to the Top

Preface

When you generate an app list in Steam ROM Manager, your ROMs are matched to an existing entry on SteamGridDB. If your ROM does not have a SteamGridDB entry, you can request a page by following the instructions here: https://www.steamgriddb.com/faq. Make sure to upload art to your newly created SteamGridDB page.

Sometimes, when you generate your app list in Steam ROM Manager, your ROM does not match properly to a game title and either uses incorrect art or does not display art at all. You can solve this issue two ways: editing the file name or by creating an exception in Steam ROM Manager. Follow the steps below to properly match your ROM to its respective page on SteamGridDB.


Step One: Correct the File Name

First, check https://www.steamgriddb.com/ to see if your game has an entry. If it is missing, create one by following the instructions here: https://www.steamgriddb.com/faq. If it exists, make sure your ROM file name matches the SteamGridDB entry as closely as possible.

Open your ROM folder, edit the ROM file name in your ROM folder directly to match the SteamGridDB entry.

If your ROM is still not matching correctly, proceed to Step Two: Create An Exception in Steam ROM Manager below.


Step Two: Create An Exception in Steam ROM Manager

Select one of the methods below


Method 1: Use the "Fix Match" button

  1. Generate an app list
  2. Hover over the incorrectly matching ROM
  3. Click the magnifying glass in the bottom left
  4. Select the correct entry on the right
  5. Click Save and close in the top right
  6. The new entry will be automatically applied and Steam ROM Manager will add a new entry for this ROM to the Exceptions manager, which can be found on the left side of the screen
    • You can use the exceptions manager to delete or edit any of the changes you made

Method 2: Use the Exceptions Manager

If correcting the file name does not work, you can create an exception in Steam ROM Manager. On the left side of the Steam ROM Manager GUI, click the Exceptions button. On the right of this menu, you can add an exception. Use the following format:

Extracted Title:

To find your extracted title:

  • Select the game's parser (Example: if it's a Gamecube game, select the Nintendo Gamecube - Dolphin Parser). Click Test Parser at the bottom. You will see a list of your games on this page. Look for the Extracted Title for the game you are correcting. Place that title in the Extracted Title field.

New Display Title: The name you want it to show

New Search Title: ${gameid:#####}

To find your gameid:

New Commandline Args: Leave this entry blank


How to Hide an Entry in Steam ROM Manager

Back to the Top

Steam ROM Manager comes with a powerful exceptions manager which allows you to hide entries from your app list and prevents these entries from being added to Steam as non-Steam games.

Common use cases may include:

  • Selectively hide entries in a large ROM set
  • Hide multi-disc games
  • Exceptions using Method 1: Use the "Exclude Apps" button" hide ROM entries on a per parser basis
    • For systems with multiple emulators, you can use this feature to select which emulator you would like to use for specific ROMs
      • For example, If you would like to only run Mario + Rabbids Kingdom Battle through Ryujinx:
        • Enable the Ryujinx parser, hide all of the entries except for Mario + Rabbids Kingdom Battle and save your app list. This will only add Mario + Rabbids Kingdom Battle to Steam and only hide the entries for the Ryujinx parser

Select one of the following methods to hide an entry in Steam ROM Manager


Method 1: Use the "Exclude Apps" button

  1. Generate an app list
  2. In the bottom right, click Exclude Apps
  3. (Optional) If you are using this feature to exclude multi-disc games, you can identify which disc corresponds to which entry by hovering over the entry name in the top left of the respective box
  4. Select the entries you would like to hide
    • Selected entries will be dimmed and any selected entries will not be added to Steam
    • If you accidentally hide an entry, click the Exceptions button on the top left of the Steam ROM Manager GUI and remove it from the Exceptions list on the right
  5. After you are finished selecting the entries you would like to hide, click the Save Exclusions button in the top right
  6. Any selected entries will be be removed from the app list and Steam ROM Manager will add a new entry for this ROM to the Exceptions manager, which can be found on the left side of the screen
    • You can use the exceptions manager to "un-hide" any entries by removing the matching created exception

Method 2: Use the Exceptions Manager

On the left side of the Steam ROM Manager GUI, click the Exceptions button. On the right of this menu, you can add an exception. Use the following format:

Extracted Title:

To find your extracted title:

  • Select the game's parser (Example: if it's a PS2 game, select the Sony Playstation 2 - PCSX2 Parser). Click Test Parser at the bottom. You will see a list of your games on this page. Look for the Extracted Title for the game you are correcting. Place that title in the Extracted Title field.

New Display Title: Leave this entry blank

New Search Title: Leave this entry blank

New Commandline Args: Leave this entry blank

Exclude Title: Make sure this is toggled on, indicated with a green color.


How to Manage ROMs with Multiple Discs

Back to the Top

If you are using ROMs with multiple discs, it is recommended to create an M3U file and treat this newly created M3U file as the game. To learn more about M3U files, read How to Manage ROMs with Multiple Discs.

However, your M3U file and disc files will parse as separate entries in Steam ROM Manager. Fortunately, it is easy to hide the discs and only parse the M3U file to keep your Steam library neat and tidy.

Note: PCSX2 does not support M3U files. You can still use this section to hide any additional discs and only parse Disc 1. Read PCSX2 - How to Manage Multiple Discs for additional information.

Here's How

  1. Generate an app list
  2. In the bottom right, click Exclude Apps
  3. To identify which disc corresponds to which entry, hover over the entry name in the top left of the respective box
  4. Select the entries you would like to hide
    • Selected entries will be dimmed and any selected entries will not be added to Steam
    • If you accidentally hide an entry, click the Exceptions button on the top left of the Steam ROM Manager GUI and remove it from the Exceptions list on the right
  5. After you are finished selecting the entries you would like to hide, click the Save Exclusions button in the top right
  6. Any selected entries will be be removed from the app list and Steam ROM Manager will add a new entry for this ROM to the Exceptions manager, which can be found on the left side of the screen
    • You can use the exceptions manager to "un-hide" any entries by removing the matching created exception

How to Hide ROMs on a Per Parser Basis

Back to the Top

For systems with multiple emulators, you can use Steam ROM Manager's exception manager to select which emulator you would like to use for specific ROMs.

For example, If you would like to only run Mario + Rabbids Kingdom Battle through Ryujinx, you could hide Mario + Rabbids Kingdom Battle from the Yuzu parser and only parse it to run through Ryujinx.

Here's How

Mario + Rabbids Kingdom Battle will be used as an example in the below guide. The photos used will demonstrate how to hide it from the Yuzu parser and only parse it to run through Ryujinx.

  1. Generate an app list
  2. To identify which entries correspond with what parsers, click the Parser Title dropdown at the top and select a specific parser
    • Selected parsers in this drop-down menu will be indicated by a green |
  3. In the bottom right, click Exclude Apps
  4. Select the entries you would like to hide
    • Selected entries will be dimmed and any selected entries will not be added to Steam
    • If you accidentally hide an entry, click the Exceptions button on the top left of the Steam ROM Manager GUI and remove it from the Exceptions list on the right
  5. After you are finished selecting the entries you would like to hide, click the Save Exclusions button in the top right
  6. Any selected entries will be be removed from the app list and Steam ROM Manager will add a new entry for this ROM to the Exceptions manager, which can be found on the left side of the screen
    • You can use the exceptions manager to "un-hide" any entries by removing the matching created exception

How to Remove All Shortcuts From Your Steam Library

Back to the Top

Preface

This setting removes all of your ROMs from your Steam library. It does not remove the ROM files. It is a way to clean up, debug, or reduce the amount of ROMs you have in your Steam library.

Tutorial

  1. Open Steam ROM Manager
  2. Click Settings on the left
  3. Click the Remove all added app entries on the top left of the screen
  4. Wait
  5. All of your ROMs have now been removed from your Steam library (However, they are not deleted from your drive)

Visual Reference:


How to Customize Artwork for your ROMs

Back to the Top

After generating an app list: #how-to-generate-and-save-an-app-list, click Select Type in the top right and select which type of artwork you would like to choose for your ROM

Visual Reference:

Types of Art

  • Grids: Grids appear as the poster art in your Steam library. When you open your library, you will see two types of grids for your game, a horizontal and vertical grid
    • Steam ROM Manager splits grids into Grids and Posters. In the context of Steam ROM Manager, Grids are horizontal and Posters are vertical
    • Example Grid:
    • Example Poster:
  • Heroes: When you select a game, you will see a large piece of artwork on the top of the screen. This artwork is the hero art for your game
    • Example Hero:
  • Logos: When you select a game, you will see a tiny piece of artwork above the game name. This artwork is the logo art for your game
    • Example Logo:
  • Icons: When you press the Steam button in game, the artwork in the top left screen on the Steam overlay is the icon for your game
    • Example Icon:

How to Change Themes

Back to the Top

Depending on which theme you are using, the Settings button may be located in a different place. For the Deck and Classic theme, the Settings button is located in the top left. For the EmuDeck theme, the settings button is located in the bottom right.

  1. Select the Settings button
  2. Under General Settings, click the drop-box next to Select Theme and select your theme

Theme Showcase


Classic:


Deck:


EmuDeck:


How to Backup Your Image Choices

Back to the Top

A recent Steam ROM Manager update features a new easy import/export feature to backup your image choices.

Common use cases may include:

  • Backup your image choices in case you decide to reset your device
  • Transfer your image choices to another device

Here's How

Exporting

  1. Generate an app list
  2. Click Export image choices
  3. Select a folder for backup
  4. The folder will contain all of your image choices as well as a selections.json for the respective parsers you enabled
  5. Backup or transfer this folder

Importing

  1. Generate an app list
  2. Click Import image choices
  3. Select the folder you backed up in Exporting
  4. Steam ROM Manager will import all of your image choices from the respective parsers you enabled in Exporting

⚠️ **GitHub.com Fallback** ⚠️