Enregistrer un live avec Streamlink
L'essentiel
- Streamlink est un utilitaire libre en ligne de commande qui extrait le flux d'un direct depuis une page web et l'envoie vers un lecteur ou un fichier ; il est publié sous licence BSD à 2 clauses.
- La commande d'enregistrement de base est streamlink -o sortie.ts URL best, best désignant la meilleure qualité disponible.
- L'option --record enregistre le flux dans un fichier pendant que vous le regardez dans votre lecteur.
- --hls-live-restart démarre un direct HLS au plus ancien segment encore proposé par le serveur, et --retry-streams attend une chaîne qui n'a pas encore commencé.
- Streamlink est conçu pour le direct ; pour les vidéos terminées et les rediffusions, yt-dlp est en général plus adapté.

Pour enregistrer un direct avec Streamlink, lancez streamlink -o enregistrement.ts URL best. Streamlink repère la vidéo en direct derrière la page web, sélectionne la qualité demandée et écrit le flux sur le disque au fil de sa réception. C’est la méthode open source la plus fiable pour capturer une diffusion en cours, qu’il s’agisse de votre propre live Twitch ou YouTube, d’une conférence ou d’un direct institutionnel, sans passer par une capture d’écran.
Ce guide part du principe que vous enregistrez vos propres lives ou des diffusions sous licence ouverte. Pour le reste, le droit d’auteur et les conditions des plateformes s’appliquent : voir télécharger une vidéo est-il légal ?.
Qu’est-ce que Streamlink ?
Streamlink est un utilitaire en ligne de commande, issu à l’origine du projet Livestreamer, qui extrait les flux des sites web et les transmet à un lecteur comme VLC ou mpv, ou les écrit dans un fichier. Écrit en Python, publié sous licence BSD à 2 clauses, il prend en charge de nombreux sites grâce à des plugins (streamlink --plugins affiche ceux qui sont installés). En coulisses, la plupart des sites de direct utilisent HLS (m3u8), certains MPEG-DASH.
Comment installer Streamlink ?
La page d’installation officielle documente ces méthodes :
| Système | Méthode |
|---|---|
| Windows | Installateur des versions streamlink/windows-builds, ou winget install streamlink, Chocolatey ou Scoop |
| macOS | brew install streamlink |
| Linux | AppImage de streamlink/streamlink-appimage, paquet de la distribution, ou pip install -U streamlink dans un environnement virtuel |
| Tout système avec Python | pip install -U streamlink |
L’installateur Windows et l’AppImage intègrent FFmpeg, nécessaire pour assembler des flux audio et vidéo séparés. Pour les autres installations, ajoutez FFmpeg vous-même (voir notre guide FFmpeg).
Comment afficher les qualités disponibles ?
Lancez Streamlink avec la seule adresse :
streamlink "https://example.org/live/ma-chaine"
Il affiche les flux disponibles, par exemple audio_only, 360p, 720p60, 1080p60 (best), worst. best et worst sont des alias de la meilleure et de la plus faible qualité.
Comment enregistrer dans un fichier ?
streamlink -o "enregistrement.ts" "https://example.org/live/ma-chaine" best
-o (ou --output) écrit le flux dans un fichier au lieu d’ouvrir un lecteur. L’extension MPEG-TS (.ts) est la plus sûre pour le direct : un fichier TS reste lisible même si l’enregistrement s’interrompt brutalement. Remuxez-le ensuite en MP4 avec FFmpeg si besoin.
Le nom de sortie peut contenir des variables de métadonnées, pratique pour garder un dossier ordonné :
streamlink -o "enregistrements/{author}/{id}-{time:%Y%m%d%H%M%S}.ts" URL best
{author}, {category}, {id}, {title} et {time} sont remplis à partir des métadonnées du flux quand le plugin les fournit.
Comment regarder et enregistrer en même temps ?
streamlink --record "enregistrement.ts" URL best
--record (ou -r) écrit le fichier pendant que le flux s’affiche dans votre lecteur. Utile quand vous modérez votre propre live et voulez une copie locale de secours.
Comment enregistrer un direct depuis le début ?
streamlink --hls-live-restart -o "complet.ts" URL best
--hls-live-restart démarre au plus ancien segment encore listé dans la playlist HLS. La profondeur disponible dépend du site : certains gardent toute la diffusion, d’autres quelques minutes. À défaut, --hls-start-offset 00:30:00 recule d’une durée donnée depuis le bord du direct, quand c’est possible.
Comment attendre un direct qui n’a pas commencé ?
streamlink --retry-streams 60 --retry-max 120 -o "evenement.ts" URL best
Streamlink vérifie la chaîne toutes les 60 secondes, jusqu’à 120 fois (deux heures), et commence à enregistrer dès que le direct démarre. Avec --retry-max 0, il réessaie indéfiniment.
Comment fiabiliser les enregistrements ?
| Problème | Option | Effet |
|---|---|---|
| Segments trop lents à télécharger | --stream-segment-threads 3 |
Télécharge jusqu’à 3 segments en parallèle (1 à 10) |
| Le flux tombe juste après l’ouverture | --retry-open 3 |
Tente 3 fois d’ouvrir le flux |
| Capture de durée fixe | --stream-segmented-duration 01:00:00 |
S’arrête après une heure de contenu |
| Écraser sans confirmation | --force |
Remplace un fichier existant |
| Noms de fichiers refusés sous Windows | --fs-safe-rules Windows |
Applique les règles de nommage Windows |
L’option --hls-duration figure encore dans d’anciens tutoriels mais elle est dépréciée au profit de --stream-segmented-duration.
Comment automatiser les enregistrements ?
Streamlink étant en ligne de commande, il s’intègre dans une tâche planifiée (Planificateur de tâches Windows), un cron ou un timer systemd sous Linux. Pour archiver vos propres lives, le schéma classique est un script qui lance Streamlink avec --retry-streams peu avant votre horaire habituel et écrit dans un fichier daté. Les options peuvent aussi être placées dans le fichier de configuration de Streamlink ; la documentation de la ligne de commande indique son emplacement selon le système.
Comment conserver ses réglages dans un fichier de configuration ?
Streamlink lit un fichier texte, une option par ligne, écrite sans les tirets initiaux :
| Système | Emplacement par défaut |
|---|---|
| Windows | %APPDATA%\streamlink\config |
| macOS | ~/Library/Application Support/streamlink/config |
| Linux et BSD | ~/.config/streamlink/config (ou sous $XDG_CONFIG_HOME) |
Exemple orienté archivage :
# configuration streamlink : mode archive
default-stream=best
stream-segment-threads=3
retry-open=3
fs-safe-rules=Windows
logfile=streamlink.log
Les guillemets font partie de la valeur : n’entourez donc pas les chemins de guillemets dans ce fichier. Les réglages propres à un site vont dans un fichier portant le même nom suivi du nom du plugin, par exemple config.twitch dans le même dossier ; ils ne s’appliquent qu’aux adresses de ce plugin. --config FICHIER charge un autre fichier, pratique pour séparer un profil « visionnage » d’un profil « archivage ».
Erreurs fréquentes et solutions
| Message ou symptôme | Signification | Que faire |
|---|---|---|
No playable streams found on this URL |
La chaîne est hors ligne, ou l’adresse n’est pas une page de direct | Vérifier l’adresse, puis ajouter --retry-streams 60 pour patienter |
No plugin can handle URL |
Le site n’a pas de plugin Streamlink | Chercher le site dans la liste des plugins, ou utiliser yt-dlp |
| Erreur mentionnant FFmpeg | Audio et vidéo séparés doivent être assemblés mais FFmpeg est introuvable | Installer FFmpeg ou indiquer son chemin avec --ffmpeg-ffmpeg CHEMIN |
| L’enregistrement s’arrête sur un délai dépassé | Aucune donnée reçue pendant le délai d’attente | Augmenter --stream-timeout, vérifier la connexion |
| Le plugin marchait hier, plus aujourd’hui | Le site a modifié son lecteur | Mettre à jour Streamlink : les plugins sont corrigés dans les nouvelles versions |
Pour signaler un problème au projet, relancez la même commande avec --loglevel debug et conservez le journal : il indique les versions de Streamlink et de Python, le plugin utilisé et la requête qui a échoué. Retirez tout jeton d’accès ou cookie avant de le partager.
Comment transformer l’enregistrement en MP4 ?
Les fichiers TS se lisent dans VLC et mpv, mais les logiciels de montage et les téléphones préfèrent le MP4. Le contenu étant déjà compressé, un simple remuxage suffit :
ffmpeg -i enregistrement.ts -c copy enregistrement.mp4
L’opération prend quelques secondes et ne touche pas à la qualité. Si le flux utilise des codecs que le MP4 n’accepte pas, choisissez le MKV ; notre article sur les conteneurs MP4, MKV et WebM indique quel codec va où.
Quand utiliser un autre outil ?
- Pour les rediffusions et les VOD une fois la diffusion terminée, yt-dlp gère mieux métadonnées, sous-titres et playlists.
- Pour simplement regarder un flux réseau sans le lecteur du site, VLC ouvre de nombreuses adresses de flux directes.
- Pour la télévision protégée par DRM, aucun de ces outils ne peut ni ne doit être utilisé : voir pourquoi une vidéo DRM ne se télécharge pas.
La liste complète des options libres figure dans notre comparatif des téléchargeurs open source.
Outils open source de ce guide
| Outil | Licence |
|---|---|
| Streamlink | BSD 2-Clause |
| FFmpeg | LGPL 2.1+ (certaines compilations GPL) |
Questions fréquentes
Quelle différence entre Streamlink et yt-dlp ?
Streamlink est spécialisé dans le direct : il transmet le flux à un lecteur ou à un fichier, avec des options de bord du direct, de reprise et de nouvelles tentatives. yt-dlp est meilleur pour les vidéos terminées, les playlists, les sous-titres et les métadonnées. Beaucoup d'archivistes utilisent Streamlink pendant la diffusion, puis yt-dlp pour la rediffusion.
Pourquoi mon enregistrement a-t-il quelques secondes de retard sur le direct ?
En HLS, Streamlink démarre quelques segments avant le plus récent pour éviter les coupures ; la valeur par défaut est de 3 segments, réglable avec --hls-live-edge. Pour repartir du plus ancien segment disponible, utilisez --hls-live-restart.
Faut-il FFmpeg pour utiliser Streamlink ?
Pas toujours. FFmpeg est requis quand Streamlink doit combiner des flux vidéo et audio séparés, ce qui est systématique en DASH et parfois le cas en HLS. L'installateur Windows et l'AppImage Linux intègrent FFmpeg.
Streamlink peut-il enregistrer un direct qui n'a pas commencé ?
Oui. Avec --retry-streams suivi d'un délai en secondes, Streamlink vérifie la chaîne jusqu'au lancement du direct, puis enregistre. Ajoutez --retry-max pour limiter le nombre de tentatives.
Enregistrer un live est-il légal ?
Enregistrer vos propres diffusions, ou des directs dont la licence ou l'auteur l'autorise, ne pose pas de problème. Enregistrer le direct d'un tiers pour le rediffuser est en général interdit, et les conditions des plateformes peuvent restreindre l'enregistrement. Consultez notre page sur la légalité du téléchargement.
Sources et données ouvertes
- Utilisation en ligne de commande de Streamlink · Projet Streamlink
- Installation de Streamlink · Projet Streamlink
- Liste des plugins Streamlink · Projet Streamlink
- Code source et licence de Streamlink (BSD-2-Clause) · GitHub
- RFC 8216 : HTTP Live Streaming · IETF
Guides liés
- Archiver ses lives
Conservez vos propres rediffusions Twitch et directs YouTube avant leur expiration : téléchargement officiel, durées de conservation, enregistrement local.
- HLS / m3u8
Ce qu'est vraiment un fichier .m3u8, comment HLS découpe une vidéo en segments et comment obtenir un seul MP4 propre avec yt-dlp ou FFmpeg.
- Guide yt-dlp
Guide pratique de yt-dlp : l'installer et le mettre à jour sans risque, choisir les formats avec -f et -S, nommer les fichiers, récupérer les sous-titres.
- FFmpeg pour fichiers vidéo
Commandes FFmpeg pour vidéos téléchargées : fusionner audio et vidéo séparés, passer de TS à MP4 sans perte, couper un extrait, assembler des parties.
- VLC : enregistrer un flux
Enregistrer un flux réseau avec VLC : la fenêtre Convertir / Enregistrer, la sortie de flux en ligne de commande, le mode dump, et quand VLC n'est pas le bon outil.