github rommapp/romm 4.3.0-alpha.1
v4.3.0-alpha.1

latest release: 4.3.0-alpha.2
pre-release12 hours ago

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:

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.

Screenshot_2025-09-21_at_9 39 57_PM

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

Bug Fixes

Other

New Contributors

Full Changelog: 4.2.0...4.3.0-alpha.1

Don't miss a new romm release

NewReleases is sending notifications on new releases.