À propos du projet

ytdl-sub est un outil en ligne de commande qui automatise le téléchargement de médias via yt-dlp et prépare les fichiers obtenus pour les lecteurs et serveurs multimédias populaires, notamment Kodi, Jellyfin, Plex, Emby et les lecteurs musicaux modernes. Selon le README, aucun plugin supplémentaire ni scraper externe n'est requis. Fonctionnement : les abonnements sont définis dans des fichiers YAML. Chaque abonnement importe des presets qui décrivent comment les fichiers multimédias doivent être traités et générés. Le projet fournit de nombreux presets prédéfinis afin que les utilisateurs puissent commencer à télécharger sans créer une configuration de zéro. Une seule commande, `ytdl-sub sub subscriptions.yaml`, traite le fichier. Les cas d'usage typiques présentés dans le README incluent le traitement des chaînes YouTube comme des séries TV, l'organisation des clips musicaux et des concerts, ainsi que la gestion des discographies SoundCloud ou Bandcamp. Le README indique que le traitement SoundCloud écrit les tags musicaux via l'API beets. La sortie est organisée dans des répertoires tels que tv_shows, music et music_videos, avec des vignettes générées, des fichiers de métadonnées .nfo, des posters et des fanarts adaptés aux serveurs multimédias. La configuration est flexible : des remplacements globaux peuvent être définis dans une section `__preset__`, et des options peuvent être transmises directement à l'API Python de yt-dlp, par exemple un fichier de cookies. Les presets peuvent définir des tags de genre, des classifications de contenu, et utiliser un preset « Only Recent » pour limiter les téléchargements par plage de dates et nombre de fichiers. Les configurations personnalisées sont prises en charge, avec un guide pas à pas et des exemples de configuration liés depuis le README. Les options d'installation listées incluent Docker Compose (Web-GUI, headless, passthrough CPU/GPU), Docker CLI, Windows, Unraid, Linux, Linux ARM, PIP, installation locale et build Docker local. L'image Docker Web-GUI est décrite comme combinant l'image code-server de LinuxServer.io avec ytdl-sub préinstallé, et est recommandée par le README. Le support communautaire est disponible via un canal Discord, les GitHub Issues pour les demandes de fonctionnalités et les rapports de bugs, ainsi qu'une FAQ dans la documentation. Le README renvoie également à readthedocs pour des informations détaillées sur tous les champs de configuration.