✎ youtube-dl [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== 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]]). 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]]<del> ou encore l'[[#installation d'un package youtube-dl compilé]]</del>.

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====
Solution 1 : **Youtube-dl** est dans les [[:depots|dépôts Ubuntu]]. Il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>youtube-dl]]**

Solution 2 : **Youtube-dl** existe dans une version plus récente dans SNAP.  Il suffit de lancer dans un terminal : <note>sudo snap install youtube-dl</note>
====Via un dépôt PPA====

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]]**.

<note warning>Avec la version 18.04.1, la version du ppa ne permet pas de télécharger despuis YouTube alors que la version officielle (téléchargé par ''wget'') fonctionne ! </note>
==== Via le site officiel ====
<note important>Installer un logiciel hors des paquets des [[:dépôts]] officiels peut présenter un risque d'instabilité pour votre système. </note>
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]]:<code>sudo wget https://yt-dl.org/latest/youtube-dl -O /usr/local/bin/youtube-dl</code>
  - [[:permissions#modifier_les_permissions|Rendre le fichier binaire exécutable]]: <code>sudo chmod a+x /usr/local/bin/youtube-dl</code>
  -  Puis <code>hash -r</code>
Pour mettre à jour par la suite **youtube-dl**, il suffira d'entrer la [[:commande_shell|commande]] suivante:<code>sudo youtube-dl -U</code>

=====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 <Ctrl>+<H>
  - 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:<file - ~/.config/youtube-dl/config>--extract-audio
--audio-format mp3</file>
À 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 <code>youtube-dl  url_de_la_vidéo</code>
  - 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]]:
<code>youtube-dl -x url_de_la_vidéo</code> 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: <code>youtube-dl -x --audio-format mp3 url_de_la_vidéo</code>

==== Choisir la qualité et le format ====
  - Lister les formats et qualités disponibles avec l'option **-F** :<code>youtube-dl -F url_de_la_vidéo</code>Peut donner quelques chose comme :<code>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)</code>
  - Ensuite avec l'option **-f**, choisir les formats vidéo et audio voulus //(Le premier format doit contenir la vidéo)// :<code>youtube-dl -f 137+140 url_de_la_vidéo</code> Ou encore un format complet (par exemple le format videoflash :<code>youtube-dl -f 5 url_de_la_vidéo</code>
    * On trouve également des retours de ce type :<code>ld          mp4       320x240     (worst)
standard    mp4       512x384     
hq          mp4       848x480     (best)</code>Dans ce cas on utilisera par exemple :<code>youtube-dl -f standard url_de_la_vidéo </code>

==== Enregistrement de sous-titres ====

- Avant de télécharger la vidéo, dans un [[:terminal]], saisir la [[:commande_shell|commande]]:<code>youtube-dl --list-subs url_de_la_vidéo</code> Une liste des langues disponibles est affichée :<code>[youtube] 'référence de la vidéo': Available subtitles for video: en</code>
  - Télécharger la vidéo avec les sous-titres (exemple avec l'anglais) avec cette [[:commande_shell|commande]]:<code>youtube-dl --write-sub --sub-lang 'en' url_de_la_vidéo</code>

==== 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:
  - [[:tutoriel:comment_installer_un_paquet|installer]] **[[apt>proxychains,tor,obfsproxy|proxychains tor obfsproxy]]**
  - pour télécharger la vidéo, utiliser ''proxychains'': <code>proxychains youtube-dl url_de_la_video</code>

=====Convertir un fichier webm en .mp4=====
Le format vidéo le plus utilisé sur Internet, et sur youtube en particulier, est le [[webm|webm]]. Ce sera donc sans doute le format de votre vidéo après téléchargement. Pour voir une vidéo webm sur une télévision, il vous faudra sans doute modifier le format (il n'est généralement pas reconnu nativement). Pour passer la vidéo webm en .**mp4** :

<code>ffmpeg -i ma-video.webm ma-video.mp4</code>
La qualité de sortie est alors d'une qualité moyenne.

Vous pouvez spécifier une autre qualité de sortie avec l'option **-crf**. "0" donne la meilleur qualité (et le plus gros fichier), "51" donne la moins bonne qualité (et le plus petit fichier). Pour une qualité maximum (mais le fichier peut-être 10 fois plus gros que le webm initial !) :

<code>ffmpeg -i ma-video.webm -crf 0 ma-video.mp4</code>

=====Voir aussi =====
  * **(en)** [[http://rg3.github.io/youtube-dl/|Site officiel]]
  * **(en)** [[https://github.com/rg3/youtube-dl|Plus d'options]]
  * ** (fr)** [[http://la-vache-libre.org/youtube-dl-telechargez-des-videos-en-ligne-de-commande-sur-diverses-plateformes-vimeo-youtube-google-arte-tv-etc/|Aide]]
  * [[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]].//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : I E U᠎ E N Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported