Skip to main content
The Livepeer Player is a React component (and an embeddable player at lvpr.tv) for playing streams and assets. It supports WebRTC (low latency) and HLS/MP4 fallback, and reports viewership metrics when used with the Studio API.

​
React Player

From @livepeer/react, use Player.Root, Player.Video, Player.Controls, and other primitives. Pass a src (from getSrc(playbackInfo) from the Playback Info API) or a playbackId (with a provider). The Player prefers WebRTC for live and MP4 for short VOD; it falls back to HLS on errors or when WebRTC isn’t available (e.g. B-frames in stream).

​
Embeddable player (iframe)

<iframe
  src="https://lvpr.tv?v=PLAYBACK_ID"
  allowfullscreen
  allow="autoplay; encrypted-media; fullscreen; picture-in-picture"
  frameborder="0"
></iframe>
  • Livestreams: Default is low-latency WebRTC. Use &lowLatency=false for HLS or &lowLatency=force for WebRTC only. Use &clipLength=60 (max 120) for clipping. Use constant=true for constant playback (e.g. music).
  • VOD: Options include &muted=false, &autoplay=false, &loop=true.

​
Thumbnails

  • VOD — Thumbnails are in the playback info (WebVTT + keyframe images). See Thumbnails (VOD).
  • Livestream — Playback info includes a PNG thumbnail URL that updates with the latest frame. The Player can use it as the video poster.

​
Metrics

The Livepeer Player reports engagement to Livepeer when used with the Studio API. Query viewership and analytics via the API or dashboards.
Last modified on February 18, 2026