Add video-normalized support for ScreenScraper scan.media config

Copilot · gantoine · Copilot · commit 7f88923deee3 · 2026-03-08T20:30:16.000Z
Co-authored-by: gantoine &lt;3247106+gantoine@users.noreply.github.com&gt;
diff --git a/backend/config/config_manager.py b/backend/config/config_manager.py
@@ -77,6 +77,7 @@ class MetadataMediaType(enum.StrEnum):
     LOGO = "logo"
     FANART = "fanart"
     VIDEO = "video"
+    VIDEO_NORMALIZED = "video_normalized"
     MANUAL = "manual"
 
 
diff --git a/backend/handler/metadata/ss_handler.py b/backend/handler/metadata/ss_handler.py
@@ -118,6 +118,7 @@ class SSMetadataMedia(TypedDict):
     marquee_path: str | None
     logo_path: str | None
     video_path: str | None
+    video_normalized_path: str | None
 
 
 class SSMetadata(SSMetadataMedia):
@@ -166,6 +167,7 @@ def extract_media_from_ss_game(rom: Rom, game: SSGame) -> SSMetadataMedia:
         marquee_path=None,
         logo_path=None,
         video_path=None,
+        video_normalized_path=None,
     )
 
     for region in get_preferred_regions():
@@ -294,6 +296,10 @@ def extract_media_from_ss_game(rom: Rom, game: SSGame) -> SSMetadataMedia:
                 ss_media["video_normalized_url"] = strip_sensitive_query_params(
                     media["url"], SENSITIVE_KEYS
                 )
+                if MetadataMediaType.VIDEO_NORMALIZED in preferred_media_types:
+                    ss_media["video_normalized_path"] = (
+                        f"{fs_resource_handler.get_media_resources_path(rom.platform_id, rom.id, MetadataMediaType.VIDEO_NORMALIZED)}/video-normalized.mp4"
+                    )
 
     return ss_media
 
diff --git a/examples/config.example.yml b/examples/config.example.yml
@@ -128,6 +128,7 @@
 #     - manual # Manual (enabled by default)
 #     # Gameplay video
 #     - video  # Video (warning: large file size)
+#     - video_normalized  # Normalized video (smaller file size than video)
 #     # Media used for batocera gamelist.xml export
 #     - box2d_back  # Back cover art
 #     - logo  # Transparent logo
diff --git a/frontend/src/__generated__/models/RomSSMetadata.ts b/frontend/src/__generated__/models/RomSSMetadata.ts
diff --git a/frontend/src/components/Details/Info/MediaCarousel.vue b/frontend/src/components/Details/Info/MediaCarousel.vue
@@ -25,7 +25,9 @@ const youtubeVideoId = computed(
 
 const localVideoPath = computed(() => {
   return (
-    props.rom.ss_metadata?.video_path || props.rom.gamelist_metadata?.video_path
+    props.rom.ss_metadata?.video_path ||
+    props.rom.ss_metadata?.video_normalized_path ||
+    props.rom.gamelist_metadata?.video_path
   );
 });
 const screenshots = computed(() => props.rom.merged_screenshots);
diff --git a/frontend/src/composables/useGameAnimation.ts b/frontend/src/composables/useGameAnimation.ts
@@ -196,7 +196,8 @@ export function useGameAnimation({
     if (!romsStore.isSimpleRom(rom)) return null;
     // Only play video if boxart style is miximage
     if (boxartStyle.value !== "miximage_path") return null;
-    const ssVideo = rom.ss_metadata?.video_path;
+    const ssVideo =
+      rom.ss_metadata?.video_path || rom.ss_metadata?.video_normalized_path;
     const gamelistVideo = rom.gamelist_metadata?.video_path;
     return ssVideo || gamelistVideo || null;
   });
