Langue :

Video.js vs Plyr vs react-player vs hls.js : quelle bibliothèque de lecteur vidéo choisir ?

Video.js, Plyr, react-player, hls.js ou Mux Player ? Découvrez le rôle de chaque bibliothèque, comparez leur code d’installation et leurs fonctionnalités, puis choisissez celle qui convient à votre site ou à votre application — ou faites sans bibliothèque.
Découvrez ce qu’en pense ChatGPT

Vous avez besoin d’intégrer des vidéos à votre site ou à votre application, et quatre noms reviennent souvent : Video.js, Plyr, react-player et hls.js — auxquels s’ajoute Mux Player si vous diffusez vos vidéos avec Mux. Tous sont populaires et open source, mais répondent à des besoins différents.

Ce guide vous explique concrètement en quoi consiste chaque option, présente le code de configuration minimal, les compare côte à côte et vous aide à choisir la solution adaptée — ou à déterminer si vous pouvez vous passer d’une bibliothèque.

Points clés



  • Video.js : un framework de lecteur complet, doté d’un vaste écosystème de plugins, de thèmes et de la lecture HLS/DASH intégrée. Idéal pour garder le contrôle et faire évoluer votre lecteur.
  • Plyr : un lecteur léger doté d’une interface soignée et accessible par défaut, compatible avec les vidéos HTML5, YouTube et Vimeo. Idéal pour obtenir rapidement un lecteur élégant.
  • react-player — un composant React qui lit de nombreux types d’URL (fichiers, YouTube, Vimeo, etc.) via une API unique. Idéal pour les applications React qui utilisent différentes sources.
  • hls.js n’est pas une interface de lecteur, mais un moteur de streaming qui permet aux navigateurs sans prise en charge native de lire des vidéos HLS. Associez-le à la balise vidéo ou à un lecteur.
  • Mux Player — un lecteur conçu pour les vidéos hébergées sur Mux, avec des outils d’analyse intégrés. Idéal si Mux est votre plateforme vidéo.
  • Si vous souhaitez afficher une galerie de vidéos YouTube, TikTok ou Instagram sur vos pages marketing, un widget prêt à l’emploi est généralement plus rapide à mettre en place qu’une bibliothèque.

Quel problème cherchez-vous à résoudre ?

Avant de comparer les fonctionnalités, définissez clairement votre objectif. La plupart des équipes se trouvent dans l’une de ces quatre situations :

  1. Lisez vos propres fichiers MP4 avec une interface plus agréable que celle du navigateur par défaut — Plyr ou Video.js.
  2. Diffusez des vidéos longues ou en direct avec une qualité adaptative (HLS/DASH) : Video.js, hls.js avec votre propre interface, ou le lecteur de votre plateforme vidéo (par exemple Mux Player).
  3. Lisez des vidéos depuis différentes plateformes dans une application React — YouTube aujourd’hui, un lien Vimeo demain, un MP4 la semaine prochaine : react-player.
  4. Affichez de nombreuses vidéos YouTube, TikTok ou Instagram sous forme de galerie sur un site web : ce n’est pas vraiment un problème de lecteur, mais plutôt de contenu et de mise en page (voir la dernière section).

Les bibliothèques en un coup d’œil

 Video.jsPlyrreact-playerhls.jsMux Player
De quoi s’agit-il ?Framework complet de lecteurInterface de lecteur épuréeWrapper React pour de nombreuses sourcesMoteur de streaming HLS (sans interface)Lecteur pour les vidéos hébergées sur Mux
LicenceApache 2.0MITMITApache 2.0MIT
Fichiers vidéo HTML5OuiOuiOuiVia l’élément vidéoRessources Mux
YouTube / VimeoVia des pluginsIntégréIntégréNonNon
HLSIntégré (VHS)Avec hls.jsUtilise hls.js pour les fichiers .m3u8Oui — c’est son rôleOui
DASHIntégré (VHS)Avec une bibliothèque DASHVia un plugin de lecteur de fichiersNon—
Sous-titresOuiOuiDépend de la sourceVotre lecteur s’en chargeOui
Thèmes et apparenceThèmes CSS, thèmes et pluginsVariables CSSInterface native de la source—Variables CSS, thèmes
Compatible avec ReactVia un composant wrapperVia un wrapperLangue maternelleTous les frameworks@mux/mux-player-react
Idéal pourContrôle, plugins, streamingInterface par défaut rapide et épuréeURLs mixtes dans ReactHLS sur Chrome/Firefox/EdgeTeams sur Mux

Video.js

Video.js est le vétéran des lecteurs vidéo open source. Il intègre l’élément vidéo HTML5 dans une interface cohérente et personnalisable, et propose un système de plugins couvrant tous les besoins, des sélecteurs de qualité aux outils d’analyse et à la publicité. Son moteur de streaming intégré (VHS) prend en charge HLS et DASH : vous avez donc rarement besoin de bibliothèques supplémentaires pour le streaming adaptatif. La lecture HLS avec Video.js fonctionne immédiatement.

Installer et configurer

npm install video.js
import videojs from "video.js";
import "video.js/dist/video-js.css";

const player = videojs("my-video", {
  controls: true,
  fluid: true,
  sources: [{ src: "https://example.com/stream.m3u8", type: "application/x-mpegURL" }]
});
<video id="my-video" class="video-js" playsinline></video>

Video.js avec React

C’est la méthode standard pour utiliser Video.js avec React. Créez le lecteur dans un effet et détruisez-le au démontage du composant — sinon, les changements de route laissent des lecteurs actifs en mémoire.

import { useEffect, useRef } from "react";
import videojs from "video.js";
import "video.js/dist/video-js.css";

export function Player({ src }: { src: string }) {
  const ref = useRef<HTMLVideoElement>(null);
  useEffect(() => {
    const player = videojs(ref.current!, { controls: true, fluid: true, sources: [{ src }] });
    return () => player.dispose();
  }, [src]);
  return <video ref={ref} className="video-js" />;
}

Styles et thèmes

Video.js intègre un thème par défaut que vous pouvez personnaliser avec du CSS. Les thèmes officiels et communautaires, ainsi que les plugins pour ajouter des fonctionnalités comme des playlists ou des menus de qualité, vous permettent de modifier son apparence sans recréer les commandes. Pour un lecteur à l’image de votre marque, prévoyez du temps pour travailler le CSS : Video.js vous offre toute la flexibilité nécessaire, mais c’est à vous d’en peaufiner le rendu.

Quand choisir Video.js

  • Vous diffusez du contenu en HLS ou DASH et cherchez une seule bibliothèque compatible avec les deux formats.
  • Des extensions sont nécessaires pour les statistiques, la publicité, le changement de qualité et les playlists.
  • Vous cherchez un projet éprouvé, qui a fait ses preuves depuis longtemps et bénéficie d’une grande communauté.

Plyr

Le lecteur vidéo Plyr (souvent recherché sous le nom « Plyr JS ») se concentre sur l’essentiel : un lecteur élégant et accessible, prêt à l’emploi. Il prend en charge les vidéos et fichiers audio HTML5, ainsi que les vidéos intégrées depuis YouTube et Vimeo, le tout dans une interface unique. Grâce aux propriétés CSS personnalisées, vous pouvez l’accorder aux couleurs de votre marque en quelques minutes. Plyr ne diffuse pas les flux HLS seul : associez-le à hls.js pour cela.

Installer et configurer

npm install plyr
import Plyr from "plyr";
import "plyr/dist/plyr.css";

const player = new Plyr("#player", {
  controls: ["play-large", "play", "progress", "current-time", "mute", "volume", "captions", "fullscreen"]
});
<video id="player" playsinline controls poster="poster.jpg">
  <source src="clip.mp4" type="video/mp4">
</video>

<!-- or a YouTube video behind the same UI -->
<div id="player" data-plyr-provider="youtube" data-plyr-embed-id="VIDEO_ID"></div>

Plyr avec HLS

const video = document.querySelector("video");
const hls = new Hls();
hls.loadSource("https://example.com/stream.m3u8");
hls.attachMedia(video);
const player = new Plyr(video);

Quand choisir Plyr

  • Vous cherchez un lecteur épuré et moderne, facile à configurer et compatible avec les claviers et les lecteurs d’écran.
  • Vous combinez vos propres fichiers avec YouTube ou Vimeo et souhaitez une interface cohérente.
  • Vous n’avez pas besoin d’un vaste écosystème de plugins.

react-player

react-player (le package npm que beaucoup recherchent simplement sous le nom « react player ») est un composant React qui prend une URL en entrée et détermine comment la lire : fichier MP4, flux HLS, lien YouTube ou Vimeo, et plusieurs autres services. Il ne remplace pas le lecteur de chaque service : il l’intègre. En revanche, il vous offre une API React unique pour lancer la lecture, la mettre en pause, parcourir la vidéo et écouter les événements.

Installer et utiliser

npm install react-player
import ReactPlayer from "react-player";

export function Hero() {
  return (
    <ReactPlayer
      url="https://www.youtube.com/watch?v=VIDEO_ID"
      controls
      width="100%"
      height="100%"
    />
  );
}

Remarque : consultez la documentation correspondant à la version majeure que vous installez : dans les versions récentes, certains props ont été renommés. Le principe reste le même : un composant, plusieurs sources.

Quand choisir react-player

  • Votre application React lit des URL provenant de différents services.
  • Vous préférez une API déclarative rapide plutôt que de créer un lecteur.
  • L’interface du lecteur de chaque service dans le composant vous convient.

hls.js

hls.js est une bibliothèque JavaScript qui permet de lire des flux HLS (HTTP Live Streaming) dans les navigateurs qui ne les prennent pas en charge nativement, grâce aux Media Source Extensions. Elle ne possède pas d’interface utilisateur : associez-la à un élément <video> ou à un lecteur comme Plyr. Safari prend en charge HLS nativement ; hls.js est donc uniquement nécessaire pour Chrome, Firefox et Edge.

Installer et configurer

npm install hls.js
import Hls from "hls.js";

const video = document.querySelector("video");
const src = "https://example.com/stream.m3u8";

if (Hls.isSupported()) {
  const hls = new Hls();
  hls.loadSource(src);
  hls.attachMedia(video);
} else if (video.canPlayType("application/vnd.apple.mpegurl")) {
  video.src = src; // Safari plays HLS natively
}

Documentation et démo

Le projet hls.js publie une documentation API et une démo en direct de hls.js. Vous pouvez y coller l’URL d’un flux et examiner les niveaux de qualité, la mise en mémoire tampon et les erreurs : pratique pour déboguer un flux avant de créer quoi que ce soit autour.

Quand choisir hls.js

  • Vous avez des flux HLS et souhaitez qu’ils soient compatibles partout.
  • Vous avez déjà une interface utilisateur (ou utilisez Plyr) et vous avez seulement besoin du moteur de streaming.
  • Vous souhaitez contrôler précisément la mise en mémoire tampon et le changement de qualité.

Mux Player

Si vous hébergez vos vidéos sur Mux, Mux Player est tout indiqué : ce composant web (également disponible pour React) lit les flux Mux en qualité adaptative et transmet les données de visionnage aux outils d’analyse de Mux. Personnalisable, il gère aussi les sous-titres, les miniatures et la barre de progression. Il est moins adapté si vos vidéos sont hébergées ailleurs.

npm install @mux/mux-player-react
import MuxPlayer from "@mux/mux-player-react";

<MuxPlayer playbackId="YOUR_PLAYBACK_ID" metadata={{ video_title: "Product demo" }} />

HLS et DASH en deux paragraphes

HLS et DASH découpent une vidéo en courts segments de plusieurs niveaux de qualité, décrits dans un fichier manifeste (.m3u8 pour HLS, .mpd pour DASH). Le lecteur télécharge les segments un par un et choisit la qualité adaptée à la connexion de l’internaute : c’est le streaming adaptatif. Résultat : même les longues vidéos démarrent rapidement et ne se bloquent pas.

Si vous n’avez que de courts fichiers MP4, inutile de vous compliquer la vie : l’élément vidéo HTML5 les lit partout. Le streaming est utile pour les vidéos longues, les directs et les audiences nombreuses. Dans ces cas-là, la plupart des équipes font appel à une plateforme vidéo qui se charge de l’encodage des flux.

Performances : comment ne pas ralentir votre site

  • Chargez les lecteurs uniquement là où vous en avez besoin. Importez la bibliothèque sur les pages qui contiennent réellement des vidéos, idéalement de façon dynamique lorsque le lecteur entre dans le champ de vision.
  • Commencez par une image de couverture. Affichez une vignette légère et chargez le lecteur au clic — idéal si une page contient plusieurs vidéos.
  • Réservez l’espace. Définissez aspect-ratio sur le conteneur pour éviter que la page ne saute au chargement du lecteur (décalage cumulatif de la mise en page).
  • Utilisez preload="metadata" pour les fichiers afin que le navigateur ne télécharge pas toute la vidéo dès le départ.
  • Diffusez vos vidéos longues plutôt que de proposer un seul gros fichier MP4.

Checklist d’accessibilité

  • Sous-titres pour chaque vidéo parlée (pistes WebVTT).
  • Contrôle complet au clavier : lecture/pause, avance rapide, volume, plein écran.
  • États de focus visibles et boutons avec libellés pour les lecteurs d’écran.
  • Pas de lecture automatique avec le son ; respecte prefers-reduced-motion pour les vidéos d’arrière-plan.

