| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| yt-dlp [Le 18/10/2025, 19:47] – [Installation] liens krodelabestiole | yt-dlp [Le 20/04/2026, 07:34] (Version actuelle) – [Récupérer la liste des flux disponibles pour une vidéo] +description multi (+) krodelabestiole |
|---|
| {{tag>console multimédia capture}} | {{tag>console multimédia audio vidéo capture internet encodage streaming}} |
| |
| ====== yt-dlp, capture de vidéo internet en ligne de commande ====== | {{ :icons:yt-dlp.png?120|Icône yt-dlp}} |
| | ====== yt-dlp ====== |
| |
| **[[https://github.com/yt-dlp/yt-dlp|yt-dlp]]** est un utilitaire en [[:commande shell|ligne de commande]] de téléchargement vidéo et audio en ligne qui supporte [[https://www.youtube.com|YouTube]], [[https://www.arte.tv/fr/|arte.tv]], [[https://www.france.tv/|France TV]], [[https://www.twitch.tv/|Twitch]] et littéralement [[https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md|des milliers]] d'autres plate-formes. | **[[https://github.com/yt-dlp/yt-dlp|yt-dlp]]** est un utilitaire en [[:commande shell|ligne de commande]] de téléchargement multimédia. |
| |
| **yt-dlp** est un fork de **[[:youtube-dl]]** basé sur le projet **youtube-dlc** désormais inactif. L'objectif principal de ce projet est d'apporter des correctifs tout en restant à jour avec le projet original, et d'ajouter de nouvelles fonctionnalités : extractions de sous-titres, //remuxing// et ré-encodage à la volée, etc. | Il permet de sauvegarder des flux Internet vidéo, audio, ou des sous-titres sur un stockage local pour les consulter hors-ligne, mais aussi de les manipuler, les [[wpfr>transcodage|transcoder]] ou les //remuxer// à la volée. Il supporte [[https://www.youtube.com|YouTube]], [[https://www.arte.tv/fr/|arte.tv]], [[https://www.france.tv/|France TV]], [[https://www.twitch.tv/|Twitch]] et littéralement [[https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md|des milliers]] d'autres services en ligne ! |
| | |
| | **yt-dlp** est un fork de **[[:youtube-dl]]** basé sur le projet **youtube-dlc** désormais inactif. L'objectif principal de ce projet est d'ajouter de nouvelles fonctionnalités et des correctifs tout en restant à jour avec le projet original. |
| |
| <note> | <note> |
| </note> | </note> |
| |
| ===== Interfaces graphiques ===== | Bien que **[[https://github.com/yt-dlp/yt-dlp|yt-dlp]]** s'utilise nativement depuis un [[:terminal]], son fonctionnement basique est à la portée d'un débutant. |
| | |
| | Il existe cependant des interfaces graphiques (aussi appelées //[[wpfr>Interface_graphique|GUI]]// pour //Graphical User Interface//) permettant d'utiliser **yt-dlp** facilement, sans passer par un [[:terminal]] : |
| |
| Il existe des interfaces graphiques permettant d'utiliser **yt-dlp** facilement, sans passer par un [[:terminal]] : | ==== Interfaces graphiques ==== |
| |
| * **[[https://github.com/Unrud/video-downloader|Téléchargeur de vidéos]]** (**Video Downloader**) est disponible en [[:flatpak]] sur [[https://flathub.org/fr/apps/com.github.unrud.VideoDownloader|Flathub]], en [[:snap]] sur [[https://snapcraft.io/video-downloader|snapcraft]], et dans les dépôts [[:APT]] ([[:tutoriel:comment_installer_un_paquet|paquet]] ''[[apt>video-downloader]]''). | * **[[https://github.com/Unrud/video-downloader|Téléchargeur de vidéos]]** (**Video Downloader**) est disponible en [[:flatpak]] sur [[https://flathub.org/fr/apps/com.github.unrud.VideoDownloader|Flathub]], en [[:snap]] sur [[https://snapcraft.io/video-downloader|snapcraft]], et dans les dépôts [[:APT]] ([[:deb#installer_un_paquet_deb|paquet]] ''[[apt>video-downloader]]'') :\\ {{https://raw.githubusercontent.com/Unrud/video-downloader/master/screenshots/1.png?650}} |
| * **[[https://nickvision.org/parabolic.html|Parabolic]]** (**tube-converter**) est disponible en [[:flatpak]] sur [[https://flathub.org/fr/apps/org.nickvision.tubeconverter|Flathub]] et en [[:snap]] sur [[https://snapcraft.io/tube-converter|snapcraft]]. | * **[[https://nickvision.org/parabolic.html|Parabolic]]** (**tube-converter**) est disponible en [[:flatpak]] sur [[https://flathub.org/fr/apps/org.nickvision.tubeconverter|Flathub]] et en [[:snap]] sur [[https://snapcraft.io/tube-converter|snapcraft]]. |
| * **[[https://jely2002.github.io/youtube-dl-gui/|Open Video Downloader]]** (**youtube-dl-gui**) est disponible en [[:Appimage]] sur [[https://github.com/jely2002/youtube-dl-gui/releases/latest|GitHub]]. | * **[[https://jely2002.github.io/youtube-dl-gui/|Open Video Downloader]]** (**youtube-dl-gui**) est disponible en [[:Appimage]] sur [[https://github.com/jely2002/youtube-dl-gui/releases/latest|GitHub]]. |
| * **[[https://github.com/onionware-github/OnionMedia-X/|OnionMedia X]]** est disponible en [[:flatpak]] sur [[https://flathub.org/fr/apps/io.github.onionware_github.onionmedia|Flathub]]. | * **[[https://github.com/onionware-github/OnionMedia-X/|OnionMedia X]]** est disponible en [[:flatpak]] sur [[https://flathub.org/fr/apps/io.github.onionware_github.onionmedia|Flathub]]. |
| * **[[https://github.com/JaGoLi/ytdl-gui|youtubedl-gui]]** est disponible en [[:flatpak]] sur [[https://flathub.org/fr/apps/io.github.JaGoLi.ytdl_gui|Flathub]], dans les dépôts [[:APT]]. | |
| * **[[https://mediaharbor.github.io/|MediaHarbor]]** est disponible en [[:snap]] sur [[https://snapcraft.io/mediaharbor|snapcraft]], ou en [[:Appimage]] et en [[:deb]] isolé sur [[https://github.com/MediaHarbor/mediaharbor/releases/latest|GitHub]]. | * **[[https://mediaharbor.github.io/|MediaHarbor]]** est disponible en [[:snap]] sur [[https://snapcraft.io/mediaharbor|snapcraft]], ou en [[:Appimage]] et en [[:deb]] isolé sur [[https://github.com/MediaHarbor/mediaharbor/releases/latest|GitHub]]. |
| |
| ===== Outil en ligne de commande ===== | <note> |
| | Certaines de ces interfaces, en particulier celles distribuées hors [[:snap]] et [[:Flatpak]] (donc surtout les [[:deb]]), ont besoin de l'[[#outil en ligne de commande]] installé en complément (//a priori// automatiquement, en dépendance). |
| | </note> |
| |
| Bien que **[[https://github.com/yt-dlp/yt-dlp|yt-dlp]]** s'utilise nativement depuis un [[:terminal]], son fonctionnement basique est à la portée d'un débutant. | ===== Installation ===== |
| |
| ==== Installation ==== | Il existe de nombreuses méthodes, //au choix//, pour installer **yt-dlp** sur Ubuntu : |
| |
| === APT === | <note important> |
| | La version proposée par les [[:depots#dépôts officiels]] [[:APT]] d'Ubuntu n'est jamais la plus récente, ce qui peut empêcher le programme de fonctionner avec des services qui évoluent rapidement.\\ |
| | De plus la fonctionnalité d'[[#mise_a_jour|auto-mise à jour]] ''[[#mise_a_jour|--update]]'' (ou ''-U'' en court) a été supprimée de cette version. |
| |
| **yt-dlp** est disponible dans les [[:depots#dépôts officiels]] [[:APT]] d'Ubuntu depuis la version [[:jammy|jammy 22.04]] (sur la version LTS précédente [[:focal|focal 20.04]] il est disponible dans les dépôts [[:depots#backports]]). | Dans ces conditions il est sans doute préférable de s'orienter vers une installation manuelle du [[#binaire isolé]] (ou d'utiliser [[#Docker]] si celui-ci est déjà installé). Ce sont ces méthodes qui permettent de profiter de la version la plus récente de l'application, et de la [[#mise_a_jour|maintenir à jour]] très facilement. |
| | </note> |
| |
| Pour obtenir cette application il suffit donc d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] ''[[apt>yt-dlp]]''. | ==== APT ==== |
| |
| <note important>La version dans les dépôts par défaut n'est pas toujours la plus récente, ce qui peut empêcher le programme de fonctionner.</note> | **yt-dlp** est disponible dans les [[:depots#dépôts officiels]] [[:APT]] d'Ubuntu depuis la version [[:jammy|jammy 22.04]] (sur la version LTS précédente [[:focal|focal 20.04]] il est disponible dans les dépôts [[:depots#backports]]). |
| |
| === Snap === | Pour obtenir cette application il suffit donc d'[[:deb#installer_un_paquet_deb|installer le paquet]] ''[[apt>yt-dlp]]''. |
| |
| **yt-dlp** est également disponible en [[:snap]] sur [[:snap]] depuis [[https://snapcraft.io/yt-dlp|Snapcraft]]. Cette distribution n'est cependant pas officielle. | ==== Snap ==== |
| | |
| | **yt-dlp** est également disponible en [[:snap]] depuis [[https://snapcraft.io/yt-dlp|Snapcraft]]. Cette distribution n'est cependant pas officielle. |
| |
| On peut donc l'installer sur Ubuntu simplement en installant ''yt-dlp'' depuis le [[:snap store|centre d'applications (Snap Store)]], ou en installant le paquet ''yt-dlp'' en ligne de commande : | On peut donc l'installer sur Ubuntu simplement en installant ''yt-dlp'' depuis le [[:snap store|centre d'applications (Snap Store)]], ou en installant le paquet ''yt-dlp'' en ligne de commande : |
| <code>snap install yt-dlp</code> | <code>snap install yt-dlp</code> |
| |
| === pip === | ==== pip ==== |
| |
| **yt-dlp** est aussi disponible dans les dépôts du gestionnaire **[[:python#les_modules|pip]]**. | **yt-dlp** est aussi disponible dans les dépôts du gestionnaire **[[:python#les_modules|pip]]**. |
| <code>python3 -m pip install -U yt-dlp</code> | <code>python3 -m pip install -U yt-dlp</code> |
| |
| === PPA === | ==== PPA ==== |
| |
| Une version éventuellement plus récente que celle des [[:depots#dépôts officiels]] est distribuée sur un [[:PPA]]. Cette distribution n'est cependant pas officielle et pas recommandée. | Une version éventuellement plus récente que celle des [[:depots#dépôts officiels]] est distribuée sur un [[:PPA]]. Cette distribution n'est cependant pas officielle et pas recommandée. |
| - [[:ppa#ajout_d_un_ppa_a_vos_sources_logicielles|Ajoutez le PPA]] ''ppa:tomtomtom/yt-dlp''((https://launchpad.net/~tomtomtom/+archive/ubuntu/yt-dlp)) dans vos sources de logiciels. | - [[:ppa#ajout_d_un_ppa_a_vos_sources_logicielles|Ajoutez le PPA]] ''ppa:tomtomtom/yt-dlp''((https://launchpad.net/~tomtomtom/+archive/ubuntu/yt-dlp)) dans vos sources de logiciels. |
| - [[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|Rechargez la liste des paquets]]. | - [[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|Rechargez la liste des paquets]]. |
| - [[:tutoriel:comment_installer_un_paquet|Installez ensuite le paquet]] ''[[apt>yt-dlp]]''. | - [[:deb#installer_un_paquet_deb|Installez ensuite le paquet]] ''[[apt>yt-dlp]]''. |
| |
| === Git === | ==== Binaire isolé ==== |
| | |
| On peut installer **yt-dlp** simplement en copiant le binaire exécutable depuis [[:Git]], en suivant cette procédure dans un [[:terminal]] : | <note tip>C'est la méthode généralement recommandée pour cette application en particulier.</note> |
| - Installer [[:Git]] :<code>sudo apt install git</code> | |
| | On peut installer **yt-dlp** en copiant le binaire exécutable depuis [[https://github.com/yt-dlp/yt-dlp/releases/latest|GitHub]] dans son répertoire des [[:arborescence#binaires personnels]], en suivant cette procédure depuis un [[:terminal]] : |
| - Télécharger le binaire :<code>wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O ~/.local/bin/yt-dlp</code> | - Télécharger le binaire :<code>wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O ~/.local/bin/yt-dlp</code> |
| - Le rendre exécutable :<code>chmod a+rx ~/.local/bin/yt-dlp</code> | - Le [[:permissions|rendre exécutable]] :<code>chmod +x ~/.local/bin/yt-dlp</code> |
| |
| La [[:commande shell|commande]] ''[[man>yt-dlp]]'' sera à présent disponible, mais les mises à jour devront être effectuées manuellement. | La [[:commande shell|commande]] ''[[man>yt-dlp]]'' sera à présent disponible, et on peut la [[#mise à jour|mettre à jour]] simplement avec ''yt-dlp -U''. |
| |
| === Docker === | ==== Docker ==== |
| |
| Il est aussi possible d'utiliser **yt-dlp** sans même l'installer grâce à **[[:Docker]]**. | Il est aussi possible d'utiliser **yt-dlp** sans même l'installer grâce à **[[:Docker]]**. |
| |
| - [[:docker#installation|Installez Docker]] (ou [[https://podman.io/|Podman]]). | - [[:docker#installation|Installer Docker]] (ou [[https://podman.io/|Podman]]). |
| - Créez ensuite un [[:alias]] en [[:tutoriel:comment_sauver_et_restaurer_un_fichier|ajoutant cette ligne]] au fichier ''~/.bash_aliases'' :<file bash .bash_aliases>alias yt-dlp='docker run --rm -it -v $PWD:/downloads jauderho/yt-dlp:latest'</file> | - Créer ensuite un [[:alias]] en [[:tutoriel:comment_sauver_et_restaurer_un_fichier|ajoutant cette ligne]] au fichier ''~/.bash_aliases'' :<file bash .bash_aliases>alias yt-dlp='docker run --rm -it -v $PWD:/downloads jauderho/yt-dlp:latest'</file> |
| - Relancez votre [[:terminal]]. | - Relancer le [[:terminal]]. |
| |
| Le programme sera téléchargé lors de la première exécution de la commande ''[[man>yt-dlp]]'', et beaucoup plus rapide ensuite. | Le programme sera téléchargé lors de la première exécution de la commande ''[[man>yt-dlp]]'', et beaucoup plus rapide ensuite. |
| |
| ==== Configuration ==== | ===== Mise à jour ===== |
| | |
| | **yt-dlp** peut se mettre lui-même à jour grâce à la commande : |
| | <code>yt-dlp -U</code> |
| | En fonction de la méthode d'installation, il peut être nécessaire d'utiliser ''[[:sudo]]''. |
| | |
| | ===== Configuration ===== |
| |
| On passe généralement les paramètres nécessaires directement à la [[:commande shell|commande]] ''[[man>yt-dlp]]'', mais pour se simplifier ces lignes il peut être utile de configurer **yt-dlp** de manière permanente. Ceci se fait en éditant un fichier ''yt-dlp.conf''. | On passe généralement les paramètres nécessaires directement à la [[:commande shell|commande]] ''[[man>yt-dlp]]'', mais pour se simplifier ces lignes il peut être utile de configurer **yt-dlp** de manière permanente. Ceci se fait en éditant un fichier ''yt-dlp.conf''. |
| À ce sujet voir **(//en//)** //[[https://github.com/yt-dlp/yt-dlp/blob/master/README.md#configuration|Configuration yt-dlp]]// sur GitHub. | À ce sujet voir **(//en//)** //[[https://github.com/yt-dlp/yt-dlp/blob/master/README.md#configuration|Configuration yt-dlp]]// sur GitHub. |
| |
| ==== Utilisation ==== | ===== Utilisation ===== |
| |
| === Télécharger une vidéo === | ==== Télécharger une vidéo ==== |
| |
| Lancez l'application ou via le [[:terminal]] (toutes [[:versions]] ou [[:variantes]] d'Ubuntu) avec la [[:commande_shell|commande]] avec comme argument l'[[:web#URL]] de la vidéo que vous souhaitez télécharger : <code>yt-dlp [OPTIONS] URL</code> | Lancer l'application ou via le [[:terminal]] (toutes [[:versions]] ou [[:variantes]] d'Ubuntu) avec la [[:commande_shell|commande]] : |
| | yt-dlp OPTIONS URL |
| | en remplaçant : |
| | * ''OPTIONS'' par les éventuelles options (voir ci-dessous) |
| | * et l'argument ''%%URL%%'' par l'[[:web#URL]] de la page web de la vidéo que vous souhaitez télécharger. |
| |
| <note tip>Vous pouvez aussi utiliser l'identifiant numérique (//ID//) de la vidéo YouTube au lieu de son [[:web#URL]]</note> | <note tip> |
| | On peut aussi utiliser l'identifiant numérique (//ID//) de la vidéo YouTube au lieu de son [[:web#URL]] complète. |
| | </note> |
| |
| La vidéo sera téléchargée et sera lisible par votre [[:lecture_et_encodage_de_fichiers_videos#lecture_de_fichier_video|lecteur de vidéo]] pré-installé dans votre variante d'Ubuntu. | La vidéo sera téléchargée dans le répertoire d'où a été entrée la commande (par défaut le [[:arborescence #répertoire personnel]] ''[[:arborescence #répertoire personnel|/home/$USER]]'') et sera lisible par tous les [[:lecture_et_encodage_de_fichiers_videos#lecture_de_fichier_video|lecteurs vidéo]]. |
| |
| === Récupérer la liste des flux disponibles pour une vidéo === | ==== Récupérer la liste des flux disponibles pour une vidéo ==== |
| |
| Quand plusieurs qualités de flux vidéo (et / ou audio) sont disponibles, **yt-dlp** télécharge //a priori// le meilleur par défaut, mais on peut en préférer un autre, ou une autre langue par exemple. | Quand plusieurs qualités de flux vidéo (et / ou audio) sont disponibles, **yt-dlp** télécharge //a priori// le meilleur de chaque (vidéo + audio) par défaut, mais on peut en préférer d'autres, ou une autre langue par exemple. |
| |
| L'option ''-F'' permet d'afficher (sans les télécharger) la liste des flux disponibles : | L'option ''-F'' permet d'afficher (sans les télécharger) la liste des flux disponibles : |
| C'est ensuite l'option ''-f'' qui permet de lancer le téléchargement de son choix : | C'est ensuite l'option ''-f'' qui permet de lancer le téléchargement de son choix : |
| <code>yt-dlp -f format URL</code> | <code>yt-dlp -f format URL</code> |
| En remplaçant ''format'' par le contenu de la colonne ''ID'' du retour de la commande précédente. | En remplaçant ''format'' par le contenu de la colonne ''ID'' du retour de la commande précédente.\\ |
| | Il peut s'agir : |
| | * d'un flux vidéo (dans ce cas le "meilleur" flux audio est aussi toujours téléchargé) |
| | * ou à l'inverse, d'un flux audio (on garde la vidéo par défaut) |
| | * ou d'une sélection de plusieurs flux audio ou vidéo séparés par le caractère ''+'' (sans espace) :<code>yt-dlp -f piste_vidéo+piste_audio URL</code> |
| |
| === Télécharger l'audio d'une vidéo === | <note tip> |
| | De la sorte on peut aussi télécharger plusieurs flux audio (avec plusieurs ''+//piste_audio//'' juxtaposés) pour créer un fichier vidéo multilingue. |
| | </note> |
| | |
| | ==== Télécharger l'audio d'une vidéo ==== |
| |
| Utiliser l'option ''-x'' pour ne garder que la partie audio d'une vidéo. (l'option ''x'' signifie extraction) | Utiliser l'option ''-x'' pour ne garder que la partie audio d'une vidéo (''x'' signifie //extraction//). |
| exemple : <code>yt-dlp -x -f bestaudio URL</code> | exemple : <code>yt-dlp -x -f bestaudio URL</code> |
| | Vous pouvez enlever l'option ''-f bestaudio'' s'il n'y a qu'un seul flux audio disponible. |
| |
| Vous pouvez enlever l'option ''bestaudio'' s'il n'y a aucun flux audio seul possible. Dans ce cas, **yt-dlp** va télécharger la vidéo puis en extraire l'audio. | **yt-dlp** va télécharger la vidéo puis en extraire l'audio. |
| |
| L'extraction de l'audio d'une vidéo requiert [[:ffmpeg]]. | L'extraction de l'audio d'une vidéo requiert [[:ffmpeg]]. |
| === Obtenir les informations sur l'audio et télécharger la miniature === | === Obtenir les informations sur l'audio et télécharger la miniature === |
| |
| Pour obtenir la pochette de l'album et les informations concernant le fichier audio, utiliser cette commande | Pour obtenir les informations concernant le fichier audio (''%%--add-metadata%%'') et la pochette de l'album (''%%--embed-thumbnail%%''), utiliser cette commande : |
| <code>yt-dlp -x -f bestaudio[ext=m4a] --add-metadata --embed-thumbnail URL</code> | <code>yt-dlp -x -f bestaudio[ext=m4a] --add-metadata --embed-thumbnail URL</code> |
| |
| === Sous-titres des vidéos === | ==== Sous-titres des vidéos ==== |
| |
| <note>Les sous-titres dépendent de leur disponibilité. Certaines vidéos en sont dépourvues. Si tel est le cas, la dernière phrase écrite au terminal sera ''<URL> has no subtitles''</note> | Les options ''%%--write-subs%%'', ''%%--write-auto-subs%%'', ou ''%%--embed-subs%%'' permettent de récupérer les sous-titres. |
| |
| == Lister les langues possibles == | <note tip>On peut aussi utiliser l'option ''%%--skip-download%%'' pour télécharger uniquement les sous-titres.</note> |
| | |
| | === Lister les langues disponibles === |
| |
| <code>yt-dlp --list-subs URL</code> | <code>yt-dlp --list-subs URL</code> |
| |
| == Télécharger en définissant la langue == | <note> |
| | Si la vidéo est dépourvue de sous-titres (ou que ceux-ci sont incrustés dans l'image vidéo), la dernière ligne du retour sera ''//URL// has no subtitles''. |
| | </note> |
| | |
| | === Télécharger en définissant la langue === |
| |
| <code>yt-dlp --write-sub --sub-lang LANG URL</code> | <code>yt-dlp --write-sub --sub-lang LANG URL</code> |
| |
| == Télécharger en utilisant les sous-titres générés automatiquement == | === Télécharger en utilisant les sous-titres générés automatiquement === |
| |
| <code>yt-dlp --write-auto-sub --sub-lang LANG URL</code> | <code>yt-dlp --write-auto-sub --sub-lang LANG URL</code> |
| |
| <note>Utiliser l'option ''%%--skip-download%%'' pour télécharger uniquement les sous-titres</note> | === Télécharger et choisir le format des flux, en même temps que les sous-titres === |
| |
| == Télécharger et choisir le format de flux, en même temps que les sous-titres == | <code>yt-dlp -f video+audio --write-subs --sub-langs LANG URL</code> |
| | En remplaçant ''video'' et ''audio'' par les correspondances de la colonne ''ID'' retournée précédemment (par ''yt-dlp -F //URL//''). |
| |
| <code>yt-dlp -f format --write-subs --sub-langs LANG URL</code> | ==== Exemple complet multilingue ==== |
| |
| Ou, dans le cas d'une vidéo et audio double-flux (vidéo et audio séparés), type arte.tv : | **yt-dlp** inclut des fonctionnalités variées et puissantes de conversion multimédia (sans réencoder pour ne pas perdre en qualité) et d'encapsulation (//muxing//) au format de son choix (sauf matériel vidéo ancien, le format [[:matroska|MKV]] est généralement l'idéal). Avec les bonnes options il n'est presque jamais nécessaire de recourir à [[:FFmpeg]] ou au moindre outil de {{tagpage>encodage|ré-encodage}}. |
| |
| <code>yt-dlp -f video-only+audio-only --write-subs --sub-langs LANG URL</code> | Il est par exemple possible de télécharger plusieurs flux audio (ici V.O. et V.F.), de convertir des sous-titres (ici de [[wpfr>WebVTT|VTT]] vers [[wpfr>SubRip|SRT]]), et d'encapsuler le tout à la volée dans un conteneur [[:matroska|MKV]].\\ |
| | Ici pour **arte.tv** : |
| | <code>yt-dlp --embed-metadata --embed-subs --merge-output-format mkv --sub-format vtt --convert-subs srt --sub-langs fr --audio-multistreams -f bestvideo+VF-STF-audio_0-anglais__VO_+VF-STF-audio_0-français https://www.arte.tv/fr/videos/XXXXXX-000-A/xxxxxx/</code> |
| | * ''%%--embed-metadata%%'' permet de récupérer les métadonnées depuis la source (ici le site **arte.tv**), afin que les lecteurs indiquent les langues des pistes audio et des sous-titres, par exemple. |
| | * ''%%--embed-subs%%'' inclut les sous-titres au fichier (ce que permet [[:matroska|MKV]]), ce qui évite d'avoir à créer un fichier indépendant pour les sous-titres avec ''%%--write-subs%%''. |
| | * ''%%--merge-output-format mkv%%'' pour encapsuler tous les flux audio et vidéo (avec les sous-titres, donc) dans un fichier [[:matroska|MKV]]. |
| | * ''%%--sub-format vtt%%'' indique le format source des sous-titres ([[wpfr>WebVTT|VTT]] pour **arte.tv**). |
| | * ''%%--convert-subs srt%%'' convertit les sous-titres dans un format plus habituels pour les [[:lecture_et_encodage_de_fichiers_videos#lecture_de_fichier_video|lecteurs vidéo]] : [[wpfr>SubRip|SRT]]. |
| | * ''%%--sub-langs fr%%'' : on télécharge les sous-titres en langue française. |
| | * ''%%--%%audio-multistreams -f //bestvideo//**+**//VF-STF-audio_0-anglais%%__%%VO_//**+**//VF-STF-audio_0-français//'' indique qu'on souhaite télécharger une piste vidéo et (''**+**'') deux pistes audio : |
| | * la meilleure qualité pour la piste vidéo (''//bestvideo//'') |
| | * ''+'' l'audio version originale (''//VF-STF-audio_0-anglais__VO_//'') |
| | * ''+'' la version française (''//VF-STF-audio_0-français//'')\\ (on a obtenu les noms de ces pistes [[#Récupérer la liste des flux disponibles pour une vidéo|précédemment]], grâce à la commande ''yt-dlp -F //URL//''). |
| | * et pour finir l'[[:web#URL]] de la page présentant cette vidéo sur le site **arte.tv** (ici un exemple ''%%https://www.arte.tv%%/fr/videos%%/%%//XXXXXX-000-A//%%/%%//xxxxxx//%%/%%'' qui n'existe pas). |
| |
| En remplaçant ''video-only'' et ''audio-only'' par les contenus de la colonne ''ID'' vu plus haut | ===== Problèmes courants ===== |
| |
| ==== Erreur "nom trop long" ==== | ==== Erreur "nom trop long" ==== |
| Si vous recevez ce message d'erreur : | Si vous recevez ce message d'erreur : |
| <code>ERROR: unable to open for writing: [Errno 36] File name too long:</code> | <code>ERROR: unable to open for writing: [Errno 36] File name too long:</code> |
| ajouter l'option ''-o'' suivie du nom de renommage... | ajouter l'option ''-o'' suivie d'un nom de fichier (plus court que l'original). |
| |
| Exemple : <code>yt-dlp -o monfichierrenommé.mp4 URL</code> | Exemple : |
| | <code>yt-dlp -o monfichierrenommé.mp4 URL</code> |
| |
| ==== Désinstallation ==== | ===== Désinstallation ===== |
| | |
| Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés. | Pour supprimer cette application, il suffit de [[:deb#desinstaller_un_paquet_deb|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les fichiers de préférence des utilisateurs dans leurs répertoires personnels sont toujours conservés. |
| * Pour la version des **dépôts Ubuntu**, vous pouvez passer par le [[:snap store|centre d'applications]], ou en ligne de commande :<code>sudo apt remove yt-dlp</code> | * Pour la version des **[[:deb#desinstaller_un_paquet_deb|dépôts Ubuntu]]**, vous pouvez passer par le [[:snap store|centre d'applications]], ou en ligne de commande :<code>sudo apt remove yt-dlp</code> |
| * Pour la version **[[:snap#suppression|snap]]**, vous pouvez passer par le [[:snap store|centre d'applications]], ou en ligne de commande :<code>snap remove yt-dlp</code> | * Pour la version **[[:snap#suppression|snap]]**, vous pouvez passer par le [[:snap store|centre d'applications]], ou en ligne de commande :<code>snap remove yt-dlp</code> |
| * Pour le binaire isolé, il suffit de supprimer le fichier :<code>rm ~/.local/bin/yt-dlp</code> | * Pour le binaire isolé, il suffit de supprimer le fichier :<code>rm ~/.local/bin/yt-dlp</code> |
| ===== Voir aussi ===== | ===== Voir aussi ===== |
| | |
| * **(en)** [[https://github.com/yt-dlp/yt-dlp|Site officiel du logiciel]] | * **(//en//)** [[https://github.com/yt-dlp/yt-dlp|Site officiel]] (GitHub) |
| |
| ---- | ---- |
| //Contributeurs : [[:utilisateurs:Amiralgaby]], [[:utilisateurs:krodelabestiole]], [[:utilisateurs:piero]]// | //[[:Contributeurs]] : [[:utilisateurs:Amiralgaby]], [[:utilisateurs:krodelabestiole]], [[:utilisateurs:piero]].// |