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 Youtube mais aussi de 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 copier et coller l'adresse URL de la page de la vidéo précédée de la 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-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 l'article L122-5 sur Légifrance. La SACEM indique que la copie privée à partir d'un site internet (comme youtube) est légale, mais pas sa diffusion publique.
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 officiels devient alors rapidement inutilisable (message d'erreur) sauf peut-être avec la version en snap. Sinon vous pouvez utiliser la dernière version depuis le site officiel.
Via les dépôts officiels
Youtube-dl est dans les dépôts Ubuntu. Il suffit d'installer le paquet youtube-dl ou une version plus récente via SNAP.
Via le site officiel
Pour obtenir la dernière version :
- télécharger les sources depuis le site officiel à l'aide de la commande suivante lancée depuis un terminal :
sudo wget https://yt-dl.org/latest/youtube-dl -O /usr/local/bin/youtube-dl
- 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 suivante :
sudo youtube-dl -U
Configuration
Vous pouvez modifier la configuration par défaut de Youtube-dl. Il suffit alors de créer un fichier de configuration ~/.config/youtube-dl/config en y indiquant vos propres options :
- Ouvrir votre dossier personnel
- 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 :
- créer le fichier de configuration config
- Ajouter dans ce fichier les options souhaitées, 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 :
- ~/.config/youtube-dl/config
--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 (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 compatibles 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 suiteyoutube-dl url_de_la_vidéo
- Appuyer sur "Enter" ou "Entrée" pour exécuter la commande.
La vidéo sera enregistrée dans la meilleure qualité 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 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:
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 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 souhaités (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
- Télécharger la vidéo avec les sous-titres (exemple avec l'anglais) avec cette 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:
- pour télécharger la vidéo, utiliser
proxychains
:proxychains youtube-dl url_de_la_video
Convertir un fichier webm en .mp4
Le format vidéo le plus utilisé sur Internet, et sur youtube en particulier, est le 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 :
ffmpeg -i ma-video.webm ma-video.mp4
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 meilleure qualité (et le plus gros fichier), "51" donne la moins bonne qualité (et le plus petit fichier). Pour une qualité maximale (mais le fichier peut être 10 fois plus gros que le webm initial !) :
ffmpeg -i ma-video.webm -crf 0 ma-video.mp4
Rechercher des vidéos et les regarder directement
Après avoir installé le paquet mpv, tapez dans un terminal1) :
- Par exemple
- Pour Installer Ubuntu 18.04 la commande sera :
mpv ytdl://ytsearch:installer_ubuntu_18.04
Voir aussi
- (en) Site officiel
- (en) Plus d'options
- (fr) Aide
Désinstallation
Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.