CH02 / Formats et streaming

HLS et fichiers .m3u8 : télécharger un flux correctement

Mis à jour le Rédaction Video Downloader Info9 segments~6 min

L'essentiel

  1. Un fichier .m3u8 n'est pas une vidéo : c'est une playlist texte en UTF-8 qui liste les courts segments composant un flux HTTP Live Streaming (HLS).
  2. HLS a été créé par Apple et documenté par l'IETF dans la RFC 8216, publiée en août 2017.
  3. Une playlist principale (multivariant) liste plusieurs niveaux de qualité ; chacun renvoie à une playlist de médias qui liste les segments.
  4. yt-dlp et FFmpeg savent lire une URL .m3u8 et assembler ses segments en un seul MP4 sans réencodage, par simple copie de flux.
  5. Si la playlist fait appel à FairPlay ou à un autre système de DRM, les segments sont protégés et ne doivent pas être déchiffrés sans autorisation.
Baies de serveurs dans un centre de données, là où les segments HLS sont stockés et servis
Image: Datacenter Server Racks (22370909788),Carl Lender from Sunrise, USA,CC BY 2.0,via Wikimedia Commons.

Un fichier .m3u8 est une playlist, pas une vidéo. HLS (HTTP Live Streaming) découpe une vidéo en courts segments, les liste dans un fichier texte .m3u8 et laisse le lecteur les récupérer l’un après l’autre en HTTP classique. Pour télécharger une vidéo HLS, on confie donc cette URL de playlist (ou l’URL de la page) à un outil qui lit la liste, récupère chaque segment et les assemble en un seul fichier. yt-dlp et FFmpeg font exactement cela, en local et sans réencodage.

Ce guide détaille le contenu d’un .m3u8, la bonne méthode pour enregistrer un flux et la limite légale à respecter. Il s’applique à vos propres flux, aux contenus du domaine public ou sous licence libre, et à ceux que vous avez l’autorisation de conserver (voir télécharger une vidéo est-il légal ?).

Qu’est-ce que HLS et pourquoi les sites l’utilisent-ils ?

HLS a été lancé par Apple, puis publié par l’IETF sous la forme de la RFC 8216 en août 2017. C’est devenu le format de diffusion vidéo le plus répandu, pour trois raisons pratiques :

  • Il fonctionne en HTTP ordinaire. Les segments sont de simples fichiers, que n’importe quel serveur web ou CDN peut mettre en cache.
  • Il s’adapte au débit. La même vidéo est encodée à plusieurs débits et le lecteur passe de l’un à l’autre selon la connexion.
  • Il gère le direct et la vidéo à la demande. Une playlist en direct s’allonge en continu ; une playlist terminée se clôt par une balise de fin.

Son principal concurrent est MPEG-DASH, qui repose sur la même idée avec un manifeste XML.

Que contient un fichier .m3u8 ?

Il existe deux types de playlists, et vous croiserez généralement les deux.

La playlist principale (dite « master » ou « multivariant ») liste les niveaux de qualité :

#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=2500000,RESOLUTION=1280x720,CODECS="avc1.64001f,mp4a.40.2"
720p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=5000000,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2"
1080p/index.m3u8

La playlist de médias liste les segments d’un niveau de qualité :

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:6
#EXTINF:6.0,
segment00000.ts
#EXTINF:6.0,
segment00001.ts
#EXT-X-ENDLIST

Les balises à reconnaître :

Balise Signification
#EXT-X-STREAM-INF Une variante de qualité : débit, résolution, codecs
#EXTINF Durée du segment suivant
#EXT-X-TARGETDURATION Durée maximale d’un segment
#EXT-X-ENDLIST Le flux est terminé (à la demande) ; absente en direct
#EXT-X-MEDIA Rendus alternatifs : autres langues audio, sous-titres
#EXT-X-KEY Les segments sont chiffrés ; indique la méthode et l’emplacement de la clé

Les segments sont traditionnellement des fichiers MPEG-TS (.ts), mais HLS accepte aussi des segments MP4 fragmentés (.m4s ou .mp4). La différence compte au moment de choisir le conteneur final.

Comment télécharger un flux HLS avec yt-dlp ?

Dans la plupart des cas, donnez à yt-dlp l’URL de la page plutôt que la playlist : il trouve lui-même le .m3u8, choisit la meilleure variante et fusionne la piste audio séparée s’il y en a une.

