From ba2bfd6c9b36817728b51d5bb094ecbbdd081a24 Mon Sep 17 00:00:00 2001
From: arabcoders <admin@arabcoders.org>
Date: Tue, 16 Sep 2025 17:45:23 +0300
Subject: [PATCH] Use local downloaded thumbnail if avaliable instead of
 referencing external one

---
 ui/app/components/History.vue | 31 ++++++++++++++++++-------------
 ui/app/types/store.d.ts       | 16 ++++++++++++++++
 ui/app/utils/index.ts         | 10 +++++++++-
 3 files changed, 43 insertions(+), 14 deletions(-)

diff --git a/ui/app/components/History.vue b/ui/app/components/History.vue
index b3c1f51e..8bf45cf2 100644
--- a/ui/app/components/History.vue
+++ b/ui/app/components/History.vue
@@ -117,10 +117,8 @@
                       {{ formatTime(item.extras.duration) }}
                     </span>
                   </div>
-                  <div v-if="showThumbnails && item.extras.thumbnail">
-                    <FloatingImage
-                      :image="uri('/api/thumbnail?id=' + item._id + '&url=' + encodePath(item.extras.thumbnail))"
-                      :title="`[${item.preset}] - ${item.title}`">
+                  <div v-if="showThumbnails && getImage(item)">
+                    <FloatingImage :image="getImage(item)" :title="`[${item.preset}] - ${item.title}`">
                       <div class="is-text-overflow">
                         <NuxtLink target="_blank" :href="item.url">{{ item.title }}</NuxtLink>
                       </div>
@@ -272,22 +270,17 @@
             <figure class="image is-3by1">
               <span v-if="'finished' === item.status && item.filename" @click="playVideo(item)" class="play-overlay">
                 <div class="play-icon"></div>
-                <img @load="(e: Event) => pImg(e)"
-                  :src="uri('/api/thumbnail?id=' + item._id + '&url=' + encodePath(item.extras.thumbnail))"
-                  v-if="item.extras?.thumbnail" />
+                <img @load="(e: Event) => pImg(e)" :src="getImage(item)" v-if="getImage(item)" />
                 <img v-else src="/images/placeholder.png" />
               </span>
               <span v-else-if="isEmbedable(item.url)" @click="embed_url = getEmbedable(item.url) as string"
                 class="play-overlay">
                 <div class="play-icon embed-icon"></div>
-                <img @load="(e: Event) => pImg(e)"
-                  :src="uri('/api/thumbnail?id=' + item._id + '&url=' + encodePath(item.extras.thumbnail))"
-                  v-if="item.extras?.thumbnail" />
+                <img @load="(e: Event) => pImg(e)" :src="getImage(item)" v-if="getImage(item)" />
                 <img v-else src="/images/placeholder.png" />
               </span>
               <template v-else>
-                <img @load="(e: Event) => pImg(e)" v-if="item.extras?.thumbnail"
-                  :src="uri('/api/thumbnail?id=' + item._id + '&url=' + encodePath(item.extras.thumbnail))" />
+                <img @load="(e: Event) => pImg(e)" v-if="getImage(item)" :src="getImage(item)" />
                 <img v-else src="/images/placeholder.png" />
               </template>
             </figure>
@@ -912,6 +905,18 @@ const makePath = (item: StoreItem) => {
     return ''
   }
   const real_path = eTrim(item.download_dir, '/') + '/' + sTrim(item.filename, '/')
-  return real_path.replace(config.app.download_path, '').replace(/^\//, '')
+  return stripPath(config.app.download_path, real_path)
+}
+
+const getImage = (item: StoreItem): string => {
+  if (item.sidecar?.image && item.sidecar.image.length > 0) {
+    return uri('/api/download/' + encodeURIComponent(stripPath(config.app.download_path, item.sidecar.image[0]?.file || '')))
+  }
+
+  if (!item?.extras?.thumbnail) {
+    return '/images/placeholder.png'
+  }
+
+  return uri('/api/thumbnail?id=' + item._id + '&url=' + encodePath(item.extras.thumbnail))
 }
 </script>
diff --git a/ui/app/types/store.d.ts b/ui/app/types/store.d.ts
index c08089ab..7d755464 100644
--- a/ui/app/types/store.d.ts
+++ b/ui/app/types/store.d.ts
@@ -1,4 +1,14 @@
 type ItemStatus = 'finished' | 'preparing' | 'error' | 'cancelled' | 'downloading' | 'postprocessing' | 'not_live' | 'skip' | null;
+
+type SideCar = {
+  file: string
+}
+
+type sideCarSubtitle = SideCar & {
+  lang: string
+  name: string
+}
+
 type StoreItem = {
   /** Unique identifier for the item */
   _id: string
@@ -42,6 +52,12 @@ type StoreItem = {
   auto_start: boolean
   /** Options for the item */
   options: Record<string, unknown>
+  /** Sidecar associated with the item. */
+  sidecar: {
+    Unknown?: Array<SideCar>
+    subtitle?: Array<sideCarSubtitle>
+    image?: Array<SideCar>
+  },
   /** Extras for the item */
   extras: {
     /** Which channel the item belongs to */
diff --git a/ui/app/utils/index.ts b/ui/app/utils/index.ts
index 63be4eee..cbd3b431 100644
--- a/ui/app/utils/index.ts
+++ b/ui/app/utils/index.ts
@@ -677,10 +677,18 @@ const enableOpacity = (): boolean => {
   return true
 }
 
+const stripPath = (base_path: string, real_path: string): string => {
+  if (!base_path) {
+    return real_path
+  }
+
+  return real_path.replace(base_path, '').replace(/^\//, '')
+}
+
 export {
   separators, convertCliOptions, getSeparatorsName, iTrim, eTrim, sTrim, ucFirst,
   getValue, ag, ag_set, awaitElement, r, copyText, dEvent, makePagination, encodePath,
   request, removeANSIColors, dec2hex, makeId, basename, dirname, getQueryParams,
   makeDownload, formatBytes, has_data, toggleClass, cleanObject, uri, formatTime,
-  sleep, awaiter, encode, decode, disableOpacity, enableOpacity
+  sleep, awaiter, encode, decode, disableOpacity, enableOpacity, stripPath
 }