RomM

[!NOTE] Due to a large number of issues reported during setup, as of this release, the config.yml file is no longer required to run the app. We still recommend you create one and mount it, as it will allow you to configure the app through the UI.

New Features

Flashpoint Project integration

Automated search of the Flashpoint Project database for over 180,000+ flash and browser-based games. Enable the metadata source by setting FLASHPOINT_API_ENABLED=true in your environment variables, run a partial metadata scan with Flashpoint selected, and we’ll attempt to match games inside the browser platform folder against the database. #2326

HowLongToBeat integration

HowLongToBeat is a website that provides game completion times for over 84,000+ games. Enable the metadata source by setting HLTB_API_ENABLED=true in your environment variables and run a partial metadata scan with HowLongToBeat selected. If a match is found, game completion times will be displayed in the game details view, under a new tab. #2437

Metadata tags in filenames

Scans will now parse custom metadata tags in the filename that match specific patterns, and use them to fetch game metadata for the specified ID. The supported tags are:

• (igdb-xxxx) for IGDB
• (moby-xxxx) for MobyGames
• (ra-xxxx) for RetroAchievements
• (ssfr-xxxx) for ScreenScraper
• (launchbox-xxxx) for Launchbox
• (hltb-xxxx) for HowLongToBeat

Note that we do not write these tags to filenames that don’t already have them, as they are non-standard and could conflict with existing tags or other software. #2401

Metadata sources status page

This new page allows you to view the status of all the metadata source, where each card will show whether the API key is set/source is enabled (🔑), and will test the connection to the source’s API in real-time (🌐). View it under “Settings > Metadata sources” or at /metadata-sources. #2464

Metadata source priority

We’ve added new options to the config.yml file to set the priority for each metadata source used during scans. Artwork sources are prioritized separately, as is metadata pulled from Screenscraper, which can be configured to use different regions and languages.

Below is the default order, which can be modified by moving sources up or down in the list. Like all other configuration options, setting this is optional, and the system will always fall back to the default order. #2466

scan:
  priority:
    metadata: # Top-level metadata source priority
      - "igdb" # IGDB
      - "moby" # MobyGames
      - "ss" # Screenscraper
      - "ra" # RetroAchievements
      - "lb" # Launchbox
      - "hasheous" # Hasheous
      - "flashpoint" # Flashpoint Project
      - "hltb" # HowLongToBeat
    artwork: # Cover art and screenshots
      - "igdb" # IGDB
      - "moby" # MobyGames
      - "ss" # Screenscraper
      - "ra" # RetroAchievements
      - "lb" # Launchbox
      - "hasheous" # Hasheous
      - "flashpoint" # Flashpoint Project
      - "hltb" # HowLongToBeat
    region: # Cover art and game title (only used by Screenscraper)
      - "us"
      - "wor"
      - "ss"
      - "eu"
      - "jp"
    language: # Cover art and game title (only used by Screenscraper)
      - "en"
      - "fr"

Minor Changes

• Animate loading text is boot svg image by @gantoine in https://github.com/rommapp/romm/pull/2417
• Add metadata icons to table view by @gantoine in https://github.com/rommapp/romm/pull/2410
• Remove sidebar during emulatorjs play by @gantoine in https://github.com/rommapp/romm/pull/2450
• Use default config values when config.yml not mount + show warning by @gantoine in https://github.com/rommapp/romm/pull/2457

Bug Fixes

• Fix card z-index to be behind UI elements on hover by @gantoine in https://github.com/rommapp/romm/pull/2449
• Remove mod_zip workaround for upstream subrequests to internal locations by @adamantike in https://github.com/rommapp/romm/pull/2426
• Fix release date in console mode by @gantoine in https://github.com/rommapp/romm/pull/2444
• Add missing language codes by @adamantike in https://github.com/rommapp/romm/pull/2425
• Use v-img with webp and fallback in console mode by @gantoine in https://github.com/rommapp/romm/pull/2430
• Implement file tag matching for HLTB by @gantoine in https://github.com/rommapp/romm/pull/2446
• Add launchbox to manual match window by @gantoine in https://github.com/rommapp/romm/pull/2455
• Fix icons in console mode by @gantoine in https://github.com/rommapp/romm/pull/2461
• Fix Markdown formatting of DEVELOPER_SETUP.md by @EricDuminil in https://github.com/rommapp/romm/pull/2462
• Uncompress gzipped images by @gantoine in https://github.com/rommapp/romm/pull/2468
• Update known bios slugs with correct psx slug by @gantoine in https://github.com/rommapp/romm/pull/2472

Other

• Improve API docs for Delete endpoints by @adamantike in https://github.com/rommapp/romm/pull/2413
• Manually run eslint and update rules by @gantoine in https://github.com/rommapp/romm/pull/2402
• Pre-optimize vuetify deps in development mode by @gantoine in https://github.com/rommapp/romm/pull/2421
• Bump axios from 1.8.4 to 1.12.1 in /frontend by @dependabot[bot] in https://github.com/rommapp/romm/pull/2431

New Contributors

• @EricDuminil made their first contribution in https://github.com/rommapp/romm/pull/2462

Full Changelog: https://github.com/rommapp/romm/compare/4.2.0…4.3.0-alpha.1