# Lister les variantes trouvées derrière la page
yt-dlp -F "https://example.org/mon-webinaire"

# Télécharger la meilleure variante, 4 segments en parallèle
yt-dlp -N 4 "https://example.org/mon-webinaire"

Si vous n’avez que l’URL de la playlist, passez-la directement ; l’extracteur générique de yt-dlp gère les liens .m3u8 :

yt-dlp -o "webinaire.%(ext)s" "https://cdn.example.org/chemin/master.m3u8"

-N (--concurrent-fragments) télécharge plusieurs segments à la fois, ce qui accélère les longs enregistrements. Par défaut, yt-dlp écrit le résultat dans un conteneur MP4 ; --hls-use-mpegts conserve le MPEG-TS, plus robuste en cas d’interruption puisqu’un fichier .ts partiel reste lisible.

Comment télécharger un .m3u8 avec FFmpeg ?

FFmpeg lit nativement les playlists HLS :

ffmpeg -i "https://cdn.example.org/chemin/master.m3u8" -c copy sortie.mp4
  • -i reçoit l’URL de la playlist. Avec une playlist principale, FFmpeg expose chaque variante comme un programme distinct et en choisit un par défaut.
  • -c copy copie l’audio et la vidéo sans réencodage : c’est rapide et sans perte.

Pour choisir une variante précise, inspectez d’abord la playlist avec ffprobe, puis sélectionnez le programme avec -map :

ffprobe -hide_banner "https://cdn.example.org/chemin/master.m3u8"
ffmpeg -i "https://cdn.example.org/chemin/master.m3u8" -map 0:p:2 -c copy sortie.mp4

0:p:2 signifie « programme 2 de l’entrée 0 » ; les numéros de programme figurent dans la sortie de ffprobe. Les très anciennes versions de FFmpeg exigeaient le filtre -bsf:a aac_adtstoasc pour copier l’audio AAC d’un MPEG-TS vers un MP4 ; les versions actuelles l’insèrent automatiquement, mais l’option reste sans danger sur une vieille version.

Comment enregistrer un direct HLS ?

Une playlist en direct n’a pas de #EXT-X-ENDLIST : elle est rafraîchie toutes les quelques secondes avec de nouveaux segments. Les deux outils la suivent jusqu’à la fin de la diffusion ou jusqu’à ce que vous fassiez Ctrl+C :

yt-dlp --hls-use-mpegts "https://example.org/live/ma-chaine"
ffmpeg -i "https://cdn.example.org/live/index.m3u8" -c copy enregistrement.ts

Enregistrer d’abord en .ts, puis convertir en MP4 ensuite, évite de tout perdre si la connexion tombe. Pour l’enregistrement de directs, voyez aussi Streamlink et notre méthode pour archiver ses propres lives.

Pourquoi mon téléchargement HLS échoue-t-il ?

Symptôme Cause probable Que faire
Erreur HTTP 403 sur les segments URL signées expirées ou en-têtes manquants Repartir de l’URL de la page avec yt-dlp, qui régénère les liens
Vidéo sans son L’audio est un rendu #EXT-X-MEDIA séparé Utiliser yt-dlp, qui fusionne, ou mapper les deux flux dans FFmpeg
Fichier saccadé ou désynchronisé Segments manquants Relancer ; utiliser --hls-use-mpegts et les reprises
Fichier illisible, #EXT-X-KEY avec un système de clés Protection DRM Arrêter : voir ci-dessous

Et les flux HLS chiffrés ?

La RFC 8216 définit des méthodes de chiffrement (AES-128 pour des segments entiers, SAMPLE-AES pour les échantillons). Un service peut fournir les clés librement à tout lecteur, ou en restreindre l’accès via un système de DRM commercial comme Apple FairPlay. Dès qu’un système de clés ou un serveur de licences intervient, le flux est protégé par une mesure technique, et la contourner est illégal en France (article L.335-3-1 du Code de la propriété intellectuelle), dans l’Union européenne et dans la plupart des pays, quel que soit l’outil. Notre guide sur les DRM explique le fonctionnement de ces systèmes et les options légales qui restent, comme le mode hors ligne officiel du service.

Comment corriger les erreurs HLS les plus fréquentes ?

La plupart des échecs suivent quelques schémas connus. Lisez la première ligne d’erreur du journal, puis reportez-vous à ce tableau :

