react-native-video

The most battle-tested open-source video player component for React Native with support for DRM, offline playback, HLS/DASH streaming, and more.

[!IMPORTANT] This is a new version (v7) of react-native-video that is currently in active development. You can expect breaking changes and missing features.

If you have any questions, please contact us at [e-mail].

🔍 Features

Feature	Status
📱 Plays all video formats natively supported by iOS/Android	✅ Available & Production Ready by August
▶️ Local and remote playback	✅ Available & Production Ready by August
🔁 Streaming: HLS • DASH • SmoothStreaming	✅ Available & Production Ready by August
🧩 Expo plugin support	✅ Available & Production Ready by August
📴 Offline playback, video download, support for side-tracks and side-captions (via optional SDK)	✅ Available & Production Ready by August
📱 Picture in Picture	✅ Available & Production Ready by August
🎚️ Fine-grained control over tracks, buffering & events	🏗️ In Development
🧠 Advanced control over playback and buffering	📝 TODO
🔐 DRM: Widevine & FairPlay (See free DRM stream example)	📝 TODO
🌐 Basic Web Support	📝 TODO
📺 TV Support	📝 TODO
🥽 VisionOS Support	📝 TODO

✨ Project Status

Version	State	Architecture
v5 and lower	❌ End-of-life Commercial Support Available	Old Architecture
v6	🛠 Maintained (community + TWG)	Old + New (Interop Layer)
v7	🚀 Active Development	Old + New (Full Support)

react-native-video v7 introduces full support for the new React Native architecture, unlocking better performance, improved consistency, and modern native modules.

📚 Documentation & Examples

• 📖 Documentation
• 📦 Example: Basic Usage
• 📦 Example: Free DRM Stream
• 📦 Example: Offline SDK integration - In Progress 🏗️, will be available soon

🚀 Quick Start

Requirements

• React Native 0.75 or higher
• react-native-nitro-modules (>=0.27.2) - Please see nitro requirements

Install

react-native-video requires react-native-nitro-modules (>=0.27.2) in your project.

npm install react-native-nitro-modules

Then install react-native-video

# Install the beta version of react-native-video v7
npm install react-native-video@beta

# Install pods
cd ios && pod install

For react-native < 0.80

`react-native` < 0.80 have bug that prevents to properly handle errors by nitro modules on Android. We highly recommend to apply bellow patch for `react-native-nitro-modules` to fix this issue. You can apply it using `patch-package`.

Without this patch you won't be able "recognize" errors, all will be thrown as unknown errors.

see installation guide

Usage

import { useVideoPlayer, VideoView } from 'react-native-video';

export default () => (
  const player = useVideoPlayer(
    'https://www.w3schools.com/html/mov_bbb.mp4',
    (_player) => {
      _player.play();
    }
  );

  <VideoView
    player={player}
    style={{ width: '100%', aspectRatio: 16 / 9 }}
    controls
  />
);

🧩 Plugins

1 · 📥 Offline SDK

Enable offline streaming with full control over downloads, license lifecycle, secure storage, and media access.

• Track selection (bitrate, audio, subtitles)
• Pause / resume & background queueing
• Expiration & auto-cleanup
• Built for Android & iOS
• → Read the SDK Docs

2 · 🧪 Architecture

Write your own plugins to extend library logic, attach analytics or add custom workflows - without forking the core SDK.
→ Plugin documentation

💼 TWG Services & Products

Offering	Description
Professional Support Packages	Priority bug-fixes, guaranteed SLAs, roadmap influence
Issue Booster	Fast-track urgent fixes with a pay‑per‑issue model
Offline Video SDK	Plug‑and‑play secure download solution for iOS & Android
Integration Support	Hands‑on help integrating video, DRM & offline into your app
Free DRM Token Generator	Generate Widevine / FairPlay tokens for testing
Ready Boilerplates	Ready-to-use apps with offline HLS/DASH DRM, video frame scrubbing, TikTok-style video feed, background uploads, Skia-based frame processor (R&D phase), and more
React Native Video Upgrade Guide	Common upgrade pitfalls & how to solve them

See how TWG helped Learnn ship a world‑class player in record time - case study.

Contact us at [e-mail]

🌍 Social

• 🐦 X / Twitter - follow product & release updates
• 💬 Discord - talk to the community and us
• 💼 LinkedIn - see TWG flexing

📰 Community & Media

• 🗽 React Summit US – How TWG helped Learnn boost video performance on React Native.
  Watch the talk »

• 🧨 v7 deep dive – Why we’re building v7 with Nitro Modules Watch on X »

• 🛠️ Well-maintained open-source library - What does it truly mean? - Bart's talk for React Native Warsaw Watch here »

• 📺 “Over the Top” Panel - Building Streaming Apps for Mobile, Web, and Smart TVs - Bart giving his insights on the industry Watch here »

Similar packages

Other packages similar to react-native-video

react-native-video-controls

The react-native-video-controls package provides a customizable set of video controls for the react-native-video component. It extends the functionality of react-native-video by adding a set of default controls that can be easily customized.

react-native-youtube

The react-native-youtube package allows you to embed YouTube videos in your React Native application. It provides a simple interface for playing YouTube videos and supports various YouTube player features, such as autoplay, fullscreen, and video quality settings.

react-native-vlc-media-player

The react-native-vlc-media-player package is a React Native wrapper for the VLC media player. It supports a wide range of video formats and provides advanced playback features, such as network streaming, subtitles, and hardware acceleration.