Skip to main content

Getting Started with MamoPlayer

This guide helps you install MamoPlayer and render your first player using the Core package.

Want to see it running first? Clone the repo and launch the demo app:

npm install && npm run start:example

The apps/example directory contains a Core Demo and a Pro Demo accessible from a single home screen. See apps/example/README.md for details.

What is MamoPlayer?​

MamoPlayer is a React Native video player SDK that provides ready-to-use player UIs and playback building blocks.

You can start with the Core package for a standard playback experience, then move to Pro when you need advanced capabilities.

Core vs Pro packages​

@mamoplayer/core (Core)​

Use Core when you need:

  • Standard video playback with built-in controls (play/pause, seek, fullscreen)
  • Settings overlay (playback speed, mute) and support for custom settings items
  • Normalized playback event callbacks (onPlaybackEvent)
  • Optional DRM support (Widevine / FairPlay) and casting (AirPlay / Chromecast)
  • Developer debug overlay

@mamoplayer/pro (Pro)​

Use Pro when you need:

  • Analytics instrumentation (session_start, quartile, quality_change, and more)
  • Ad monetization: simulated ad breaks (ads) or Google IMA / VAST (ima)
  • Track and quality switching (quality variants, audio tracks, subtitle tracks)
  • Watermark overlays and playback policy enforcement (restrictions)
  • Picture-in-picture support
  • Premium theming, layout variants (compact, standard, ott), and custom icon sets

Installation​

Follow these steps in your React Native project.

1) Install the package​

Choose one package based on your needs:

# Core
npm install @mamoplayer/core
# or
yarn add @mamoplayer/core
# Pro (also installs the required Core peer dependency)
npm install @mamoplayer/core @mamoplayer/pro
# or
yarn add @mamoplayer/core @mamoplayer/pro

2) Install peer dependencies​

MamoPlayer expects these peer dependencies in your app:

  • react
  • react-native
  • react-native-video

If needed, install them with:

npm install react react-native react-native-video
# or
yarn add react react-native react-native-video

3) iOS only: install pods​

cd ios && pod install

Basic Core usage example​

The example below shows a simple @mamoplayer/core integration using MamoPlayer.

import React from 'react';
import { SafeAreaView, StyleSheet } from 'react-native';
import { MamoPlayer } from '@mamoplayer/core';

export default function PlayerScreen() {
  return (
    <SafeAreaView style={styles.container}>
      <MamoPlayer source={{ uri: 'https://example.com/video.mp4' }} autoPlay />
    </SafeAreaView>
  );
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
  },
});

Next steps​