Skip to main content
Version: v7 Beta
Pro Player Feature

This feature is available exclusively in Pro Player. To access this functionality, please contact us.

Getting Started

This section covers the Offline Video SDK - a commercial extension for react-native-video that enables downloading and offline playback.

The Offline Video SDK is a commercial add-on for react-native-video (versions 6 and 7) that enables secure offline playback of HLS/DASH streams or static videos like MP4, including support for DRM, multiple audio tracks, and subtitles.

Requirements​

  • React Native Video: version 6.15.0 or higher (versions 6 and 7 are supported)
  • iOS: 15.0 or higher
  • Android: 6.0 or higher
  • Api key: A valid api key for the Offline Video SDK is required. You can obtain this through the SDK platform.

Features​

  • HLS/DASH/MP4 Downloading: Download and store video streams for offline playback
  • Asset Management: Full control over downloaded assets
  • Offline DRM: Supports offline playback of DRM-protected content with proper rights enforcement and license handling
  • Offline Playback: Play downloaded content without internet connection
  • Cross-platform: Works on both iOS and Android

Installation​

1. Configure npm for Private Package​

Since this is a private package, configure npm to access GitHub Packages by adding the following to your ~/.npmrc file:

@TheWidlarzGroup:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=<NPM_GITHUB_AUTH_TOKEN>

Replace <NPM_GITHUB_AUTH_TOKEN> with your GitHub token. To obtain this token, please contact us.

note

This token is different from the API key used for plugin authorization.

2. Install the Package​

Install the package using npm:

npm install @TheWidlarzGroup/react-native-video-stream-downloader

3. Android Configuration​

Add the following line to your ./android/app/build.gradle file in the dependencies block:

implementation fileTree(dir: "../../node_modules/@TheWidlarzGroup/react-native-video-stream-downloader/native-libs", include: ["*.aar"])

Ensure the path matches your project's node_modules location.

4. iOS Configuration​

No additional configuration is required for iOS; the plugin will be automatically linked.

5. Plugin Authorization​

After installation, authorize the plugin with an API key:

import { registerPlugin } from "@TheWidlarzGroup/react-native-video-stream-downloader";

const success = await registerPlugin("YOUR_API_KEY");

Replace "YOUR_API_KEY" with your actual API key obtained from sdk.thewidlarzgroup.com.

Supported Formats​

FormatiOSAndroid
HLS✅✅
MP4✅✅
MPEG-DASH❌✅

Licensing & Pricing​

The Offline Video SDK is distributed under a commercial license. You can evaluate it for free for 14 days without a credit card. For questions or assistance, contact hi@thewidlarzgroup.com.