✎ 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]] uniquement, 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. À vous ensuite de la regarder avec votre lecteur vidéo préféré.

**Youtube-gl** dispose d'[[wpfr>interface graphique|interfaces graphiques]] que vous pouvez utiliser si vous préférez éviter le [[:terminal]]:
  * ** [[:Youtube-dlg|YouTube DL GUI]]**: Une interface graphique très complète en anglais seulement.
  * ** [[:Youtube-dl-gui]]**: une interface graphique en anglais très simpliste et dépouillée disponible pour les distributions Debian. Sans aucune option disponible, vous serez limité à un simple [[wpfr>Copier-coller|copié/collé]] de l'adresse %%URL%% de la page de la vidéo.
<note important>La copie d’œuvre est réglementée pour chaque pays. Pour la France, voir [[http://www.legifrance.gouv.fr/affichCodeArticle.do?idArticle=LEGIARTI000025003518&cidTexte=LEGITEXT000006069414|l'article L122-5 sur Légifrance]].</note>
===== 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====
<note important>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. </note>

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: <code>sudo add-apt-repository ppa:rvm/smplayer -y
sudo apt-get update
sudo apt-get install youtube-dl</code>

==== Via le site officiel ====
<note important>Installer un paquet hors 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>

==== Installation d'un package youtube-dl compilé ====
<note important>Installer un paquet hors des [[:dépôts]] officiels peut présenter un risque d'instabilité pour votre système. </note>
Autre possibilité pour obtenir la dernière version:
  * Taper les [[:commande_shell|commandes]] suivantes pour compiler son propre package youtube-dl et l'installer :<code>
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"</code>
  * Pour faire une mise à jour de ce package compilé, taper les [[:commande_shell|commandes]] suivantes :<code>
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"</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:
  - installer TOR : <code>sudo apt-get install proxychains tor obfsproxy</code>
  - pour télécharger la vidéo, utiliser ''proxychains'': <code>proxychains youtube-dl <url_de_la_video></code>

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

Merci de recopier le code ci-contre pour prouver que vous êtes humain : M D U I S 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