Plyr et Video.js accordent tous deux une grande importance à l’accessibilité. Dans les deux cas, testez votre lecteur avec un clavier et un lecteur d’écran : les thèmes personnalisés peuvent compromettre l’accessibilité offerte par défaut.

Guide de décision

Si vous avez besoin de…Choisir
Un lecteur élégant par défaut pour MP4, YouTube et VimeoPlyr
Plugins, thèmes, hooks d’analyse, HLS et DASH intégrésVideo.js
Gérez plusieurs types d’URL dans une application React avec un minimum de codereact-player
HLS dans Chrome, Firefox et Edge avec votre propre interfacehls.js
Lecture et analyses des vidéos hébergées sur MuxMux Player
Une galerie de vidéos YouTube, TikTok, Instagram ou Vimeo à intégrer à une page marketingUn widget de galerie (voir ci-dessous)

Quand une bibliothèque est trop complexe

Les bibliothèques de lecteurs vous fournissent un lecteur. Mais si vous avez en réalité besoin d’une section vidéo — pour présenter votre chaîne YouTube, une playlist de tutoriels ou des témoignages clients publiés sur TikTok et Instagram — vous devrez quand même créer les mises en page de la galerie, récupérer les vidéos via l’API de chaque plateforme (avec des clés et des quotas), actualiser le flux et permettre à votre équipe de le gérer.

La galerie vidéo Elfsight s’occupe de tout : connectez YouTube, Vimeo, TikTok, Instagram Reels, Twitch ou n’importe quel lien vidéo, choisissez parmi sept mises en page et ajoutez-la à n’importe quel site web — ou à une application React grâce au composant officiel react-elfsight-widget. Vos nouvelles vidéos s’affichent automatiquement, s’ouvrent dans une fenêtre pop-up sur votre page, et vous pouvez ajouter une carte d’appel à l’action après chaque vidéo.

Créez votre galerie vidéo ici ↓

Découvrez son fonctionnement sur React et Next.js.

Questions fréquentes

Quel est le meilleur lecteur vidéo open source ?

Pour la plupart des sites web, choisissez Video.js (complet, avec des plugins et la prise en charge du streaming) ou Plyr (léger, avec une interface soignée). Optez pour Video.js si vous diffusez en HLS/DASH ou avez besoin de plugins, et pour Plyr si vous voulez une belle interface par défaut sans configuration complexe.

Video.js est-il gratuit ?

Oui. Video.js est un logiciel open source sous licence Apache 2.0.

Plyr peut-il lire des vidéos YouTube et Vimeo ?

Oui. Plyr prend en charge les vidéos intégrées depuis YouTube et Vimeo, ainsi que les vidéos et fichiers audio HTML5, le tout dans une interface unique.

Ai-je besoin de hls.js avec Video.js ?

En général, non. Video.js intègre son propre moteur de streaming (VHS) pour HLS et DASH.

Ai-je besoin de hls.js dans Safari ?

Non. Safari lit les flux HLS nativement. hls.js est destiné aux navigateurs qui ne prennent pas en charge HLS nativement.

react-player prend-il en charge HLS ?

Oui. Pour les URL .m3u8, il utilise hls.js en arrière-plan.

Quel est le meilleur lecteur vidéo pour React ?

react-player pour lire des URL provenant de différents services ; Video.js avec un wrapper React pour garder le contrôle et gérer le streaming ; Mux Player React si vos vidéos sont hébergées sur Mux.

Quelle est la différence entre un lecteur vidéo et un SDK ou une API de lecteur vidéo ?

Une bibliothèque de lecteur vidéo fournit l’interface et la lecture. Le SDK ou l’API d’une plateforme vidéo gère également le téléversement, l’encodage, le streaming et les statistiques. Si vous souhaitez uniquement lire des fichiers que vous hébergez déjà, une bibliothèque suffit.

Quel lecteur vidéo est le plus léger ?

Parmi les interfaces complètes de lecteur, Plyr est la plus légère. hls.js est encore plus léger, mais ce n’est qu’un moteur de streaming : il lui faut un élément vidéo ou un lecteur par-dessus.

Comment ajouter une galerie de vidéos YouTube à une application React sans bibliothèque de lecteur vidéo ?

Utilisez un widget : créez une galerie vidéo dans Elfsight, connectez votre chaîne ou votre playlist et affichez-la avec react-elfsight-widget. Sans clé API ni code de lecteur.
Article de
Lead marketing
Je suis Andrei Kozinskiy, Responsable Marketing chez Elfsight. Je pilote la croissance des utilisateurs via le contenu et divers canaux d’acquisition. J’aime partager des insights et des expériences pour aider les autres à réussir.