Bitmovin player React Native module

Usage no npm install needed!

<script type="module">
  import reactNativeBitmovinPlayer from '';



npm (scoped)  npm  NpmLicense

Attention! This plugin is not official, the code is not provided or maintained by Bitmovin!

Getting started

$ npm install react-native-bitmovin-player --save

Mostly automatic installation

$ react-native link react-native-bitmovin-player

Manual installation


  1. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
  2. Go to node_modulesreact-native-bitmovin-player and add RNBitmovinPlayer.xcodeproj
  3. In XCode, in the project navigator, select your project. Add libRNBitmovinPlayer.a to your project's Build PhasesLink Binary With Libraries
  4. Run your project (Cmd+R)


  1. Open up android/app/src/main/java/[...]/
  • Add import com.xxsnakerxx.RNBitmovinPlayerPackage; to the imports at the top of the file
  • Add new RNBitmovinPlayerPackage() to the list returned by the getPackages() method
  1. Append the following lines to android/settings.gradle:
    include ':react-native-bitmovin-player'
    project(':react-native-bitmovin-player').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-bitmovin-player/android')
  2. Insert the following lines inside the dependencies block in android/app/build.gradle:
    implementation project(':react-native-bitmovin-player')

Add BitmovinPlayer iOS SDK

Add line to your Podfile

pod 'BitmovinPlayer', git: '', tag: '2.18.0'.

After that, install the pod using pod install.

Add BitmovinPlayer Android SDK

Add a link to our release repository to your application's build.gradle file. In addition to that, the google maven repository must be added.

allprojects {
    repositories {
        maven {
            url ''

Setup Project

Add the Bundle identifier of the iOS application which is using the SDK as an allowed domain to the Bitmovin licensing backend. This can also be done under Player -> Licenses when logging in into with your account.

When you do not do this, you'll get a license error when starting the application which contains the player.


Add your Bitmovin player license key to the Info.plist file as BitmovinPlayerLicenseKey.


Add your Bitmovin player license key to the AndroidManifest.xml.

<meta-data android:name="BITMOVIN_PLAYER_LICENSE_KEY" android:value="YOUR_KEY_HERE" />

Your player license key can be found when logging in into and navigating to Player -> Licenses.


import BitmovinPlayer from 'react-native-bitmovin-player';

// please follow to index.js for available props
    source: {
      title: 'It works',
      url: '',