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.
- 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 :
- Lisez vos propres fichiers MP4 avec une interface plus agréable que celle du navigateur par défaut — Plyr ou Video.js.
- 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).
- 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.
- 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.js | Plyr | react-player | hls.js | Mux Player | |
|---|---|---|---|---|---|
| De quoi s’agit-il ? | Framework complet de lecteur | Interface de lecteur épurée | Wrapper React pour de nombreuses sources | Moteur de streaming HLS (sans interface) | Lecteur pour les vidéos hébergées sur Mux |
| Licence | Apache 2.0 | MIT | MIT | Apache 2.0 | MIT |
| Fichiers vidéo HTML5 | Oui | Oui | Oui | Via l’élément vidéo | Ressources Mux |
| YouTube / Vimeo | Via des plugins | Intégré | Intégré | Non | Non |
| HLS | Intégré (VHS) | Avec hls.js | Utilise hls.js pour les fichiers .m3u8 | Oui — c’est son rôle | Oui |
| DASH | Intégré (VHS) | Avec une bibliothèque DASH | Via un plugin de lecteur de fichiers | Non | — |
| Sous-titres | Oui | Oui | Dépend de la source | Votre lecteur s’en charge | Oui |
| Thèmes et apparence | Thèmes CSS, thèmes et plugins | Variables CSS | Interface native de la source | — | Variables CSS, thèmes |
| Compatible avec React | Via un composant wrapper | Via un wrapper | Langue maternelle | Tous les frameworks | @mux/mux-player-react |
| Idéal pour | Contrôle, plugins, streaming | Interface par défaut rapide et épurée | URLs mixtes dans React | HLS sur Chrome/Firefox/Edge | Teams 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-ratiosur 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-motionpour 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 Vimeo | Plyr |
| Plugins, thèmes, hooks d’analyse, HLS et DASH intégrés | Video.js |
| Gérez plusieurs types d’URL dans une application React avec un minimum de code | react-player |
| HLS dans Chrome, Firefox et Edge avec votre propre interface | hls.js |
| Lecture et analyses des vidéos hébergées sur Mux | Mux Player |
| Une galerie de vidéos YouTube, TikTok, Instagram ou Vimeo à intégrer à une page marketing | Un 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.

