Differences

This shows you the differences between two versions of the page.

--- doc:appunti:software:kodi_thumb [2022/02/03 08:39] – created niccolo
+++ doc:appunti:software:kodi_thumb [2022/02/03 11:48] (current) – [Web References] niccolo
@@ Line 1: / Line 1: @@
 ====== Kodi Thumbnails (Anteprima) ======
-Ogni elemento nella libreria video di Kodi può essere corredato, oltre che dai metadati, anche da delle immagini, chiamate //artwork//. Le artwork possono essere di vario tipo, quello supportato è il thumbnail abbreviato **thumb**, in italiano **Anteprima**. Non è l'artwork preferita dalle moderne skin di Kodi, essendo stata soppiantata dall'artwork di tipo **poster**. Tuttavia in assenza di artwork fornite espressamente, Kodi estrae un fotogramma dal file video e lo utilizza come **artwork di tipo thumb**.
+Ogni elemento nella libreria video di Kodi può essere corredato, oltre che dai metadati, anche da delle immagini, chiamate //artwork//. Le artwork possono essere di vario tipo; quello supportato fin dalle primissime versioni di Kodi (quando si chiamava ancora XBMC) è il thumbnail abbreviato **thumb**, in italiano **Anteprima**. Non è l'artwork preferita dalle moderne skin di Kodi, essendo stata soppiantata dall'artwork di tipo **poster**. Tuttavia in assenza di artwork fornite espressamente, Kodi estrae un fotogramma dal file video e lo utilizza come **artwork di tipo thumb**.
 Come **information provider** per i video preferisco utilizzare il **Local information only**, cioè per ogni file video creo il relativo file **.nfo** con i metadati e un file **.tbn** con la miniatura (file JPEG o PNG), tuttavia con la versione Kodi 19 Matrix l'utilizzo dei file .tbn **non è più supportato** correttamente.
@@ Line 16: / Line 16: @@
 Sarà la skin scelta a determinare dove e come viene utilizzato l'artwork. Ad esempio la skin predefinita Estuary utilizza la //thumb// solo come ultima possibilità, se non esistono le altre. Come impostazione predefinita, se non esistono artwork per un film, viene estratto automaticamente un fotogramma dal file stesso e considerato come artwork di tipo //thumb//. L'abilità di **estrarre un fotogramma** da un video per crearne la miniatura è disattivabile da **Settings** => **Media** => **Videos** => **Artwork** => **Extract thumbnails from video files**.
