ReactPlayer

A React component for playing a variety of URLs, including file paths, HLS, DASH, YouTube, Vimeo, Wistia and Mux.

Version 3 of ReactPlayer is a major update with a new architecture and many new features. It is not backwards compatible with v2, so please see the Migration Guide for details.

The Future of ReactPlayer

Maintenance of ReactPlayer is being taken over by Mux. Mux is a video api for developers. The team at Mux have worked on many highly respected projects and are committed to improving video tooling for developers.

ReactPlayer will remain open source, but with a higher rate of fixes and releases over time. Thanks to everyone in the community for your ongoing support.

Note: If you are using Next.js and need to handle video upload/processing, check out next-video.

Key Features

• Wide Media Support: Plays a variety of sources. See the full list in the Supported Media guide.
• Lazy Loading: Automatically code-splits and lazy loads the appropriate player for the URL provided, reducing your main bundle size.
• Feature Rich: A comprehensive set of props for playback control, event handling, and player configuration.
• Light Mode: Option to render just a video thumbnail, loading the full player only on user interaction.
• Customizable: Supports custom controls and can be extended with custom players.
• Picture-in-Picture: Supports Picture-in-Picture (PiP) mode for file URLs in compatible browsers.

Getting Started

Ready to get started? Head over to the Installation guide and then follow the Quick Start tutorial.

For a deep dive into all available options, check out the API Reference.