{{tag>console multimédia capture}}
====== yt-dlp, capture de vidéo internet en ligne de commande ======
**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.
**yt-dlp** est un utilitaire de capture de vidéos en ligne qui supporte [[https://www.youtube.com|YouTube]] mais aussi de nombreuses autres plate-formes.
La copie d’œuvre protégée est réglementée, pour la France, voir [[http://www.legifrance.gouv.fr/affichCodeArticle.do?idArticle=LEGIARTI000025003518&cidTexte=LEGITEXT000006069414|l'article L122-5 sur Légifrance]]. La SACEM indique que la copie privée à partir d'un site internet (comme YouTube) [[https://www.nextinpact.com/news/106174-youtube-dl-comment-recuperer-legalement-flux-audio-et-video-depuis-millier-sites.htm|est légale]], mais pas sa diffusion publique. Plus généralement on peut considérer que la diffusion publique est soumise à condition si la vidéo n'est pas sous [[wpfr>licence libre]].
===== Interfaces graphiques =====
Il existe des interfaces graphiques permettant d'utiliser **yt-dlp** facilement.
==== Video Downloader ====
[[https://github.com/Unrud/video-downloader|Video Downloader]] est disponible en [[:flatpak]] sur [[https://flathub.org/apps/com.github.unrud.VideoDownloader|flathub]], en [[:snap]] et dans les dépôts [[:APT]].
==== Parabolic ====
[[https://flathub.org/apps/org.nickvision.tubeconverter|Parabolic]] est disponible en [[:flatpak]] sur [[https://flathub.org/apps/org.nickvision.tubeconverter|flathub]].
===== Outil en ligne de commande =====
Bien que **yt-dlp** s'utilise nativement depuis un [[:terminal]], son fonctionnement basique est à la portée d'un débutant.
==== Installation ====
=== APT (recommandé) ===
**yt-dlp** est disponible dans les dépôts officiels 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]].
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.
=== Snap ===
**yt-dlp** ets également disponible sur [[:snap|Snapcraft]] et donc directement depuis la [[:logithèque]] sur toutes les versions d'Ubuntu.
=== Via pip ===
yt-dlp est disponible dans les dépôts du gestionnaire de paquet **[[:pip]]**.
Pour l'installer ou le mettre à jour, saisissez :
python3 -m pip install -U yt-dlp
=== Via le PPA ===
[[: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_installer_un_paquet|Installez ensuite le paquet]] **[[apt>yt-dlp]]**.
=== Via Git ===
Pour l'installer par [[:Git]], saisissez dans un [[:terminal]] :
sudo apt install git
cd /tmp
git clone https://github.com/ytdl-org/youtube-dl
cd youtube-dl
make
sudo cp youtube-dl /usr/local/bin/
==== Configuration ====
Vous pouvez configurer **yt-dlp** grâce à des fichiers à éditer.
//voir [[https://github.com/yt-dlp/yt-dlp/blob/master/README.md#configuration|Configuration yt-dlp]] **(Github)** **(en)**//
==== Utilisation ====
=== 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'URL de la vidéo que vous souhaitez télécharger : yt-dlp [OPTIONS] URL
Vous pouvez aussi utiliser l'ID de la vidéo youtube au lieu de l'URL
La vidéo sera téléchargée et sera lisible par votre logiciel de vidéo pré-installé dans votre variante d'Ubuntu.
=== 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.
L' option ''-F'' permet d'afficher (sans les télécharger) la liste des flux disponibles :
yt-dlp -F URL
C'est ensuite l'option ''-f'' qui permet de lancer le téléchargement de son choix :
yt-dlp -f format URL
En remplaçant ''format'' par le contenu de la colonne ''ID'' du retour de la commande précédente.
=== 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)
exemple : yt-dlp -x -f bestaudio URL
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.
L'extraction de l'audio d'une vidéo requiert [[:ffmpeg]]
=== 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
yt-dlp -x -f bestaudio[ext=m4a] --add-metadata --embed-thumbnail URL
=== Sous-titres des vidéos ===
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 ** has no subtitles**
== Lister les langues possibles ==
yt-dlp --list-subs URL
== Télécharger en définissant la langue ==
yt-dlp --write-sub --sub-lang LANG URL
== Télécharger en utilisant les sous-titres généré automatiquement ==
yt-dlp --write-auto-sub --sub-lang LANG URL
Utiliser l'option ''%%--skip-download%%'' pour télécharger uniquement les sous-titres
==== Erreur "nom trop long" ====
Si vous recevez ce message d'erreur :
ERROR: unable to open for writing: [Errno 36] File name too long:
ajouter l'option "-o" suivie du nom de renommage…
Exemple : yt-dlp -o monfichierrenommé.mp4 URL
==== 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.
===== Voir aussi =====
* **(en)** [[https://github.com/yt-dlp/yt-dlp|Site officiel du logiciel]]
----
//Contributeurs : [[:utilisateurs:Amiralgaby]], [[:utilisateurs:krodelabestiole]]//