-L'artwork di tipo //thumb// non è espressamente elencata fra gli [[https://kodi.wiki/view/Movie_artwork|artwork specifici per i film]], ma viene documentata nell'elenco dei [[https://kodi.wiki/view/Artwork_types|tipi di artwork]], quindi è supportata, sebbene non sia quella preferita per mostrare i film.
+**ATTENZIONE**: L'artwork di tipo //thumb// non è espressamente elencata fra gli [[https://kodi.wiki/view/Movie_artwork|artwork specifici per i film]], ma viene documentata nell'elenco dei [[https://kodi.wiki/view/Artwork_types|tipi di artwork]], quindi è supportata, sebbene non sia quella preferita.
 Fino alla versione **18 Leia** di Kodi era sufficiente salvare i file **.nfo** e **.tbn** nella stessa directory del file video, quindi dal menu contestuale scegliere **Scan to library**: i metadati venivano aggiornati rileggendo il file .nfo e l'anteprima (//thumb//) era impostata dal file .tbn.
-Con **Kodi 19 Matrix** la funzione **Scan to library** (che agisce sul singolo video) cosi come la **Update library** (che agisce su tutti i file video) rilegge solo l'eventuale file .nfo, ma **ignora la miniatura .tbn**. Fino alla versione 18 di Kodi esisteva anche l'add-on **[[https://rmrector.github.io/script.artwork.beef/|Artwork Beef]]**, in grado di aggiungere gli artwork (non solo miniature, ma anche poster, fanart, ecc) sia da siti internet che da file locali.
+Con **Kodi 19 Matrix** la funzione **Scan to library** (che agisce sul singolo video) così come la **Update library** (che agisce su tutti i file video) rilegge solo l'eventuale file .nfo, ma **ignora la miniatura .tbn**. Fino alla versione 18 di Kodi esisteva anche l'add-on **[[https://rmrector.github.io/script.artwork.beef/|Artwork Beef]]**, in grado di aggiungere gli artwork (non solo miniature, ma anche poster, fanart, ecc) sia da siti internet che da file locali.
+===== Thumbnail da file locale con Kodi 19 Matrix =====
+Per chi come me ha una collezione storica di file .tbn, la soluzione più efficace per utilizzarli con Kodi 19 Matrix è quella di rinominare tutti i file in **%%<movie>-thumb.jpg%%** ed eseguire una nuova **Update library**.
+Si tenga presente che la skin **Estuary** utilizza di preferenza l'artwork **poster** per mostrare il film nella modalità **Wall**. In tal caso l'immagine in orientamento //portrait// occupa tutto il rettangolo assegnato al film. Se l'artwork poster non esiste allora la skin presenta nello stesso rettangolo l'artwork **thumb** in orientamento //landscape// corredato da una etichetta sottostante con il titolo del film recuperato dai metadati oppure con il nome del file.
 ===== Forzare l'uso dei .tbn con Kodi 19 Matrix =====
-È ancora possibile utilizzare i file .tbn con Kodi 19, facendoli acquisire come artwork di tipo thumb, tuttavia si tratta di una funzione **deprecata** e **non supportata**.
+È ancora possibile utilizzare i file .tbn con Kodi 19, facendoli acquisire come artwork di tipo thumb, tuttavia si tratta di una funzione **deprecata** e **non supportata**. Si può utilizzare la funzione **Refresh** oppure utilizzare la **API HTTP**.
 ==== Refresh ====
-Dop aver eseguito uno **Scan to library** sul singolo file oppure un **Update library** generale, il video avrà la miniatura generica (icona della cinepresa bianca su sfondo nero).
+Dop aver eseguito uno **Scan to library** sul singolo file oppure un **Update library** generale, il video avrà la miniatura generica (icona della cinepresa bianca su sfondo nero). Per forzare l'acquisizione del file .tbn:
   * Aprire il menu contestuale sul video, scegliere **Information**
   * Dalla schermata delle informazioni eseguire **Refresh**
-  * Chiudere la schermata con **Esc**.
+  * Chiudere la schermata con **Esc**
 ==== Kodi HTTP API ====
@@ Line 75: / Line 81: @@
 Nell'attributo thumbnail di tipo **%%image://%%** il percorso del video o della miniatura è assoluto e codificato come URL, cioè ad esempio il carattere slash (**%%/%%**) è //escaped// come **%%%2f%%**.
-===== Thumbnail da file locale con Kodi 19 Matrix =====
+===== Artwork personalizzati =====
-Per chi come me ha una collezione storica di file .tbn, la soluzione più efficace per utilizzarli con Kodi 19 Matrix è quella di rinominare tutti i file in **%%<movie>-thumb.jpg%%** ed eseguire una nuova **Update library**.
+È possibile creare altri tipi di artwork con nome arbitrario, ad esempio **%%<movie>-<bestartwork>.jpg%%**, ovviamente sarà compito della skin utilizzarli in qualche contesto. Kodi terrà in considerazione questi artwork custom durante la scansione/aggiornamento della libreria.
-Si tenga presente che la skin **Estuary** utilizza di preferenza l'artwork **poster** per mostrare il film nella modalità **Wall**. In tal caso l'immagine in orientamento //portrait// occupa tutto il rettangolo assegnato al film. Se l'artwork poster non esiste allora la skin presenta nello stesso rettangolo l'artwork **thumb** in orientamento //landscape// corredato da una etichetta sottostante con il titolo del film recuperato dai metadati oppure con il nome del file.
+Per definire un artwork personalizzato:
+  * Dal menu **Information** di un video selezionare l'icona **Choose art**.
+  * Nella dialog box selezionare il pulsante **Add art type**.
+  * Digitare un nome arbitrario, diverso dagli [[https://kodi.wiki/view/Artwork_types|artwork esistenti]], ad esempio **bestartwork**.
+Se viene aggiunto un artwork personalizzato, questo verrà memorizzato nel database **.kodi/userdata/Database/MyVideos119.db**. Dalla interfaccia Kodi sembra che non sia possibile dimenticare questo nuovo tipo, che verrà presentato ogni volta che si eseguirà la funzione **Choose art**.
+Si può eventualmente intervenire direttamente sul database utilizzando il client **sqlite3**:
+<code>
+sqlite3 /storage/.kodi/userdata/Database/MyVideos119.db
+</code>
+Conviene verificare quali artwork esistono di tipo personalizzato:
+<code sql>
+SELECT * FROM art WHERE media_type = 'movie' AND type = 'bestartwork';
+</code>
+Quindi sarà possibile rimuovere l'informazione dal database:
+<code sql>
+DELETE FROM art WHERE media_type = 'movie' AND type = 'bestartwork';
+</code>
+===== Web References =====
   * **[[https://github.com/xbmc/xbmc/issues/20937|Local information provider does not consider local thumbnails for movies]]**