Ti serve un video sul tuo sito o nella tua app e ci sono quattro nomi che ricorrono sempre: Video.js, Plyr, react-player e hls.js. Se trasmetti in streaming con Mux, si aggiunge alla lista anche Mux Player. Sono tutti strumenti molto diffusi e open source, ma risolvono problemi diversi.
Questa guida spiega cosa sono davvero, mostra il codice minimo necessario per configurarli, li confronta fianco a fianco e ti aiuta a scegliere quello giusto — oppure a capire se puoi fare a meno di una libreria.
- Video.js è un framework completo per player, con un vasto ecosistema di plugin, skin e supporto integrato per la riproduzione HLS/DASH. È la scelta ideale se cerchi controllo e flessibilità.
- Plyr è un player leggero con un’interfaccia predefinita curata e accessibile, compatibile con video HTML5, YouTube e Vimeo. Ideale se vuoi un player accattivante in poco tempo.
- react-player è un componente React che riproduce diversi tipi di URL (file, YouTube, Vimeo e altro) tramite un’unica API. È ideale per le app React che utilizzano sorgenti diverse.
- hls.js non è un’interfaccia di riproduzione, ma un motore di streaming che consente di riprodurre contenuti HLS nei browser che non li supportano nativamente. Puoi abbinarlo al tag video o a un player.
- Mux Player è un lettore video progettato per i contenuti ospitati su Mux, con analytics integrati. La scelta ideale se usi Mux come piattaforma video.
- Se vuoi creare una galleria di video YouTube, TikTok o Instagram per le tue pagine di marketing, un widget già pronto è in genere più veloce di qualsiasi libreria.
Quale problema vuoi risolvere?
Prima di confrontare le funzionalità, definisci l’obiettivo. La maggior parte dei team rientra in una di queste quattro situazioni:
- Riproduci i tuoi file MP4 con un’interfaccia più curata rispetto a quella predefinita del browser, usando Plyr o Video.js.
- Trasmetti video lunghi o in diretta con qualità adattiva (HLS/DASH): usa Video.js, hls.js con un’interfaccia personalizzata oppure il player della tua piattaforma video (ad esempio Mux Player).
- Riproduci video da diversi servizi in un’app React — oggi YouTube, domani un link Vimeo, la prossima settimana un MP4: react-player.
- Mostrare molti video di YouTube, TikTok o Instagram in una galleria sul sito non è tanto una questione di lettore, quanto di contenuti e layout (vedi l’ultima sezione).
Le librerie a colpo d’occhio
| Video.js | Plyr | react-player | hls.js | Mux Player | |
|---|---|---|---|---|---|
| Cos’è | Struttura completa del player | Interfaccia del player leggera | Wrapper React per numerose fonti | Motore di streaming HLS (senza interfaccia) | Lettore per video ospitati su Mux |
| Licenza | Apache 2.0 | MIT | MIT | Apache 2.0 | MIT |
| File video HTML5 | Sì | Sì | Sì | Con l’elemento video | Risorse Mux |
| YouTube / Vimeo | Tramite plugin | Integrato | Integrato | No | No |
| HLS | Integrato (VHS) | Con hls.js | Usa hls.js per i file .m3u8 | Sì: il suo scopo | Sì |
| DASH | Integrato (VHS) | Con una libreria DASH | Con un plugin per lettore di file | No | — |
| Sottotitoli | Sì | Sì | Dipende dalla fonte | Ci pensa il tuo player | Sì |
| Aspetti e temi | Stili CSS, temi, plugin | Variabili CSS | Interfaccia utente originale | — | Variabili CSS, temi |
| Supporto per React | Tramite un componente wrapper | Tramite un wrapper | Nativo | Qualsiasi framework | @mux/mux-player-react |
| Ideale per | Controllo, plugin, streaming | Interfaccia predefinita rapida e pulita | URL misti in React | HLS su Chrome/Firefox/Edge | Team su Mux |
Video.js
Video.js è un veterano tra i lettori video open source. Integra l’elemento video HTML5 in un’interfaccia coerente e personalizzabile e offre un sistema di plugin che spazia dai selettori di qualità agli strumenti di analisi e agli annunci. Il motore di streaming integrato (VHS) supporta sia HLS che DASH, quindi raramente servono librerie aggiuntive per lo streaming adattivo: la riproduzione HLS con Video.js funziona subito.
Installa e configura
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 con React
Questo è il pattern standard di Video.js per React. Crea il player in un effetto e eliminalo quando il componente viene smontato: altrimenti, quando si cambia pagina, i player continuano a occupare memoria.
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" />;
}
Skin e temi
Video.js include uno stile predefinito che puoi personalizzare con i CSS. I temi ufficiali e quelli creati dalla community (oltre ai plugin per funzioni come playlist e menu della qualità) ti permettono di modificare l’aspetto senza ricreare i controlli. Se vuoi un player fortemente in linea con il tuo brand, metti in conto un po’ di lavoro sui CSS: Video.js ti offre tutti gli strumenti, ma la rifinitura sta a te.
Quando scegliere Video.js
- Trasmetti in HLS o DASH e vuoi un’unica libreria che supporti entrambi i formati.
- Ti servono plugin per analytics, pubblicità, cambio della qualità e playlist.
- Cerchi un progetto consolidato, con una lunga storia alle spalle e una community numerosa.
Plyr
Il lettore video Plyr (spesso cercato come “Plyr JS”) punta tutto su un player elegante e accessibile, pronto all’uso. Supporta video e audio HTML5, oltre ai contenuti incorporati da YouTube e Vimeo, tutti gestibili dalla stessa interfaccia. Inoltre, grazie alle proprietà CSS personalizzate, bastano pochi minuti per adattare i colori al tuo brand. Plyr non supporta lo streaming HLS in autonomia: per farlo, abbinalo a hls.js.
Installa e configura
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 con 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);
Quando scegliere Plyr
- Vuoi un lettore essenziale e moderno, compatibile con tastiera e screen reader e facile da configurare.
- Vuoi combinare i tuoi file con video di YouTube o Vimeo mantenendo un’interfaccia uniforme.
- Non ti serve un ecosistema di plugin complesso.
react-player
react-player (il pacchetto npm che molti cercano semplicemente come «react player») è un componente React che accetta un URL e determina come riprodurlo: un file MP4, uno stream HLS, un link YouTube o Vimeo e diversi altri servizi. Non sostituisce il player di ciascun servizio, ma lo incorpora e ti offre un’unica API React per riprodurre, mettere in pausa, spostarti nel video e ascoltare gli eventi.
Installa e usa
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%"
/>
);
}
Nota: consulta la documentazione relativa alla versione principale che installi: nelle versioni più recenti alcune props hanno cambiato nome. Il principio resta lo stesso: un solo componente, tante fonti.
Quando scegliere react-player
- La tua app React riproduce URL da diversi servizi.
- Cerchi un’API dichiarativa e rapida, invece di creare un player da zero.
- Ti va bene usare l’interfaccia del player di ciascun servizio nel componente.
hls.js
hls.js è una libreria JavaScript che consente di riprodurre contenuti HLS (HTTP Live Streaming) nei browser che non li supportano nativamente, tramite Media Source Extensions. Non dispone di un’interfaccia utente: si collega a un elemento <video> o a un player come Plyr. Safari supporta HLS nativamente, quindi hls.js serve solo per Chrome, Firefox ed Edge.
Installa e configura
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
}
Documentazione e demo
Il progetto hls.js mette a disposizione la documentazione API e una demo interattiva di hls.js: puoi incollare l’URL di uno stream e controllarne i livelli di qualità, il buffering e gli errori. È utile per eseguire il debug dello stream prima di sviluppare qualsiasi altra funzionalità.
Quando scegliere hls.js
- Hai flussi HLS e vuoi riprodurli ovunque.
- Hai già un’interfaccia utente (o usi Plyr) e ti serve solo il motore di streaming.
- Vuoi controllare con precisione il buffering e il passaggio da una qualità video all’altra.
Mux Player
Se ospiti i video su Mux, Mux Player è la scelta più naturale: un componente web (con una versione per React) che riproduce gli streaming di Mux con qualità adattiva e invia i dati di visualizzazione agli strumenti di analisi di Mux. Puoi personalizzarne il tema e gestisce per te sottotitoli, miniature e timeline. È meno utile se i tuoi video sono ospitati altrove.
npm install @mux/mux-player-react
import MuxPlayer from "@mux/mux-player-react";
<MuxPlayer playbackId="YOUR_PLAYBACK_ID" metadata={{ video_title: "Product demo" }} />
HLS e DASH in due paragrafi
HLS e DASH suddividono un video in brevi segmenti con diversi livelli di qualità e li descrivono in un file manifest (.m3u8 per HLS, .mpd per DASH). Il player scarica i segmenti uno alla volta e seleziona la qualità più adatta alla connessione dello spettatore: è lo streaming adattivo, che permette ai video lunghi di avviarsi rapidamente e di non interrompersi.
Se hai solo brevi file MP4, non ti serve niente di tutto questo: l’elemento video HTML5 li riproduce ovunque. Lo streaming è importante per i video lunghi, le dirette e il pubblico numeroso. In questi casi, la maggior parte dei team si affida a una piattaforma video che codifica i flussi al posto loro.
Prestazioni: come evitare di rallentare il sito
- Carica i player solo dove servono. Importa la libreria nelle pagine che contengono video, idealmente con un’importazione dinamica quando il player entra nell’area visibile.
- Inizia con un’immagine di anteprima. Mostra una miniatura leggera e crea il player solo al clic: è particolarmente utile quando la pagina contiene più video.
- Riserva lo spazio. Imposta
aspect-ratiosul contenitore per evitare che la pagina salti quando si carica il player (Cumulative Layout Shift). - Usa
preload="metadata"per evitare che il browser scarichi l’intero video in anticipo. - Riproduci video lunghi in streaming invece di caricare un unico file MP4 di grandi dimensioni.
Checklist per l’accessibilità
- Sottotitoli per ogni video parlato (tracce WebVTT).
- Controllo completo da tastiera: riproduci/metti in pausa, scorri, regola il volume e attiva lo schermo intero.
- Indicatori di messa a fuoco ben visibili e pulsanti con etichette accessibili agli screen reader.
- Nessuna riproduzione automatica con audio; rispetta
prefers-reduced-motionper i video di sfondo.
Plyr e Video.js prestano entrambi molta attenzione all’accessibilità, ma in ogni caso verifica il funzionamento con una tastiera e uno screen reader: le skin personalizzate possono compromettere ciò che funziona con quelle predefinite.
Guida alle decisioni
| Se hai bisogno… | Scegli |
|---|---|
| Un lettore predefinito curato per MP4, YouTube e Vimeo | Plyr |
| Plugin, skin, hook di analytics, HLS e DASH già inclusi | Video.js |
| Tanti tipi di URL in un’app React con poche righe di codice | react-player |
| HLS su Chrome, Firefox ed Edge con un’interfaccia personalizzata | hls.js |
| Riproduzione e analisi dei video ospitati su Mux | Mux Player |
| Una galleria di video YouTube, TikTok, Instagram o Vimeo in una pagina marketing | Un widget galleria (vedi sotto) |
Quando una libreria è eccessiva
Le librerie per i player ti forniscono un player. Se invece ti serve una sezione video — con il tuo canale YouTube, una playlist di tutorial o le testimonianze dei clienti da TikTok e Instagram — dovrai comunque creare i layout della galleria, recuperare i video tramite le API di ogni piattaforma (con relative chiavi e quote), mantenere il feed aggiornato e offrire al tuo team un modo per gestirlo.
La Galleria video di Elfsight si occupa di tutto: collega YouTube, Vimeo, TikTok, Instagram Reels, Twitch o qualsiasi link video, scegli uno dei sette layout e aggiungila al tuo sito o a un’app React con il componente ufficiale react-elfsight-widget. I nuovi video vengono aggiunti automaticamente, si aprono in una finestra popup sulla tua pagina e, dopo ciascun video, puoi mostrare una scheda con un invito all’azione.
Crea qui la tua galleria video ↓
Scopri come funziona con React e Next.js.

