RomM (Rom Manager)

Inspired by Jellyfin and after found that the awesome Gameyfin project is not supported for arm64 architectures and it is a general game library manager, I decided to develop my own game library solution, focused on retro gaming.

For now, it is only available as a docker image (amd64/arm64)

• Scans your game library (all at once or by platform) and enriches it with IGDB metadata
• Access your library via your web-browser
• Possibility to select one of the matching IGDB results if the scan doesn't get the right one
• EmuDeck folder structure compatibility
• Download games directly from your web-browser
• Edit your game files directly from your web-browser
• Region, revision/version and extra tags support
• Works with SQLite or MaridDB (SQLite by default)
• Responsive design
• Light and dark theme

• Upload games directly from your web-browser - issue #54
• Manage save files directly from your web-browser - issue #55
• Set a custom cover for each game - issue #53
• Multiple files games support - issue #40

RomM accepts two different folder structure by priority.

RomM will try to find the structure 1 and if it doesn't exists, RomM will try to find structure 2.

• Structure 1 (priority high) - roms folder at root of library folder:

library/
├─ roms/
   ├─ gbc/
   │  ├─ rom_1.gbc
   │  ├─ rom_2.gbc
   │
   ├─ gba/
   │  ├─ rom_1.gba
   │  ├─ rom_2.gba
   │ 
   ├─ gb/
      ├─ rom_1.gb
      ├─ rom_1.gb

• Structure 2 (priority low) - roms folder inside each platform folder

library/
├─ gbc/
│  ├─ roms/
│     ├─ rom_1.gbc
│     ├─ rom_2.gbc
|
├─ gba/
│  ├─ roms/
│     ├─ rom_1.gba
│     ├─ rom_2.gba
|
├─ gb/
│  ├─ roms/
│     ├─ rom_1.gb
│     ├─ rom_1.gb

Last version of the docker image

Check the docker-compose.yml example

Get API key from IGDB for the CLIENT_ID and CLIENT_SECRET variables.

RomM can be configured through a yml file. This is used to exclude folders and files with a certain extension to be scanned. For a configuration change to take effect, RomM must be restarted.

Config file example:

exclude:
  folders:
    - 'folder_1_to_exclude'
    - 'folder_2_to_exclude'
  files:
    - 'txt'
    - 'file_extension_to_exclude'

If the RomM folder structure is followed, any kind of platform/folder-name is supported for the core features. For having extra metadata as well as cover images and platforms icons, the following table shows how to name your platforms folders. This will change over the time, adding games metadata for more platforms. Make sure that the platforms folder names are lowercase.

Games can be tagged with region, revision or other tags using parenthesis in the file name. Region and revision tags must be built with the following reserved words:

• Region tags must be prefixed with "reg-": (reg-EUR) / (reg-USA) / (reg-Japan) / (reg-whatever)
• Revision tags must be prefixed with "rev-": (rev-1) / (rev-v2) / (rev-whatever)
• Any other tag can have any structure
• Example: my_game (reg-EUR)(rev-1)(aditional_tag_1)(aditional_tag_2).gba

Tags can be used with the search bar to help to filter your library.

• After the first installation, sometimes the RomM container can have problems connecting with the database. Restarting the RomM container may solve the problem.

• Complete changelog

• Pc icon support - Keyboard and mouse icons created by Flat Icons - Flaticon