[Script] Localiser en français les .nfo générés par Sonarr + image

Cet outil, développé en Python puis packagé en binaire avec PyInstaller, permet d’analyser un répertoire de séries TV dont les métadonnées .nfo ont été générées par Sonarr. Son objectif est de relire ces métadonnées et d’utiliser l’API de TMDB afin de remplacer automatiquement le contenu des balises <title> et <plot> dans la langue de ton choix.

Le programme peut aussi, de manière optionnelle, récupérer les images localisées dans cette langue lorsque celles-ci sont disponibles sur TMDB. Il facilite ainsi la relocalisation complète des métadonnées textuelles, et éventuellement visuelles, d’une bibliothèque de séries déjà structurée par Sonarr.

Télécharger et installer

wget https://codeberg.org/waazaa/unraid-packages/raw/branch/main/sonarr-nfo-localizer/sonarr-nfo-localizer-Unraid.txz && installpkg sonarr-nfo-localizer-Unraid.txz

Ce paquet contient un binaire créé par pyinstaller depuis ce script python:

https://codeberg.org/waazaa/sonarr-metadata-localizer/src/branch/main/root/app/nfo_jellyfin.py

Cela permet d'éviter d'installer l'environnement python.

Fonctionnement

Une fois le paquet installé, vous pouvez accéder à l’application sonarr-nfo-localizer et l’utiliser comme suit.

Commencez par créer un fichier de configuration, par exemple .env, contenant les variables d’environnement ci-dessous. Vous pourrez ensuite adapter chaque valeur selon vos besoins :

export TMDB_API_KEY=27xxxxxxxxxxxxxxxxxxxc

export TMDB_LANGUAGE=fr-FR

export TMDB_IMAGE_LANGUAGE=fr,null

export DOWNLOAD_IMAGES=true

export SKIP_EMPTY=true

export UPDATE_SHOW_TITLE=false

export SERIES_COVER_NAME=cover.jpg

export SERIES_POSTER_NAME=poster.jpg

export SERIES_BACKDROP_NAME=backdrop.jpg

export SERIES_LOGO_NAME=logo.png

export SLEEP_BETWEEN_REQUESTS=0.25

export HTTP_TIMEOUT=25

Description des variables

• TMDB_API_KEY : votre clé d’API TMDB, requise pour interroger TMDB.

• TMDB_LANGUAGE : la langue à utiliser pour les métadonnées textuelles récupérées depuis TMDB, comme les titres et les résumés. Exemple : fr-FR.

• TMDB_IMAGE_LANGUAGE : la langue préférée pour les images localisées. La valeur fr,null signifie que l’outil cherchera d’abord des images en français, puis utilisera des images sans langue spécifiée si aucune n’est disponible.

• DOWNLOAD_IMAGES : active ou désactive le téléchargement des images. Définissez cette variable à true pour télécharger les images localisées, ou à false pour les ignorer.

• SKIP_EMPTY : si cette variable est définie à true, l’outil évitera de remplacer des champs existants par des valeurs vides renvoyées par TMDB.

• UPDATE_SHOW_TITLE : si cette variable est définie à true, le titre de la série sera également mis à jour. Si elle est définie à false, le titre existant sera conservé tel quel.

• SERIES_COVER_NAME : nom du fichier de sortie à utiliser pour l’image de couverture de la série.

• SERIES_POSTER_NAME : nom du fichier de sortie à utiliser pour l’affiche de la série.

• SERIES_BACKDROP_NAME : nom du fichier de sortie à utiliser pour l’image d’arrière-plan de la série.

• SERIES_LOGO_NAME : nom du fichier de sortie à utiliser pour le logo de la série.

• SLEEP_BETWEEN_REQUESTS : délai, en secondes, inséré entre les requêtes API afin d’éviter de solliciter TMDB de manière trop agressive.

• HTTP_TIMEOUT : délai d’expiration HTTP maximal, en secondes, pour les requêtes API et les téléchargements d’images.

Exécution de la commande

Une fois votre fichier de configuration prêt, lancez l’outil avec :

source .env && sonarr-nfo-localizer /path/to/tvshows

Cette commande charge les variables d’environnement depuis le fichier .env, puis exécute sonarr-nfo-localizer sur le répertoire cible contenant vos séries TV.

Pour obtenir les versions francaises des informations comme c'est le paramétrage par défaut vous pouvez aussi juste lancer le binaire sans fichier contenant les variables simplement en lui indiquant la clef API TMDB:

sonarr-nfo-localizer --api-key 27xxxxxxxxxxxxxxxxxxxc /path/to/tvshows

Edited April 23Apr 23 by waazaa