Lingua:

Video.js vs Plyr vs react-player vs hls.js: quale libreria per lettori video scegliere?

Video.js, Plyr, react-player, hls.js o Mux Player? Scopri cosa offre davvero ciascuna libreria, confronta configurazione e funzionalità e scegli quella giusta per il tuo sito o la tua app. Oppure fai a meno delle librerie.
Scopri cosa ne pensa ChatGPT

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.

Punti chiave



  • 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:

  1. Riproduci i tuoi file MP4 con un’interfaccia più curata rispetto a quella predefinita del browser, usando Plyr o Video.js.
  2. 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).
  3. Riproduci video da diversi servizi in un’app React — oggi YouTube, domani un link Vimeo, la prossima settimana un MP4: react-player.
  4. 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.jsPlyrreact-playerhls.jsMux Player
Cos’èStruttura completa del playerInterfaccia del player leggeraWrapper React per numerose fontiMotore di streaming HLS (senza interfaccia)Lettore per video ospitati su Mux
LicenzaApache 2.0MITMITApache 2.0MIT
File video HTML5SìSìSìCon l’elemento videoRisorse Mux
YouTube / VimeoTramite pluginIntegratoIntegratoNoNo
HLSIntegrato (VHS)Con hls.jsUsa hls.js per i file .m3u8Sì: il suo scopoSì
DASHIntegrato (VHS)Con una libreria DASHCon un plugin per lettore di fileNo—
SottotitoliSìSìDipende dalla fonteCi pensa il tuo playerSì
Aspetti e temiStili CSS, temi, pluginVariabili CSSInterfaccia utente originale—Variabili CSS, temi
Supporto per ReactTramite un componente wrapperTramite un wrapperNativoQualsiasi framework@mux/mux-player-react
Ideale perControllo, plugin, streamingInterfaccia predefinita rapida e pulitaURL misti in ReactHLS su Chrome/Firefox/EdgeTeam 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-ratio sul 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-motion per 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 VimeoPlyr
Plugin, skin, hook di analytics, HLS e DASH già inclusiVideo.js
Tanti tipi di URL in un’app React con poche righe di codicereact-player
HLS su Chrome, Firefox ed Edge con un’interfaccia personalizzatahls.js
Riproduzione e analisi dei video ospitati su MuxMux Player
Una galleria di video YouTube, TikTok, Instagram o Vimeo in una pagina marketingUn 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.

Domande frequenti

Qual è il miglior lettore video open source?

Per la maggior parte dei siti web, Video.js (completo di funzionalità, plugin e streaming) o Plyr (leggero e con un’interfaccia curata) sono le scelte migliori. Scegli Video.js se trasmetti contenuti in streaming HLS/DASH o hai bisogno di plugin; scegli Plyr se vuoi un ottimo aspetto predefinito e una configurazione minima.

Video.js è gratuito?

Sì. Video.js è open source e distribuito con licenza Apache 2.0.

Plyr può riprodurre video di YouTube e Vimeo?

Sì. Plyr supporta i video incorporati da YouTube e Vimeo, oltre ai video e all’audio HTML5, il tutto con la stessa interfaccia.

Mi serve hls.js con Video.js?

Di solito no. Video.js include un proprio motore di streaming (VHS) per HLS e DASH.

Mi serve hls.js su Safari?

No. Safari supporta HLS in modo nativo. hls.js serve per i browser che non supportano HLS in modo nativo.

react-player supporta HLS?

Sì. Per gli URL .m3u8 utilizza hls.js in background.

Qual è il miglior lettore video per React?

react-player per riprodurre URL da servizi diversi; Video.js con un wrapper React se ti serve il pieno controllo e lo streaming; Mux Player React se i tuoi video sono su Mux.

Qual è la differenza tra un lettore video e un SDK o un’API per lettori video?

Una libreria per il player offre l’interfaccia e le funzioni di riproduzione. L’SDK o l’API di una piattaforma video gestisce anche il caricamento, la codifica, lo streaming e le analisi. Se devi solo riprodurre file che ospiti già, è sufficiente una libreria.

Qual è il lettore video più leggero?

Tra le interfacce complete per i lettori video, Plyr è la più leggera. hls.js è ancora più compatta, ma è solo un motore di streaming e richiede un elemento video o un altro lettore.

Come posso aggiungere una galleria di video YouTube a un’app React senza usare una libreria per il player?

Usa un widget: crea una galleria video su Elfsight, collega il tuo canale o la tua playlist e integrala con react-elfsight-widget. Senza chiavi API né codice del player.
Articolo di
Responsabile Marketing
Sono Andrei Kozinskiy, Marketing Lead presso Elfsight. Mi occupo della crescita degli utenti attraverso contenuti e diversi canali di traffico. Amo condividere intuizioni ed esperienze per aiutare gli altri a avere successo.