From 4079aac7a4ab918be35844c19cf20ecc0da06738 Mon Sep 17 00:00:00 2001 From: Georges-Antoine Assi Date: Fri, 25 Sep 2026 21:48:23 -0400 Subject: [PATCH 1/2] docs: note custom platform icons only apply to the classic UI The new UI picks platform icons from a list built into the image (rommapp/romm#4792), so icons bind-mounted over /var/www/html/assets/platforms no longer show there. Co-Authored-By: Claude Opus 5.5 (1M context) --- docs/platforms/custom-platforms.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/platforms/custom-platforms.md b/docs/platforms/custom-platforms.md index da260019..4a4d3458 100644 --- a/docs/platforms/custom-platforms.md +++ b/docs/platforms/custom-platforms.md @@ -46,6 +46,10 @@ This gets you full metadata provider support with your preferred folder name (se If your platform isn't in [the built-in icons list](https://github.com/rommapp/romm/tree/master/frontend/assets/platforms), RomM shows a default fallback icon. + +!!! warning "Classic UI only" + The new UI only shows the icons built into the RomM image. It picks which icon to load from a list made when the image is built, so it never requests files you mount yourself. Custom and replacement icons from the mount below appear in the classic UI only. + To load your own: 1. Mount the platform icons directory From 7b04219d239630f1f5435d1872e98ab084634d78 Mon Sep 17 00:00:00 2001 From: Georges-Antoine Assi Date: Fri, 25 Sep 2026 21:53:19 -0400 Subject: [PATCH 2/2] docs: remove the custom platform icon guide The new UI only loads the icons built into the image (rommapp/romm#4792), and the classic UI is being removed, so bind-mounting custom icons is no longer supported. Co-Authored-By: Claude Opus 5.5 (1M context) --- docs/platforms/custom-platforms.md | 47 ------------------------------ 1 file changed, 47 deletions(-) diff --git a/docs/platforms/custom-platforms.md b/docs/platforms/custom-platforms.md index 4a4d3458..71b13f39 100644 --- a/docs/platforms/custom-platforms.md +++ b/docs/platforms/custom-platforms.md @@ -3,8 +3,6 @@ title: Custom Platforms description: Add custom unsupported platforms --- - - # Custom Platforms RomM ships with support for ~400 platforms. If yours isn't in [the list](supported-platforms.md), you can still load it as a custom platform, but we won't have metadata provider coverage for it. @@ -41,48 +39,3 @@ system: ``` This gets you full metadata provider support with your preferred folder name (see [Configuration File → `system.platforms`](../reference/configuration-file.md#systemplatforms)). - -## Adding a custom platform icon - -If your platform isn't in [the built-in icons list](https://github.com/rommapp/romm/tree/master/frontend/assets/platforms), RomM shows a default fallback icon. - - -!!! warning "Classic UI only" - The new UI only shows the icons built into the RomM image. It picks which icon to load from a list made when the image is built, so it never requests files you mount yourself. Custom and replacement icons from the mount below appear in the classic UI only. - -To load your own: - -1. Mount the platform icons directory - -Bind-mount a host directory onto the container's icon path: - -```yaml -services: - romm: - volumes: - - /path/to/your/icons:/var/www/html/assets/platforms -``` - -2. Seed it with the official icons - -The built-in icons live at [`frontend/assets/platforms`](https://github.com/rommapp/romm/tree/master/frontend/assets/platforms). Download them all and drop into your mounted directory, otherwise built-in platforms lose their icons too (because your mount overrides the whole directory). - -3. Add your custom `.ico` files - -The filename has to **match the platform slug**. Examples: - -| Platform | Platform slug | Filename | -| ------------------- | ------------------------------ | ------------------------- | -| Amstrad CPC | `acpc` | `acpc.ico` | -| My Homebrew Console | `my-homebrew-console` (custom) | `my-homebrew-console.ico` | -| NES | `nes` | `nes.ico` | - -4. Restart RomM - -`docker compose up -d` picks up the new icon mount. - -To replace an existing platform's icon, use a filename matching an existing platform's slug and your file overrides the built-in. - -## Screenshot - -Platforms view with custom icons