Necesitas añadir vídeo a tu sitio web o aplicación, y hay cuatro nombres que aparecen una y otra vez: Video.js, Plyr, react-player y hls.js. Si transmites desde Mux, también se suma Mux Player. Todos son populares y de código abierto, pero cada uno resuelve problemas diferentes.
Esta guía explica en qué consiste cada opción, muestra el código mínimo para configurarla, las compara y te ayuda a elegir la más adecuada o a decidir si realmente necesitas una biblioteca.
- Video.js: un framework completo para reproductores, con un amplio ecosistema de plugins, skins y reproducción HLS/DASH integrada. Ideal si necesitas control y flexibilidad.
- Plyr: un reproductor ligero con una interfaz predeterminada accesible y cuidada para vídeos HTML5, YouTube y Vimeo. Ideal si quieres un reproductor atractivo en poco tiempo.
- react-player: un componente de React que reproduce muchos tipos de URL (archivos, YouTube, Vimeo y más) con una sola API. Ideal para aplicaciones de React con distintas fuentes.
- hls.js no es una interfaz de reproductor, sino un motor de streaming que permite reproducir HLS en navegadores sin compatibilidad nativa. Combínalo con la etiqueta de video o con un reproductor.
- Mux Player: un reproductor para vídeos alojados en Mux, con analíticas integradas. Ideal si Mux es tu plataforma de vídeo.
- Si buscas mostrar videos de YouTube, TikTok o Instagram en las páginas de marketing de tu sitio, un widget listo para usar suele ser más rápido que cualquier biblioteca.
¿Qué problema estás resolviendo?
Antes de comparar funciones, define qué necesitas. La mayoría de los equipos se encuentra en una de estas cuatro situaciones:
- Reproduce tus propios archivos MP4 con una interfaz más atractiva que la predeterminada del navegador: Plyr o Video.js.
- Transmite vídeos largos o en directo con calidad adaptativa (HLS/DASH): usa Video.js, hls.js con tu propia interfaz o el reproductor de tu plataforma de vídeo (por ejemplo, Mux Player).
- Reproduce URL de distintos servicios en una app de React: YouTube hoy, un enlace de Vimeo mañana, un MP4 la semana que viene… con react-player.
- Mostrar muchos videos de YouTube, TikTok o Instagram en una galería dentro de un sitio web no es realmente un problema del reproductor, sino del contenido y el diseño (consulta la última sección).
Las bibliotecas de un vistazo
| Video.js | Plyr | react-player | hls.js | Mux Player | |
|---|---|---|---|---|---|
| Qué es | Estructura completa del reproductor | Interfaz ligera del reproductor | Integración de React para múltiples fuentes | Motor de streaming HLS (sin interfaz de usuario) | Reproductor para vídeos alojados en Mux |
| Licencia | Apache 2.0 | MIT | MIT | Apache 2.0 | MIT |
| Archivos de video HTML5 | Sí | Sí | Sí | Mediante el elemento de vídeo | Recursos de Mux |
| YouTube / Vimeo | Mediante plugins | Integrado | Integrado | No | No |
| HLS | Incluido (VHS) | Con hls.js | Usa hls.js para .m3u8 | Sí: ese es su propósito | Sí |
| DASH | Incluido (VHS) | Con una biblioteca DASH | Mediante un plugin de reproducción de archivos | No | — |
| Subtítulos | Sí | Sí | Depende de la fuente | Tu reproductor se encarga de todo | Sí |
| Diseño y temas | Temas, estilos CSS y plugins | Variables CSS | Interfaz propia de Source | — | Variables CSS, temas |
| Compatibilidad con React | Mediante un componente envolvente | Mediante un wrapper | Nativo | Cualquier framework | @mux/mux-player-react |
| Ideal para | Control, plugins, streaming | Interfaz predeterminada rápida y limpia | URL mixtas en React | HLS en Chrome/Firefox/Edge | Teams en Mux |
Video.js
Video.js es uno de los reproductores de vídeo de código abierto con más trayectoria. Envuelve el elemento de vídeo HTML5 en una interfaz uniforme y personalizable, y añade un sistema de complementos que abarca desde selectores de calidad hasta analíticas y anuncios. Su motor de streaming integrado (VHS) reproduce HLS y DASH, así que rara vez necesitas bibliotecas adicionales para el streaming adaptativo: la reproducción de HLS con Video.js funciona desde el primer momento.
Instalar y configurar
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
Este es el patrón habitual de Video.js en React. Crea el reproductor dentro de un efecto y destrúyelo al desmontar el componente; de lo contrario, los cambios de ruta dejarán reproductores en ejecución y ocupando 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" />;
}
Estilos y temas
Video.js incluye un tema predeterminado que puedes personalizar con CSS. Los temas oficiales y de la comunidad, junto con plugins para funciones como listas de reproducción o menús de calidad, te permiten cambiar el aspecto sin tener que crear los controles de nuevo. Si quieres un reproductor con una identidad de marca bien definida, reserva tiempo para trabajar con CSS: Video.js te ofrece todas las herramientas, pero el acabado depende de ti.
Cuándo elegir Video.js
- Transmites en HLS o DASH y buscas una sola biblioteca que admita ambos formatos.
- Necesitas plugins para analíticas, anuncios, cambiar la calidad y crear listas de reproducción.
- Buscas un proyecto consolidado, con una larga trayectoria y una gran comunidad.
Plyr
El reproductor de vídeo Plyr (a menudo buscado como «Plyr JS») se centra en una sola cosa: ofrecer un reproductor atractivo y accesible, listo para usar. Es compatible con vídeo y audio HTML5, además de vídeos insertados de YouTube y Vimeo, todo con la misma interfaz. Su estilo se personaliza mediante propiedades CSS, así que adaptar los colores a tu marca solo te llevará unos minutos. Plyr no transmite contenido HLS por sí solo: para ello, combínalo con hls.js.
Instalar y configurar
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);
Cuándo elegir Plyr
- Buscas un reproductor moderno y sencillo, compatible con teclados y lectores de pantalla, que requiera poca configuración.
- Combina tus propios archivos con YouTube o Vimeo y consigue una interfaz coherente.
- No necesitas un gran ecosistema de plugins.
react-player
react-player (el paquete npm que muchas personas buscan simplemente como «react player») es un componente de React que acepta una URL y determina cómo reproducir su contenido: un archivo MP4, una transmisión HLS, un enlace de YouTube o Vimeo y otros servicios. No reemplaza el reproductor de cada servicio, sino que lo integra. Así, ofrece una API de React uniforme para reproducir, pausar, avanzar y escuchar eventos.
Instalar y usar
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 documentación de la versión principal que instales; en las versiones recientes se han cambiado algunos nombres de propiedades. La idea sigue siendo la misma: un componente, muchas fuentes.
Cuándo elegir react-player
- Tu aplicación de React reproduce URL de distintos servicios.
- Buscas una API rápida y declarativa, en lugar de crear un reproductor desde cero.
- Te parece bien que cada servicio muestre su propia interfaz de reproductor dentro del componente.
hls.js
hls.js es una biblioteca de JavaScript que reproduce HLS (HTTP Live Streaming) en navegadores que no son compatibles de forma nativa, mediante Media Source Extensions. No tiene interfaz de usuario: se conecta a un elemento <video> o a un reproductor como Plyr. Safari reproduce HLS de forma nativa, así que solo necesitas hls.js para Chrome, Firefox y Edge.
Instalar y configurar
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
}
Documentación y demo
El proyecto hls.js ofrece documentación de la API y una página de demostración en vivo donde puedes pegar la URL de una transmisión y consultar los niveles de calidad, el almacenamiento en búfer y los errores. Es muy útil para depurar una transmisión antes de crear nada a su alrededor.
Cuándo elegir hls.js
- Tienes streams HLS y quieres que se reproduzcan en todas partes.
- Ya tienes una interfaz de usuario (o usas Plyr) y solo necesitas el motor de streaming.
- Quieres tener un control preciso sobre el almacenamiento en búfer y el cambio de calidad.
Mux Player
Si alojas tus videos en Mux, Mux Player es la opción ideal: un componente web (con una versión para React) que reproduce transmisiones de Mux con calidad adaptable y envía datos de visualización a las analíticas de Mux. Puedes personalizar su tema y gestionar los subtítulos, las miniaturas y la línea de tiempo fácilmente. Es menos útil si alojas tus videos en otra plataforma.
npm install @mux/mux-player-react
import MuxPlayer from "@mux/mux-player-react";
<MuxPlayer playbackId="YOUR_PLAYBACK_ID" metadata={{ video_title: "Product demo" }} />
HLS y DASH en dos párrafos
HLS y DASH dividen el video en segmentos cortos con distintos niveles de calidad y los describen en un archivo de manifiesto (.m3u8 para HLS y .mpd para DASH). El reproductor descarga los segmentos uno por uno y elige la calidad que mejor se adapta a la conexión de cada usuario. Así funciona la transmisión adaptativa: los videos largos empiezan a reproducirse rápido y no se quedan cargando.
Si solo tienes archivos MP4 cortos, no necesitas nada de esto: el elemento de video HTML5 los reproduce en cualquier lugar. El streaming es importante para videos largos, transmisiones en vivo y audiencias numerosas. En esos casos, la mayoría de los equipos utiliza una plataforma de video que codifica las transmisiones por ellos.
Rendimiento: cómo evitar que tu sitio web se ralentice
- Carga los reproductores solo cuando los necesites. Importa la biblioteca únicamente en las páginas que tengan vídeo; lo ideal es usar una importación dinámica cuando el reproductor aparezca en pantalla.
- Empieza con una imagen de portada. Muestra una miniatura ligera y crea el reproductor al hacer clic, especialmente si la página tiene varios videos.
- Reserva espacio. Define
aspect-ratioen el contenedor para evitar que la página dé saltos al cargar el reproductor (desplazamiento acumulado del diseño). - Usa
preload="metadata"en los archivos para que el navegador no descargue el video completo de antemano. - Transmite videos largos en lugar de ofrecer un único archivo MP4 grande.
Lista de verificación de accesibilidad
- Subtítulos para cada vídeo hablado (pistas WebVTT).
- Control total con el teclado: reproducir/pausar, avanzar, ajustar el volumen y activar la pantalla completa.
- Estados de foco visibles y botones con etiquetas para lectores de pantalla.
- No reproduzcas automáticamente con sonido y respeta
prefers-reduced-motionen los vídeos de fondo.
Tanto Plyr como Video.js se toman muy en serio la accesibilidad. Aun así, prueba el reproductor con el teclado y un lector de pantalla: los diseños personalizados pueden afectar funciones que sí funcionan con la configuración predeterminada.
Guía para elegir
| Si necesitas… | Elegir |
|---|---|
| Un reproductor predeterminado y elegante para MP4, YouTube y Vimeo | Plyr |
| Plugins, skins, analíticas, HLS y DASH incluidos de serie | Video.js |
| Muchos tipos de URL en una app de React con muy poco código | react-player |
| HLS en Chrome, Firefox y Edge con tu propia interfaz | hls.js |
| Reproducción y analíticas para vídeos alojados en Mux | Mux Player |
| Una galería de videos de YouTube, TikTok, Instagram o Vimeo para tu página de marketing | Un widget de galería (ver abajo) |
Cuando una biblioteca es innecesaria
Las bibliotecas de reproductores te dan un reproductor. Pero si lo que necesitas es una sección de videos —con tu canal de YouTube, una lista de tutoriales o testimonios de clientes de TikTok e Instagram—, aún tendrías que diseñar las galerías, obtener los videos de la API de cada plataforma (con sus claves y límites de uso), mantener el feed actualizado y ofrecer a tu equipo una forma de gestionarlo.
Galería de Videos de Elfsight se encarga de todo eso por ti: conecta YouTube, Vimeo, TikTok, Instagram Reels, Twitch o cualquier enlace de video, elige uno de los siete diseños y añádela a cualquier sitio web o a una aplicación de React con el componente oficial react-elfsight-widget. Los videos nuevos aparecen automáticamente, se abren en una ventana emergente en tu página y puedes mostrar una tarjeta con una llamada a la acción después de cada video.
Crea tu galería de videos aquí ↓
Descubre cómo funciona con React y Next.js.

