{{tag>Precise Trusty Xenial multimédia capture}}
----
====== Youtube-dl, capture de vidéo internet en ligne de commande ======
**Youtube-dl** est un utilitaire de capture de vidéos en ligne qui supporte [[https://www.youtube.com|Youtube]] mais aussi de [[http://rg3.github.io/youtube-dl/supportedsites.html|nombreuses autres plate-formes]]. \\
Bien que son utilisation s’effectue depuis un [[:terminal]], son fonctionnement basique est à la portée d'un débutant. Il suffit tout simplement de [[wpfr>Copier-coller|copier et coller]] l'adresse %%URL%% de la page de la vidéo précédée de la [[:commande_shell|commande]] **''youtube-dl''** séparée d'un espace. \\
Sans autres options, **Youtube-dl** se chargera de capturer la vidéo, la convertir au format Mp4 et l’enregistrer dans votre dossier personnel.
Pour utiliser **Youtube-dl** avec une interface graphique en français et aisément paramétrable, voir **[[:Youtube-dlg|Youtube-DL-GUI]]** //(Paquet **youtube-dlg**, à ne pas confondre avec le paquet [[:youtube-dl-gui]])// .
La copie d’œuvre 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]].
===== Pré-requis =====
* Disposer des [[:sudo|droits d'administration]].
* Disposer d'une connexion à Internet configurée et activée.
* Avoir installé l'encodeur vidéo [[:FFmpeg]] (ou [[:avconv|Libav-tools]] pour [[:trusty|Ubuntu Trusty 14.04]] ou [[:precise|Precise 12.04]]). Dans le cas contraire, la version de l'encodeur vidéo disponible depuis les [[:depôts|dépôts officiels]] sera installée automatiquement.
===== Installation =====
Pour capturer les vidéos de Youtube, il est nécessaire de mettre souvent à jour **Youtube-dl** car Google, propriétaire de Youtube, modifie fréquemment ses codes. La version des [[:dépôts|dépôts officiels]] devient alors rapidement inutilisable (message d'erreur). Préférez alors une solution facile à mettre à jour disponible depuis le [[#via un PPA|PPA ci-dessous]] ou bien la dernière version depuis le [[#via le site officiel|site officiel]] ou encore l'[[#installation d'un package youtube-dl compilé]].
Pour [[:trusty|Ubuntu Trusty 14.04]], il est nécessaire d'utiliser la [[:avconv#via_un_ppa_pour_trusty_1404_uniquement|version 11 de l'encodeur audio/vidéo Avconv]], la version 9 par défaut ne fonctionnant pas avec Youtube-dl. Une autre solution consiste à utiliser à la place l'[[:ffmpeg#via_un_ppa_pour_trusty_1404_uniquement|encodeur FFmpeg]] tout aussi bien pris en charge.
====Via les dépôts officiels====
**Youtube-dl** est dans les [[:depots|dépôts Ubuntu]]. Il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>youtube-dl]]**
====Via un dépôt PPA====
Les [[:PPA|dépôts PPA]] sont des dépôts non-officiels. Installer un paquet hors des [[:dépôts]] officiels peut présenter un risque d'instabilité pour votre système.
Ce [[:PPA|dépôt PPA]] est fréquemment mis à jour et permet ainsi de bénéficier d'une version très récente de **Youtube-dl** ainsi que de sa tenue à jour. Pour cela il suffit:
- d'[[:ppa|ajouter le PPA]] **ppa:rvm/smplayer**((https://launchpad.net/~rvm/+archive/ubuntu/smplayer/)) à vos sources de logiciels;
- [[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|recharger la liste de vos paquets]];
- puis [[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>youtube-dl]]**.
Ou dans un [[:terminal]], saisir les [[:commande_shell|commandes]] suivantes: sudo add-apt-repository ppa:rvm/smplayer -y
sudo apt-get update
sudo apt-get install youtube-dl
==== Via le site officiel ====
Installer un paquet hors des [[:dépôts]] officiels peut présenter un risque d'instabilité pour votre système.
Pour obtenir la dernière version:
- télécharger les sources depuis [[http://youtube-dl.org/|le site officiel]] à l'aide de la [[:commande_shell|commande]] suivante lancée depuis un [[terminal]]:sudo wget https://yt-dl.org/latest/youtube-dl -O /usr/local/bin/youtube-dl
- [[:permissions#modifier_les_permissions|Rendre le fichier binaire exécutable]]: sudo chmod a+x /usr/local/bin/youtube-dl
- Puis hash -r
Pour mettre à jour par la suite **youtube-dl**, il suffira d'entrer la [[:commande_shell|commande]] suivante:sudo youtube-dl -U
==== Installation d'un package youtube-dl compilé ====
Installer un paquet hors des [[:dépôts]] officiels peut présenter un risque d'instabilité pour votre système.
Autre possibilité pour obtenir la dernière version:
* Taper les [[:commande_shell|commandes]] suivantes pour compiler son propre package youtube-dl et l'installer :
sudo apt install -y python-sphinx pandoc
mkdir -p src && cd src && git clone https://github.com/rg3/youtube-dl
cd youtube-dl*/
make && sudo checkinstall --pkgname youtube-dl --pkgversion $(awk -F"'" '/__version__/{print$2}' ./youtube_dl/version.py) --requires "python-pkg-resources, python, python"
* Pour faire une mise à jour de ce package compilé, taper les [[:commande_shell|commandes]] suivantes :
cd youtube-dl*/ && git pull
make && sudo checkinstall --pkgname youtube-dl --pkgversion $(awk -F"'" '/__version__/{print$2}' ./youtube_dl/version.py) --requires "python-pkg-resources, python, python"
=====Configuration====
Vous pouvez modifier la configuration par défaut de **Youtube-dl**. Il suffit alors de [[:tutoriel/comment_modifier_un_fichier|créer un fichier]] de configuration **~/.config/youtube-dl/config** en y indiquant vos propres options:
- Ouvrir votre dossier personnel
- [[:fichier_cache#afficher_les_elements_caches|Afficher les dossiers cachés]] avec la combinaison de touches +
- Ouvrir le dossier **.config**
- Dans ce dernier, créer un dossier **youtube-dl** puis à l'intérieur:
- [[:tutoriel/comment_modifier_un_fichier|créer le fichier]] de configuration **config**
- Ajouter dans ce fichier les options souhaités chacune sur une ligne différente puis enregistrer et fermer ce fichier.
Exemple de fichier **config** pour obtenir uniquement la bande son dans le format de sortie Mp3:--extract-audio
--audio-format mp3
À peu près toutes les options du chapitre [[#Utilisation]] ci-dessous sont possibles. (Pour encore plus d'options, voir le [[man>youtube-dl| (en) manuel]]).
__À noter__: le fichier ainsi créé ne concerne que l'utilisateur actuellement connecté. Pour modifier la configuration de **youtube-dl** pour l'ensemble du système on créera plutôt le fichier **/etc/youtube-dl.conf**
===== Utilisation =====
- Se rendre sur un des sites compatible et rechercher la vidéo que vous voulez télécharger et copier l'adresse de sa page;
- Ouvrir un [[:terminal]], saisir **''youtube-dl''** suivie d'un espace et coller l'adresse %%URL%% de la vidéo à sa suite youtube-dl url_de_la_vidéo
- Appuyer sur "Enter" ou "Entrée" pour exécuter la [[:commande_shell|commande]].
La vidéo sera enregistrée en qualité la meilleure dans votre dossier personnel. Pour l’enregistrer dans un autre dossier, avant de saisir la commande, il suffit dans le [[:terminal]] de se positionner dans le dossier voulu à l'aide de la commande **[[:console#cd|cd]]**.
==== Obtenir uniquement l'audio ====
Si vous souhaitez n'obtenir que la bande son de la vidéo il suffit d'utiliser l'option **-x** soit la [[:commande_shell|commande]]:
youtube-dl -x url_de_la_vidéo
Le fichier audio extrait sera au meilleur format.
===Modifier le format audio===
Si vous souhaitez un autre format de sortie, il suffit de le préciser en ajoutant l'option **--audio-format** suivi du format souhaité. Formats disponibles: "aac", "vorbis", "mp3", "m4a", "opus", et "wav". \\
Exemple de [[:commande_shell|commande]] pour obtenir un format Mp3: youtube-dl -x --audio-format mp3 url_de_la_vidéo
==== Choisir la qualité et le format ====
- Lister les formats et qualités disponibles avec l'option **-F** :youtube-dl -F url_de_la_vidéo
Peut donner quelques chose comme :format code extension resolution note
171 webm audio only DASH webm audio , audio@ 48k (worst)
140 m4a audio only DASH audio , audio@128k
160 mp4 144p DASH video , video only
133 mp4 240p DASH video , video only
134 mp4 360p DASH video , video only
135 mp4 480p DASH video , video only
136 mp4 720p DASH video , video only
137 mp4 1080p DASH video , video only
17 3gp 176x144
36 3gp 320x240
5 flv 400x240
43 webm 640x360
18 mp4 640x360
22 mp4 1280x720 (best)
- Ensuite avec l'option **-f**, choisir les formats vidéo et audio voulus //(Le premier format doit contenir la vidéo)// :youtube-dl -f 137+140 url_de_la_vidéo
Ou encore un format complet (par exemple le format videoflash :youtube-dl -f 5 url_de_la_vidéo
* On trouve également des retours de ce type :ld mp4 320x240 (worst)
standard mp4 512x384
hq mp4 848x480 (best)
Dans ce cas on utilisera par exemple :youtube-dl -f standard url_de_la_vidéo
==== Enregistrement de sous-titres ====
- Avant de télécharger la vidéo, dans un [[:terminal]], saisir la [[:commande_shell|commande]]:youtube-dl --list-subs url_de_la_vidéo
Une liste des langues disponibles est affichée :[youtube] 'référence de la vidéo': Available subtitles for video: en
- Télécharger la vidéo avec les sous-titres (exemple avec l'anglais) avec cette [[:commande_shell|commande]]:youtube-dl --write-sub --sub-lang 'en' url_de_la_vidéo
==== Problème de SME: proxy TOR ====
Si jamais la vidéo ne peut pas être lue dans votre pays du fait de la propriété intellectuelle, un message de ce type apparaît
''ERROR: -XXXXX: YouTube said: This video contains content from SME, who has blocked it in your country on copyright grounds.''
Pour télécharger la vidéo malgré tout, on peut passer par le proxy de TOR:
- installer TOR : sudo apt-get install proxychains tor obfsproxy
- pour télécharger la vidéo, utiliser ''proxychains'': proxychains youtube-dl url_de_la_video
=====Voir aussi =====
* **(en)** [[http://rg3.github.io/youtube-dl/|Site officiel]]
* **(en)** Plus d'options [[https://github.com/rg3/youtube-dl|ici]]
* ** (fr)** Aide [[http://la-vache-libre.org/youtube-dl-telechargez-des-videos-en-ligne-de-commande-sur-diverses-plateformes-vimeo-youtube-google-arte-tv-etc/|ici]]
* [[man>youtube-dl|Le manuel]]
===== Désinstallation =====
Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
====Installé depuis les dépôts officiels ou depuis le PPA====
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.
====Installé depuis le site officiel====
[[:tutoriel:comment_supprimer_un_fichier|Supprimer le fichier]] /usr/local/bin/**youtube-dl**
----
//Contributeurs: [[:utilisateurs:gp974|Gp974]], [[:utilisateurs:mydjey|mydjey]].//