From 3fbc66ae3b31ea0bf4baff2112840a9dadde3231 Mon Sep 17 00:00:00 2001 From: Julien Loir <6706489+Namaneo@users.noreply.github.com> Date: Thu, 16 Apr 2026 09:36:11 +0200 Subject: [PATCH 1/5] Improve ES-DE documentation --- docs/Getting-Started/Metadata-Providers.md | 86 ++++++++++++++++++++++ 1 file changed, 86 insertions(+) diff --git a/docs/Getting-Started/Metadata-Providers.md b/docs/Getting-Started/Metadata-Providers.md index 1baaa73f..18b7d639 100644 --- a/docs/Getting-Started/Metadata-Providers.md +++ b/docs/Getting-Started/Metadata-Providers.md @@ -154,6 +154,92 @@ library/ └─ etc... ``` + + +```xml + + + + + ./game.gba + + + Game Title + A fun game to play + en + USA + + + 0.8 + 19990615T000000 + Developer Inc. + Publisher Co. + Game Series + Action + 1-2 + f1234567890abcdef1234567890abcde + + + ./images/game.png + ./covers/game.png + ./backcovers/game.png + ./3dboxes/game.png + ./fanart/game.png + ./manuals/game.pdf + ./marquees/game.png + ./miximages/game.png + ./physicalmedia/game.png + ./screenshots/game.png + ./titlescreens/game.png + ./thumbnails/game.png + + + + ... + + ... + +``` + +#### ES-DE metadata + +Here are the text properties that will be read from `gamelist.xml`. + +| Property Name | Description | +|---------------|---------------------------------| +| name | Game title | +| desc | Game description or synopsis | +| lang | Game language (En, Es, etc.) | +| region | Game region (USA, Europe, etc.) | +| rating | Game rating score | +| releasedate | Game release date | +| developer | Developer company | +| publisher | Publisher company | +| family | Game franchise or series | +| genre | Game category or type | +| players | Number of players supported | +| md5 | ROM file hash identifier | + +#### ES-DE medias + +RomM have two ways of mapping media files: first it looks at `gamelist.xml` for properties, and fallbacks to looking at nested folders for images that have the same name as the rom. + +| Property Name | Folder Name | Description | +|---------------|---------------|----------------------------------------| +| image | images | General game image | +| cover | covers | Front cover artwork | +| backcover | backcovers | Back cover artwork | +| box3d | 3dboxes | 3D box artwork | +| fanart | fanart | Fan-made artwork | +| manual | manuals | Game instruction manual | +| marquee | marquees | Arcade game marquee or header | +| miximage | miximages | Composite or mixed artwork | +| physicalmedia | physicalmedia | Physical media (cartridge, disc, etc.) | +| screenshot | screenshots | In-game screenshot | +| title_screen | titlescreens | Game title screen | +| thumbnail | thumbnails | Small preview image | +| video | videos | Gameplay video or trailer | + #### ES-DE settings Here are the settings you need to change so RomM can read your artwork and gamelist.xml files from the same folder that holds your ROMs. From 5816d9f04ae8b86bd1c58d1b4c12513c41ea23d9 Mon Sep 17 00:00:00 2001 From: Julien Loir <6706489+Namaneo@users.noreply.github.com> Date: Thu, 16 Apr 2026 16:28:06 +0200 Subject: [PATCH 2/5] Update docs/Getting-Started/Metadata-Providers.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/Getting-Started/Metadata-Providers.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/Getting-Started/Metadata-Providers.md b/docs/Getting-Started/Metadata-Providers.md index 18b7d639..9e85ef75 100644 --- a/docs/Getting-Started/Metadata-Providers.md +++ b/docs/Getting-Started/Metadata-Providers.md @@ -220,9 +220,9 @@ Here are the text properties that will be read from `gamelist.xml`. | players | Number of players supported | | md5 | ROM file hash identifier | -#### ES-DE medias +#### ES-DE media -RomM have two ways of mapping media files: first it looks at `gamelist.xml` for properties, and fallbacks to looking at nested folders for images that have the same name as the rom. +RomM has two ways of mapping media files: first it looks at `gamelist.xml` for properties, and it falls back to looking at nested folders for images that have the same name as the ROM. | Property Name | Folder Name | Description | |---------------|---------------|----------------------------------------| From 2af857036164ee7be15c40e51da6ac03e9673df2 Mon Sep 17 00:00:00 2001 From: Julien Loir <6706489+Namaneo@users.noreply.github.com> Date: Thu, 16 Apr 2026 16:30:31 +0200 Subject: [PATCH 3/5] Update docs/Getting-Started/Metadata-Providers.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/Getting-Started/Metadata-Providers.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/Getting-Started/Metadata-Providers.md b/docs/Getting-Started/Metadata-Providers.md index 9e85ef75..2e40674b 100644 --- a/docs/Getting-Started/Metadata-Providers.md +++ b/docs/Getting-Started/Metadata-Providers.md @@ -205,14 +205,14 @@ library/ Here are the text properties that will be read from `gamelist.xml`. -| Property Name | Description | -|---------------|---------------------------------| -| name | Game title | -| desc | Game description or synopsis | -| lang | Game language (En, Es, etc.) | -| region | Game region (USA, Europe, etc.) | -| rating | Game rating score | -| releasedate | Game release date | +| Property Name | Description | +|---------------|--------------------------------------------------| +| name | Game title | +| desc | Game description or synopsis | +| lang | Game language (ISO 639-1 lowercase, e.g. en, es) | +| region | Game region (USA, Europe, etc.) | +| rating | Game rating score | +| releasedate | Game release date | | developer | Developer company | | publisher | Publisher company | | family | Game franchise or series | From 15e67978d759a0679069b42959b25b95142ba781 Mon Sep 17 00:00:00 2001 From: Julien Loir <6706489+Namaneo@users.noreply.github.com> Date: Thu, 16 Apr 2026 16:36:08 +0200 Subject: [PATCH 4/5] Update Metadata-Providers.md --- docs/Getting-Started/Metadata-Providers.md | 28 +++++++++++----------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/Getting-Started/Metadata-Providers.md b/docs/Getting-Started/Metadata-Providers.md index 2e40674b..4678d00e 100644 --- a/docs/Getting-Started/Metadata-Providers.md +++ b/docs/Getting-Started/Metadata-Providers.md @@ -205,20 +205,20 @@ library/ Here are the text properties that will be read from `gamelist.xml`. -| Property Name | Description | -|---------------|--------------------------------------------------| -| name | Game title | -| desc | Game description or synopsis | -| lang | Game language (ISO 639-1 lowercase, e.g. en, es) | -| region | Game region (USA, Europe, etc.) | -| rating | Game rating score | -| releasedate | Game release date | -| developer | Developer company | -| publisher | Publisher company | -| family | Game franchise or series | -| genre | Game category or type | -| players | Number of players supported | -| md5 | ROM file hash identifier | +| Property Name | Description | +|---------------|----------------------------------| +| name | Game title | +| desc | Game description or synopsis | +| lang | Game language (en, es, it, etc.) | +| region | Game region (us, eu, jp, etc.) | +| rating | Game rating score | +| releasedate | Game release date | +| developer | Developer company | +| publisher | Publisher company | +| family | Game franchise or series | +| genre | Game category or type | +| players | Number of players supported | +| md5 | ROM file hash identifier | #### ES-DE media From 9e928769057ee8822f380d52e97eb55abc4f6cfd Mon Sep 17 00:00:00 2001 From: Julien Loir <6706489+Namaneo@users.noreply.github.com> Date: Thu, 16 Apr 2026 17:37:03 +0200 Subject: [PATCH 5/5] trunk fmt --- docs/Getting-Started/Metadata-Providers.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/Getting-Started/Metadata-Providers.md b/docs/Getting-Started/Metadata-Providers.md index 4678d00e..1246b101 100644 --- a/docs/Getting-Started/Metadata-Providers.md +++ b/docs/Getting-Started/Metadata-Providers.md @@ -154,7 +154,6 @@ library/ └─ etc... ``` - ```xml @@ -206,7 +205,7 @@ library/ Here are the text properties that will be read from `gamelist.xml`. | Property Name | Description | -|---------------|----------------------------------| +| ------------- | -------------------------------- | | name | Game title | | desc | Game description or synopsis | | lang | Game language (en, es, it, etc.) | @@ -225,7 +224,7 @@ Here are the text properties that will be read from `gamelist.xml`. RomM has two ways of mapping media files: first it looks at `gamelist.xml` for properties, and it falls back to looking at nested folders for images that have the same name as the ROM. | Property Name | Folder Name | Description | -|---------------|---------------|----------------------------------------| +| ------------- | ------------- | -------------------------------------- | | image | images | General game image | | cover | covers | Front cover artwork | | backcover | backcovers | Back cover artwork |