ytdl-sub

Automatisez le téléchargement et la génération de métadonnées avec YoutubeDL.

ytdl-sub est un outil de ligne de commande qui télécharge des médias via yt-dlp et les prépare pour votre lecteur multimédia préféré, notamment Kodi, Jellyfin, Plex, Emby et les lecteurs de musique modernes. Aucun plugin supplémentaire ou grattoir externe n'est nécessaire.

Nous reconnaissons que chacun stocke ses médias différemment. Notre approche en matière de formatage des fichiers et des métadonnées consiste à offrir une flexibilité maximale tout en conservant la simplicité.

Chaînes YouTube en tant qu'émissions de télévision

Plex

Gelée

Vidéoclips et concerts

Kodi

Gelée

Discographie SoundCloud

Écrit des balises musicales appropriées via l'API betteraves

Discographie du camp de bande

Comment ça marche

ytdl-sub utilise des fichiers YAML pour définir les abonnements. Chaque abonnement importe des préréglages qui définissent comment gérer et produire des fichiers multimédias. ytdl-sub est livré avec de nombreux préréglages prédéfinis qui effectuent le travail de création de configuration, vous pouvez donc commencer le téléchargement immédiatement.

 # souscriptions.yaml:# Tout ici peut être téléchargé à l'aide de la commande :# ytdl-sub sub souscriptions.yaml# __preset__ est un endroit pour définir des remplacements globaux pour tous les abonnements__preset__ : remplacements : # Dossier racine de toutes les émissions de télévision ytdl-sub tv_show_directory : "/émissions_tv"
        # Dossier racine de tous les répertoires musicaux ytdl-sub Music : "/music"
        # Dossier racine de tous les clips vidéo ytdl-sub music_video_directory : "/music_videos"
        # Pour le préréglage 'Seulement récent', conservez uniquement les vidéos dans cette plage et limitez only_recent_date_range : "2months" only_recent_max_files : 30
      # Transmettez n'importe quel argument directement à l'API Python de yt-dlp ytdl_options : cookiefile : "/config/cookie.txt" ########################### ######################################### Préréglages d'émissions de télévision. Peut remplacer Plex par Plex/Jellyfin/KodiPlex TV Show par date : # Définit la balise de genre sur "Documentaires" = Documentaires : "NOVA PBS": "https://www.youtube.com/@novapbs" "National Geographic": " https://www.youtube.com/@NatGeo" "Cosmos - What If": "https://www.youtube.com/playlist?list=PLZdXRHYAVxTJno6oFF9nLGuwXNGYHmE8U" # Définit la balise de genre sur "Kids", "TV-Y " pour l'évaluation du contenu = Enfants | = TV-Y : "Jake Trains": "https://www.youtube.com/@JakeTrains" "Kids Toys Play": "https://www.youtube.com/@KidsToysPlayChannel" = Musique : # émission de télévision les abonnements peuvent prendre en charge plusieurs URL et être stockés dans la même émission télévisée « Rick Beato » :
      - "https://www.youtube.com/@RickBeato"
      - "https://www.youtube.com/@rickbeato240" # Définissez la balise de genre sur "Actualités", utilisez le préréglage "Seulement récent" pour stocker uniquement les vidéos téléchargées récemment = Actualités | Uniquement récent : "BBC News": "https://www.youtube.com/@BBCNews"Plex TV Show Collection : = Musique : # Préfixe avec ~ pour définir des variables de remplacement spécifiques "~Au-delà de la guitare" : s01_name : "Vidéos " s01_url : "https://www.youtube.com/c/BeyondTheGuitar" s02_name : "Couvertures" s02_url : "https://www.youtube.com/playlist?list=PLE62gWlWZk5NWVAVuf0Lm9jdv_-_KXs0W"###### ################################################# ############ Préréglages musicaux. Peut remplacer Plex par Plex/Jellyfin/KodiYouTube Releases : = Jazz : # Définit la balise de genre sur "Jazz" "Thelonious Monk": "https://www.youtube.com/@theloniousmonk3870/releases"YouTube Full Albums : = Lofi : "Game Chops": "https://www.youtube.com/playlist?list=PLBsm_SagFMmdWnCnrNtLjA9kzfrRkto4i" Discographie SoundCloud : = Chill Hop : "UKNOWY": "https://soundcloud.com/uknowymunich" = Synthwave : "Lazerdiscs Records ": "https://soundcloud.com/lazerdiscsrecords" "Earmake": "https://soundcloud.com/earmake"Bandcamp : = Lofi : "Emily Hopkins": "https://emilyharpist.bandcamp.com/" ################################################# ################## Préréglages de vidéoclips "Plex Music Videos": = Pop : # Définit la balise de genre sur "Pop" "Rick Astley": "https://www. youtube.com/playlist?list=PLlaN88a7y2_plecYoJxvRFTLHVbIVAOoc" "Michael Jackson" : "https://www.youtube.com/playlist?list=OLAK5uy_mnY03zP6abNWH929q2XhGzWD_2uKJ_n8E"

Tout cela peut être téléchargé et prêt à être importé sur votre lecteur préféré en utilisant la commande

ytdl-sub sub subscriptions.yaml

Consultez nos exemples d’abonnements pour des exemples et des cas d’utilisation plus détaillés.

Sortir

Après l'exécution ytdl-sub , le résultat final téléchargera et formatera les fichiers en quelque chose prêt à être consommé par votre lecteur/serveur multimédia préféré.

tv_shows/
  Jake Trains/
    Season 2021/
      s2021.e031701 - Pattys Day Video-thumb.jpg
      s2021.e031701 - Pattys Day Video.mp4
      s2021.e031701 - Pattys Day Video.nfo
      s2021.e031702 - Second Pattys Day Video-thumb.jpg
      s2021.e031702 - Second Pattys Day Video.mp4
      s2021.e031702 - Second Pattys Day Video.nfo
    Season 2022/
      s2022.e122501 - Merry Christmas-thumb.jpg
      s2022.e122501 - Merry Christmas.mp4
      s2022.e122501 - Merry Christmas.nfo
    poster.jpg
    fanart.jpg
    tvshow.nfo

music/
  Artist/
    [2022] Some Single/
      01 - Some Single.mp3
      folder.jpg
    [2023] Latest Album/
      01 - Track Title.mp3
      02 - Another Track.mp3
      folder.jpg

music_videos/
  Elton John/
    Elton John - Rocketman.jpg
    Elton John - Rocketman.mp4

Configurations personnalisées

Toute partie de ce processus est modifiable à l'aide de configurations personnalisées. Consultez notre guide pas à pas pour savoir comment créer votre première configuration à partir de zéro. Des exemples de configurations prêts à l'emploi peuvent être trouvés ici à côté de nos documents de lecture pour des informations détaillées sur tous les champs de configuration.

Installation

ytdl-sub peut être installé sur les plateformes suivantes.

Docker Composer

Interface graphique Web
Sans tête
Passage CPU/GPU

CLI Docker
Fenêtres
Sans raid
Linux
BRAS Linux
PÉPIN
Installation locale
Construction de Docker local

Installation du menu Docker

Les installations Docker peuvent être soit sans tête, soit utiliser l'image Web-GUI, qui comprend l'image Docker du serveur de code de LSIO avec ytdl-sub préinstallé. C'est la manière recommandée d'utiliser ytdl-sub .

Contribuer

Il existe de nombreuses façons de contribuer, même sans codage. Veuillez jeter un œil à nos problèmes GitHub pour soumettre une demande de fonctionnalité ou détecter un bug.