✎ 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 puis de valider. \\
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é.

<note>Pour ceux qui ne souhaitent pas utiliser un [[:terminal]], il existe **Youtube-dl-gui**, une version graphique très simpliste de **youtube-dl**. 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. \\
Voir [[#youtube-dl-gui|ce chapitre]] pour en savoir un peu plus. </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.

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

====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:nilarimogard/webupd8**((https://launchpad.net/~nilarimogard/+archive/ubuntu/webupd8)) à 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]]**. 
  - Si vous laissez ce [[:PPA]] actif, **Youtube-dl** sera tenue à jour. Mais...\\ :!: __Attention__: Ce [[:PPA]] contient aussi de très nombreux autres paquets de versions supérieures. Si vous ne souhaitez pas de mise à jour vers des versions supérieures de ses paquets lors de la prochaine mise à jour de votre système, [[:ppa#suppression_d_un_ppa|désactiver ce PPA]] de vos sources de logiciels avant de lancer votre [[:gestionnaire de mises à jour]].
Ou dans un [[:terminal]], saisir les [[:commande_shell|commandes]] suivantes: <code>sudo add-apt-repository ppa:nilarimogard/webupd8
sudo apt-get update
sudo apt-get install youtube-dl</code> Puis si vous souhaitez retirer ce [[:PPA]] de vos sources de logiciels: <code>sudo add-apt-repository ppa:nilarimogard/webupd8 --remove </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 le où les formats voulus :
<code>youtube-dl -f 140+137 <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>

=====Youtube-dl-gui=====

Si vraiment vous n'aimez pas utiliser un [[:terminal]], **Youtube-dl-gui**, une application graphique très simpliste (et dépouillée) pour **youtube-dl** est peut-être faite pour vous. Sans option ni d'indicateur de téléchargement, vous n'avez qu'un [[wpfr>Copier-coller|copié/collé]] de l'adresse %%URL%% de la page de la vidéo à faire. 
====Installation====
Le paquet au format .deb de cette application n'est pas disponible dans les [[:dépots|dépôts officiels]] mais depuis [[https://launchpad.net/gui-youtube-dl|Launchpad]]. Bien que ce paquet soit destiné aux [[:debian_ubuntu_comparaison|distributions Debian]], il n'est pas vérifié par les contributeurs pour Ubuntu.
  - Télécharger depuis [[https://launchpad.net/gui-youtube-dl/release-1.0/rc1/+download/youtube-dl-gui_0.1.2-1ubuntu1_all.deb|ce lien]] et [[:tutoriel/comment_installer_un_paquet#installer_un_paquet_isole|installer ce paquet isolé]]. 
Si ce n'est pas déjà fait, le programme source Youtube-dl sera installé automatiquement. Sans autre [[:tutoriel:comment_modifier_sources_maj|modification préalable des sources de logiciels]], ce sera la version des [[#via les depots officiels|dépôts officiels]] qui sera installée. Si vous souhaitez une version plus récente et tenue à jour du programme source Youtube-dl, il vous faudra [[:ppa|ajouter le PPA]] **ppa:nilarimogard/webupd8**((https://launchpad.net/~nilarimogard/+archive/ubuntu/webupd8)) à vos [[:tutoriel:comment_modifier_sources_maj|sources de logiciels]].
====Utilisation====
L'application se lance comme n'importe quelle autre application graphique. Depuis le [[:unity#tableau_de_bord_dash|tableau de bord d'Unity]] ou pour les menus classiques, **Multimédia** -> **Youtube-dl**.
  - Ensuite, copiez l'adresse %%URL%% de la page de la vidéo et collez-la dans la case prévue à cet effet.
  - Validez et patientez, il n'y a aucun indicateur de téléchargement. Si la vidéo est importante et de bonne qualité, cela prendra du temps. 
La vidéo sera enregistrée à la racine de votre dossier personnel au format mp4.
====Options====
Bien que **youtube-dl-gui** n'ait pas la possibilité de modifier les options, vous pouvez toujours modifier celles-ci en [[#configuration|modifiant (ou créant) le fichier de configuration du programme source youtube-dl]].

=====Problèmes connus=====
====Trusty 14.04 et Libav====
**Youtube-dl** peut rencontrer des problèmes de conversion avec la version 9 de l'[[:avconv|encodeur vidéo Libav]] disponible dans les [[:depots|dépôts officiels]] pour [[:trusty|Ubuntu Trusty 14.04]]. Si tel était le cas, il suffit de [[:avconv#via_un_ppa_pour_trusty_1404_uniquement|mettre à jour Libav depuis un PPA]] ou encore d'utiliser [[:ffmpeg#via_un_ppa_pour_trusty_1404_uniquement| FFmpeg]].

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

----

//Contributeurs:  [[:utilisateurs:gp974|Gp974]], [[:utilisateurs:mydjey|mydjey]], [[:utilisateurs|Cafecho]].

Merci de recopier le code ci-contre pour prouver que vous êtes humain : O G U H V 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