Du möchtest Videos auf deiner Website oder in deiner App einbinden? Vier Namen begegnen dir dabei immer wieder: Video.js, Plyr, react-player und hls.js – und Mux Player, wenn du über Mux streamst. Sie sind alle beliebt, Open Source und lösen unterschiedliche Probleme.
In diesem Leitfaden erfährst du, was hinter den einzelnen Optionen steckt. Du findest den Code für die minimale Einrichtung, kannst die Lösungen direkt miteinander vergleichen und herausfinden, welche am besten zu dir passt – oder ob du überhaupt eine Bibliothek brauchst.
- Video.js – ein umfassendes Player-Framework mit einem großen Plugin-Ökosystem, verschiedenen Designs und integrierter HLS-/DASH-Wiedergabe. Ideal, wenn Sie Kontrolle und Erweiterbarkeit benötigen.
- Plyr ist ein schlanker Player mit einer eleganten, barrierefreien Standardoberfläche für HTML5-Videos, YouTube und Vimeo. Ideal, wenn Sie schnell einen ansprechenden Player einbinden möchten.
- react-player – eine React-Komponente, die über eine einzige API zahlreiche URL-Typen abspielt (Dateien, YouTube, Vimeo und mehr). Ideal für React-Apps mit unterschiedlichen Quellen.
- hls.js ist keine Player-Oberfläche, sondern eine Streaming-Engine, die HLS-Wiedergabe in Browsern ohne native Unterstützung ermöglicht. Kombiniere sie mit dem Video-Tag oder einem Player.
- Mux Player – ein Player für Videos, die auf Mux gehostet werden, mit integrierten Analytics. Ideal, wenn Mux Ihre Videoplattform ist.
- Wenn du Marketingseiten mit einer Galerie aus YouTube-, TikTok- oder Instagram-Videos gestalten möchtest, bist du mit einem fertigen Widget meist schneller als mit einer Bibliothek.
Welches Problem lösen Sie?
Bevor Sie Funktionen vergleichen, sollten Sie sich über den konkreten Bedarf im Klaren sein. Die meisten Teams lassen sich einer von vier Situationen zuordnen:
- Spiele deine eigenen MP4-Dateien mit einer ansprechenderen Oberfläche ab als im Browser standardmäßig — mit Plyr oder Video.js.
- Lange Videos oder Livestreams mit adaptiver Qualität (HLS/DASH) übertragen – mit Video.js, hls.js plus eigener Benutzeroberfläche oder dem Player deiner Videoplattform (z. B. Mux Player).
- Spiele URLs von zahlreichen Diensten in einer React-App ab – heute YouTube, morgen ein Vimeo-Link, nächste Woche eine MP4-Datei – mit react-player.
- Viele Videos von YouTube, TikTok oder Instagram als Galerie auf einer Website präsentieren – das ist weniger eine Frage des Players als vielmehr eine Frage der Inhalte und des Layouts (siehe letzter Abschnitt).
Die Bibliotheken im Überblick
| Video.js | Plyr | react-player | hls.js | Mux Player | |
|---|---|---|---|---|---|
| Was es ist | Vollständiges Player-Framework | Schlanke Player-Oberfläche | React-Wrapper für zahlreiche Quellen | HLS-Streaming-Engine (ohne Benutzeroberfläche) | Player für bei Mux gehostete Videos |
| Lizenz | Apache 2.0 | MIT | MIT | Apache 2.0 | MIT |
| HTML5-Videodateien | Ja | Ja | Ja | Über das Videoelement | Mux-Assets |
| YouTube / Vimeo | Über Plugins | Integriert | Integriert | Nein | Nein |
| HLS | Integriert (VHS) | Mit hls.js | Verwendet hls.js für .m3u8 | Ja – das ist der Zweck | Ja |
| DASH | Integriert (VHS) | Mit einer DASH-Bibliothek | Über ein Plugin zur Dateiwiedergabe | Nein | — |
| Untertitel | Ja | Ja | Hängt von der Quelle ab | Dein Player übernimmt das | Ja |
| Designs / Gestaltung | CSS-Skins, Themes und Plugins | CSS-Variablen | Quelleneigene Benutzeroberfläche | — | CSS-Variablen, Themes |
| React-Unterstützung | Über eine Wrapper-Komponente | Über einen Wrapper | Muttersprache | Jedes Framework | @mux/mux-player-react |
| Ideal für | Steuerung, Plugins, Streaming | Schnelle, aufgeräumte Standardoberfläche | Gemischte URLs in React | HLS in Chrome/Firefox/Edge | Teams auf Mux |
Video.js
Video.js ist ein Urgestein unter den Open-Source-Videoplayern. Es bindet das HTML5-Videoelement in eine einheitliche, anpassbare Benutzeroberfläche ein und bietet ein Plugin-System mit Funktionen von Qualitätsauswahl bis hin zu Analytics und Werbung. Die integrierte Streaming-Engine (VHS) unterstützt HLS und DASH. Für adaptives Streaming benötigen Sie daher nur selten zusätzliche Bibliotheken – die HLS-Wiedergabe mit Video.js funktioniert direkt nach der Installation.
Installieren und einrichten
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 mit React
Das ist das Standardmuster für Video.js in React. Erstelle den Player in einem Effect und rufe beim Unmount dispose auf – andernfalls laufen Player bei Routenwechseln im Speicher weiter.
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" />;
}
Designs und Themes
Video.js wird mit einem Standard-Design ausgeliefert, das du per CSS anpassen kannst. Offizielle und von der Community entwickelte Themes sowie Plugins, etwa für Playlists oder Qualitätsmenüs, ändern das Aussehen, ohne dass du die Steuerelemente neu erstellen musst. Wenn du einen Player mit starkem Markenauftritt brauchst, solltest du Zeit für die CSS-Anpassung einplanen – Video.js bietet dir alle nötigen Möglichkeiten, den Feinschliff übernimmst du.
Wann du Video.js wählen solltest
- Du streamst in HLS oder DASH und suchst eine Bibliothek, die beides unterstützt.
- Du brauchst Plugins für Analytics, Werbung, Qualitätsumschaltung und Wiedergabelisten.
- Du suchst ein ausgereiftes Projekt mit langjähriger Erfahrung und einer großen Community.
Plyr
Der Plyr-Videoplayer (oft unter „Plyr JS“ gesucht) konzentriert sich auf das Wesentliche: einen ansprechenden, barrierefreien Player, der sofort einsatzbereit ist. Er unterstützt HTML5-Video und -Audio sowie YouTube- und Vimeo-Einbettungen in einer einheitlichen Benutzeroberfläche. Dank CSS Custom Properties passt du die Farben in wenigen Minuten an deine Marke an. HLS-Streams unterstützt Plyr nicht von Haus aus – verwende dafür hls.js.
Installieren und einrichten
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 mit 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);
Wann du Plyr wählen solltest
- Sie möchten einen übersichtlichen, modernen Player, der Tastatur und Screenreader optimal unterstützt und sich mit wenig Aufwand einrichten lässt.
- Du kombinierst eigene Dateien mit Videos von YouTube oder Vimeo und möchtest ein einheitliches Design.
- Sie brauchen kein umfangreiches Plugin-Ökosystem.
react-player
react-player (das npm-Paket, nach dem viele einfach als „react player“ suchen) ist eine React-Komponente, die eine URL entgegennimmt und automatisch erkennt, wie sie abgespielt werden kann: als MP4-Datei, HLS-Stream, YouTube- oder Vimeo-Link und über verschiedene weitere Dienste. Sie ersetzt nicht die Player der einzelnen Dienste, sondern bindet sie ein. Dafür bietet sie eine einheitliche React-API zum Abspielen, Pausieren, Spulen und Abonnieren von Ereignissen.
Installieren und verwenden
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%"
/>
);
}
Hinweis: Beachte die Dokumentation der Hauptversion, die du installierst – in neueren Versionen wurden einige Props umbenannt. Das Prinzip bleibt gleich: eine Komponente, viele Quellen.
Wann sollte man react-player wählen?
- Deine React-App spielt URLs von verschiedenen Diensten ab.
- Du möchtest eine schnelle, deklarative API, statt selbst einen Player zu entwickeln.
- Es ist für Sie in Ordnung, wenn jeder Dienst im Widget seine eigene Player-Oberfläche verwendet.
hls.js
hls.js ist eine JavaScript-Bibliothek, die HLS (HTTP Live Streaming) mithilfe von Media Source Extensions in Browsern abspielt, die HLS nicht nativ unterstützen. Sie verfügt über keine eigene Benutzeroberfläche – du bindest sie in ein <video>-Element oder einen Player wie Plyr ein. Safari unterstützt HLS nativ. hls.js benötigst du daher nur für Chrome, Firefox und Edge.
Installieren und einrichten
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
}
Dokumentation und Demo
Das hls.js-Projekt bietet eine API-Dokumentation und eine interaktive Demo-Seite. Dort können Sie eine Stream-URL einfügen und Qualität, Pufferung und Fehler prüfen – ideal, um einen Stream zu debuggen, bevor Sie etwas darauf aufbauen.
Wann hls.js wählen
- Sie nutzen HLS-Streams und möchten, dass diese überall abgespielt werden.
- Sie haben bereits eine Benutzeroberfläche (oder verwenden Plyr) und benötigen nur die Streaming-Engine.
- Du möchtest die Pufferung und den Qualitätswechsel genau steuern.
Mux Player
Wenn du deine Videos auf Mux hostest, ist der Mux Player die naheliegende Wahl: eine Webkomponente (auch als React-Version verfügbar), die Mux-Streams in adaptiver Qualität wiedergibt und Wiedergabedaten an die Mux-Analytics übermittelt. Das Design lässt sich anpassen, und Untertitel, Vorschaubilder und Zeitleisten werden automatisch verwaltet. Für Videos, die anderswo gehostet werden, eignet sich der Player weniger.
npm install @mux/mux-player-react
import MuxPlayer from "@mux/mux-player-react";
<MuxPlayer playbackId="YOUR_PLAYBACK_ID" metadata={{ video_title: "Product demo" }} />
HLS und DASH in zwei Absätzen
HLS und DASH teilen Videos in kurze Segmente mit unterschiedlichen Qualitätsstufen auf und beschreiben diese in einer Manifestdatei (.m3u8 für HLS, .mpd für DASH). Der Player lädt die Segmente nacheinander herunter und wählt die Qualität passend zur Internetverbindung der Zuschauer:innen aus. Dieses adaptive Streaming sorgt dafür, dass lange Videos schnell starten und nicht ins Stocken geraten.
Wenn du nur kurze MP4-Dateien hast, brauchst du das alles nicht: Das HTML5-Videoelement spielt sie überall ab. Streaming ist bei langen Videos, Livestreams und einem großen Publikum wichtig. In solchen Fällen nutzen die meisten Teams eine Videoplattform, die die Streams für sie codiert.
Performance: So wird deine Website nicht langsamer
- Lade den Player nur dort, wo du ihn brauchst. Binde die Bibliothek nur auf Seiten mit Videos ein – idealerweise dynamisch, sobald der Player in den sichtbaren Bereich scrollt.
- Beginne mit einem Vorschaubild. Zeige ein ressourcenschonendes Thumbnail und lade den Player erst beim Klick – besonders sinnvoll, wenn eine Seite mehrere Videos enthält.
- Platz freihalten. Lege für den Container ein
aspect-ratiofest, damit die Seite beim Laden des Players nicht springt (Cumulative Layout Shift). - Verwende für Dateien
preload="metadata", damit der Browser nicht sofort das gesamte Video herunterlädt. - Lange Videos streamen statt eine einzige große MP4-Datei bereitzustellen.
Checkliste zur Barrierefreiheit
- Untertitel für jedes gesprochene Video (WebVTT-Spuren).
- Vollständige Tastatursteuerung: Wiedergabe/Pause, Spulen, Lautstärke und Vollbild.
- Sichtbare Fokusmarkierungen und beschriftete Schaltflächen für Screenreader.
- Kein automatischer Start mit Ton; berücksichtigen Sie bei Hintergrundvideos die Einstellung
prefers-reduced-motion.
Plyr und Video.js legen beide großen Wert auf Barrierefreiheit. Teste die Player trotzdem mit Tastatur und Screenreader – benutzerdefinierte Designs können Funktionen beeinträchtigen, die in der Standardversion einwandfrei funktionieren.
Entscheidungshilfe
| Wenn Sie … benötigen | Auswählen |
|---|---|
| Ein eleganter Standard-Player für MP4, YouTube und Vimeo | Plyr |
| Plugins, Skins, Analytics-Hooks, HLS und DASH direkt integriert | Video.js |
| Viele URL-Typen in einer React-App mit minimalem Code | react-player |
| HLS in Chrome, Firefox und Edge mit eigener Benutzeroberfläche | hls.js |
| Wiedergabe und Analysen für auf Mux gehostete Videos | Mux Player |
| Eine Galerie mit YouTube-, TikTok-, Instagram- oder Vimeo-Videos für eine Marketingseite | Ein Galerie-Widget (siehe unten) |
Wenn eine Bibliothek zu viel des Guten ist
Player-Bibliotheken liefern dir einen Player. Wenn du aber eigentlich einen Videobereich brauchst – für deinen YouTube-Kanal, eine Playlist mit Tutorials oder Kundenstimmen von TikTok und Instagram –, musst du trotzdem die Galerie-Layouts erstellen, Videos über die APIs der einzelnen Plattformen abrufen (inklusive API-Schlüsseln und Kontingenten), den Feed aktuell halten und deinem Team eine Möglichkeit zur Verwaltung bieten.
Die Elfsight-Videogalerie nimmt dir diese Arbeit ab: Verbinde YouTube, Vimeo, TikTok, Instagram Reels, Twitch oder einen beliebigen Videolink, wähle eines von sieben Layouts und füge die Galerie in jede Website ein – oder mit der offiziellen Komponente react-elfsight-widget in eine React-App. Neue Videos werden automatisch angezeigt, Videos öffnen sich in einem Popup auf deiner Seite und nach jedem Video kannst du eine Karte mit Call-to-Action einblenden.
Erstellen Sie Ihre Videogalerie direkt hier ↓
So funktioniert es mit React und Next.js.

