Skip to content
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
Cannot retrieve contributors at this time

Reference Apps - THEO Custom UI

The purpose of this app is to demonstrate how THEOplayer can be setup and configured to be controlled by a custom native UI.

For quick start, please proceed with the Quick Start guide.


The guides below will provide a detailed explanation how to use create custom THEOplayer UI that allows to control played stream:

This app is an extension of THEO Basic Playback application. For help with getting started with THEOplayer or Android Studio feel free to check THEOplayer documentation

Quick Start

Using THEOplayer distribution from public repository

This project is already set up to use THEOplayer from so you need to check it out and build. Below is a short explanation about how to include THEOplayer in the project. For the more comprehensive explanation please refer to THEOplayer documentation.

To use THEOplayer from, you need to include it in the build.gradle file on the project level:

  allprojects {
      repositories {
          maven { url '' }

Then, to use the library, specify the following in the module's level build.gradle file:

  dependencies {
      // THEOplayer required dependencies.
       implementation 'com.theoplayer.theoplayer-sdk-android:basic-minapi21:4.12.0'

Using library downloaded from [THEO Portal]

To use THEOplayer from a library downloaded from THEO Portal, follow these steps:

  1. Obtain THEOplayer Android SDK and unzip it.

    Please visit THEOplayer documentation to get required THEOplayer Android SDK.

  2. Copy theoplayer-android-[name]-[version]-minapi21-release.aar file from unzipped SDK into application libs folder and rename it to theoplayer.aar.

    Project is configured to load SDK with such name, for using other name please change implementation ':theoplayer@aar' dependency in app-level build.gradle file accordingly.

  3. Open THEO Custom UI application in Android Studio.

Android Studio should automatically synchronize and rebuild project. If this won't happen please select File > Sync Project with Gradle Files menu item to do it manually. Please note, that in very rare cases it will be required to synchronize project twice.

  1. Select Run > Run 'app' menu item to run application on a device selected by default.

Streams/Content Rights:

The DRM streams used in this app (if any) are provided by our Partner: EZ DRM and hold all the rights for the content. These streams are DRM protected and cannot be used for any other purposes.


This project is licensed under the BSD 3 Clause License - see the LICENSE file for details.