Symptôme Cause probable Que faire
Erreur HTTP 403 sur la playlist ou les segments L’URL signée ou le jeton a expiré, ou le serveur attend les en-têtes de la page qui intègre le lecteur Repartir de l’URL de la page plutôt que d’un lien .m3u8 copié, pour obtenir un jeton neuf
Arrêt après quelques segments Coupure réseau ou limitation de débit Augmenter les tentatives avec --fragment-retries 20 et réduire le parallélisme (-N 1)
« Malformed AAC bitstream » lors de l’écriture en MP4 L’audio ADTS du MPEG-TS doit être converti pour le MP4 Les versions récentes de FFmpeg le font seules ; avec une version ancienne, ajoutez -bsf:a aac_adtstoasc
Son qui se décale sur un long enregistrement Sauts d’horodatage entre segments, fréquents en direct Garder le .ts brut, puis le remuxer une seule fois : ffmpeg -i in.ts -map 0 -c copy out.mkv
Petits trous ou images figées Des segments ont été ignorés après des erreurs répétées Relancer avec --abort-on-unavailable-fragments pour échouer clairement plutôt qu’en silence

Deux réflexes évitent l’essentiel de ces soucis. D’abord, télécharger depuis la page et non depuis une URL de playlist copiée dans les outils de développement du navigateur : les extracteurs de page savent renouveler les jetons. Ensuite, essayer l’autre moteur si l’un se comporte mal. yt-dlp peut récupérer le HLS avec son code natif ou confier le travail à FFmpeg :

yt-dlp --downloader native URL
yt-dlp --downloader ffmpeg URL

Récapitulatif

  1. Privilégier l’URL de la page avec yt-dlp ; à défaut, l’URL du .m3u8.
  2. Vérifier les variantes avec -F ou ffprobe avant de télécharger.
  3. Toujours copier les flux ; ne jamais réencoder juste pour changer de conteneur.
  4. En direct, enregistrer en .ts, convertir ensuite.
  5. En présence d’un système de DRM, s’arrêter et chercher une source légale.

Outils open source de ce guide

OutilLicence
yt-dlpUnlicense (domaine public)
FFmpegLGPL 2.1+ (certaines compilations GPL)

Questions fréquentes

VLC peut-il ouvrir un lien .m3u8 ?

Oui. VLC lit une URL de playlist HLS via Média > Ouvrir un flux réseau, et l'option Convertir/Enregistrer permet d'écrire le flux dans un fichier. Pour de longs enregistrements ou de nombreux fichiers, yt-dlp et FFmpeg sont plus fiables, car ils gèrent explicitement les reprises et la copie de flux.

Pourquoi est-ce que j'obtiens des centaines de fichiers .ts au lieu d'une vidéo ?

Cela arrive quand les segments sont récupérés un par un, par exemple par une extension de navigateur. HLS fonctionne ainsi par conception. Utilisez plutôt yt-dlp ou FFmpeg sur l'URL de la playlist : ils récupèrent chaque segment dans l'ordre et les écrivent dans un seul conteneur.

Télécharger un flux HLS fait-il perdre de la qualité ?

Non, tant que vous utilisez la copie de flux (-c copy dans FFmpeg, comportement par défaut de yt-dlp). Les segments sont assemblés bit à bit. La qualité ne baisse que si vous choisissez une variante inférieure ou si vous réencodez le fichier.

Un flux HLS chiffré est-il forcément protégé par DRM ?

Pas toujours. La RFC 8216 définit les méthodes de chiffrement AES-128 et SAMPLE-AES, que les services peuvent associer à des systèmes de clés comme Apple FairPlay. Quelle que soit la méthode, si l'accès à la clé est restreint, considérez le flux comme protégé et ne tentez pas de le contourner.

Comment trouver l'URL .m3u8 d'une vidéo ?

Ouvrez les outils de développement du navigateur, onglet Réseau, filtrez sur m3u8 puis lancez la lecture : la requête de la playlist apparaît. Le plus souvent, c'est inutile : en donnant à yt-dlp l'URL de la page, il trouve la playlist tout seul.

Sources et données ouvertes

  1. RFC 8216 : HTTP Live Streaming · IETF / RFC Editor
  2. Ressources HTTP Live Streaming pour développeurs · Apple
  3. Documentation des formats FFmpeg (démultiplexeur et multiplexeur HLS) · Projet FFmpeg
  4. README de yt-dlp (options de téléchargement) · Projet yt-dlp