From 3678cb00748906bab64b3f46839b3e9f95fa508e Mon Sep 17 00:00:00 2001 From: Georges-Antoine Assi Date: Thu, 23 Jul 2026 19:53:07 -0400 Subject: [PATCH] Document scan.priority.region_mode Covers the new region_mode key (prefer_rom_tags default, prefer_config opt-in) added in rommapp/romm#3917. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/reference/configuration-file.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/reference/configuration-file.md b/docs/reference/configuration-file.md index 6225190..ac24a07 100644 --- a/docs/reference/configuration-file.md +++ b/docs/reference/configuration-file.md @@ -224,6 +224,21 @@ scan: - "jp" ``` +### `scan.priority.region_mode` + +Controls how ScreenScraper applies `scan.priority.region` when picking regional media. With the default `prefer_rom_tags`, the region tags in the ROM's own filename win and `scan.priority.region` only reorders those tags. With `prefer_config`, the configured regions come first, so you can pull the FR box for an `(Europe)` dump even when `fr` is not in the filename, then fall back to the ROM's tags when a preferred region has no media. + +**Default:** `prefer_rom_tags` + +```yaml +scan: + priority: + region: + - "fr" + - "eu" + region_mode: "prefer_config" +``` + ### `scan.priority.language` Preferred localisation language.