​

Changelog

Track the evolution of React Native Video across versions. This page documents all major releases, features, bug fixes, and breaking changes.

​

Version 7.x (Current)

​

v7.0.0-beta.6 (Latest)

​

Features ✨

• Full New Architecture support with Nitro Modules
• New useVideoPlayer hook for player management
• Separated VideoView component for rendering
• useEvent hook for standardized event handling
• Video preloading capabilities
• Enhanced Picture-in-Picture support for multiple videos
• Notification controls for Android
• Buffer configuration options
• Keep screen awake prop
• Flexible page sizes for Android
• Side-loaded subtitles for HLS streams (iOS)

​

Bug Fixes 🐛

• Fixed iOS notification controls
• Prevented KVO crash in HybridVideoPlayer.release() (iOS)
• Fixed fullscreen transition cancellation events (iOS)
• Corrected language code on external subtitles
• Fixed external subtitle asset composition
• Resolved video loading issues with malformed external subtitles
• Fixed AudioFocusChangeListener access on main thread (Android)
• Fixed notification and app name retrieval (Android)
• Resolved player initialization bugs
• Fixed PiP views restoration after exit (Android)
• Improved error handling for view not found

​

Code Refactoring 🛠

• Removed nitro dispose usage for better memory management
• Refactored events logic for cleaner architecture
• Enhanced source loading mechanism
• Streamlined event handler add/remove pattern

​

v7.0.0-beta.5

​

Bug Fixes 🐛

• Fixed iOS fullscreen transition cancellation events
• Corrected language code handling for external subtitles

​

v7.0.0-beta.4

​

Bug Fixes 🐛

• Fixed external subtitle asset composition

​

v7.0.0-beta.3

​

Bug Fixes 🐛

• Resolved lint and TypeScript errors
• Fixed video loading when external subtitles are malformed
• Fixed AudioFocusChangeListener thread access on Android

​

v7.0.0-beta.2

​

Code Refactoring 🛠

• Removed nitro dispose for improved stability

​

Bug Fixes 🐛

• Fixed local asset loading for Android in release builds

​

v7.0.0-beta.1

​

Code Refactoring 🛠

• Major events logic refactoring for better maintainability

​

v7.0.0-beta.0

​

Features ✨

• Official beta release of v7
• Nitro Modules integration complete
• Full New Architecture support
• New API with useVideoPlayer and VideoView

​

v7.0.0-alpha.12

​

Bug Fixes 🐛

• Fixed Nitrogen release build issue for plugins

​

v7.0.0-alpha.11

​

Bug Fixes 🐛

• Gracefully handles view not found errors

​

v7.0.0-alpha.10

​

Bug Fixes 🐛

• Fixed Android notification and app name retrieval

​

v7.0.0-alpha.9

​

Bug Fixes 🐛

• Resolved player initialization bugs
• Disabled allowsVideoFrameAnalysis on iOS
• Fixed Android PiP view restoration

​

v7.0.0-alpha.8

​

Bug Fixes 🐛

• Disabled controls when in PiP mode on Android
• Fixed iOS AVPlayerViewController recreation issue

​

Features ✨

• Enhanced source loading mechanism
• Added Expo config for notification controls

​

v7.0.0-alpha.7

​

Dependency Upgrades 📦

• Bumped Nitro Modules version

​

Bug Fixes 🐛

• Fixed foreground service start on Android

​

v7.0.0-alpha.6

​

Features ✨

• Support for flexible page sizes on Android
• Notification controls
• Bumped Nitro Modules to latest version
• Added surface type prop for Android

​

v7.0.0-alpha.5

​

Code Refactoring 🛠

• Cleaned up events code
• Refactored event handler to use add/remove style

​

Bug Fixes 🐛

• Fixed Android PiP crash when entering fullscreen

​

Features ✨

• Added keepScreenAwake prop
• Added buffer configuration options
• Fixed system controls not hiding when returning to app (Android)
• Load player on initialization

​

v7.0.0-alpha.4

​

Features ✨

• Moved Android package to TWG namespace
• Added DRM interfaces

​

v7.0.0-alpha.3

​

Dependency Upgrades 📦

• Bumped Nitro Modules version

​

Bug Fixes 🐛

• Added prefab script for Android

​

Features ✨

• Plugin system support
• Added muted property to onVolumeChange event

​

v7.0.0-alpha.2

​

Documentation 📚

• Major documentation upgrade

​

Bug Fixes 🐛

• Fixed codegen configuration
• Fixed component linking method

​

v7.0.0-alpha.1

​

Features ✨

• Side-load subtitles for HLS streams (iOS)
• Picture-in-Picture support for multiple videos (Android)

​

v7.0.0-alpha.0

​

Features ✨

• Initial v7 release
• Built on Nitro Modules framework
• New VideoPlayer class
• New VideoView component
• useVideoPlayer hook
• useEvent hook for event handling
• Separated player logic from UI rendering

​

Breaking Changes 🔴

• Complete API redesign
• <Video /> component replaced with useVideoPlayer + <VideoView />
• New event handling system
• Requires react-native-nitro-modules
• Minimum React Native version: 0.75.0
• Props reorganized between VideoPlayer and VideoView
• Method calls moved to player instance

---

​

Version 6.x (Stable)

Version 6 is the current stable release with support for both Old and New Architecture via Interop Layer.

​

v6.19.0

​

Status

Latest stable release for v6 branch

​

Support

• Community maintained
• TheWidlarzGroup supported
• Old Architecture + New Architecture (Interop Layer)

​

Earlier v6 Releases

• v6.18.0
• v6.17.0
• v6.16.1
• v6.16.0
• v6.15.0
• v6.14.1
• v6.14.0
• v6.13.0
• v6.12.0
• v6.11.0
• v6.10.2
• v6.10.1
• v6.10.0
• v6.9.1
• v6.9.0
• v6.8.2
• v6.8.1
• v6.8.0
• v6.7.0
• v6.6.4
• v6.6.3
• v6.6.2
• v6.6.1
• v6.6.0
• v6.5.0
• v6.4.5
• v6.4.4
• v6.4.3
• v6.4.2
• v6.4.1

---

​

Version 5.x and Earlier

​

Support Options

• Commercial Support
• Migration Services
• Upgrade Guide

---

​

Version Support Matrix

​

Release Philosophy

​

Semantic Versioning

React Native Video follows Semantic Versioning:

• Major (7.0.0): Breaking changes, API redesigns
• Minor (7.1.0): New features, backwards compatible
• Patch (7.0.1): Bug fixes, backwards compatible

​

Pre-release Tags

• alpha: Early development, unstable API
• beta: Feature complete, API stable, testing phase
• rc: Release candidate, production-ready pending final testing

​

Release Cadence

• v7: Beta releases as features are completed
• v6: Stable releases with bug fixes and minor features
• Security patches: Released as needed for all maintained versions

​

Migration Guides

​

Stay Updated

• 🐦 Follow on X/Twitter
• 💬 Join Discord
• 📦 Watch on GitHub
• 💼 LinkedIn Updates

​

Contributing to Releases

Interested in contributing to React Native Video?

• Read the Contributing Guide
• Check Open Issues
• Review the Roadmap
• Join the Discord Community