[DEPRECATED] The Google Media Framework (GMF) is a lightweight media player designed to make video playback and integration with the Google IMA SDK on Android easier.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
gradle/wrapper Updated gradle version. Apr 25, 2016
CHANGELOG.md Changed build scripts to release on bintray. Apr 6, 2016
README.md Update README.md Mar 15, 2018


Google Media Framework for Android


As of March 15, 2018, we have stopped development and support for Google Media Framework (GMF) for Android in favor of the new ExoPlayer IMA extension.


The Google Media Framework (GMF) is a lightweight media player designed to make video playback and integration with the Google Interactive Media Ads (IMA) SDK on Android easier.

Google Media Framework Android Demo

The framework is currently in beta, allowing interested developers to try it out and send feedback before we finalize the APIs and features.


  • A customizable video player UI for video playback on Android
    • Logo and branding colors
    • Action buttons within video UI for other actions (ex. share or download)
    • Subtitle support
  • Easily integrate the Google IMA SDK to enable advertising on your video content
  • Built on top of ExoPlayer
    • Plays MPEG DASH, HLS and mp4, and easily extended to other video formats

Getting started

Clone the repository

git clone https://github.com/googleads/google-media-framework-android.git GoogleMediaFramework

Then import the project in Android Studio (or build using Gradle via ./gradlew).

Via jCenter

You can also include GMF by adding the following in your project's build.gradle file:

compile 'com.google.android.libraries.mediaframework:mediaframework:X.X.X'

where X.X.X is the version. For the latest version, see the project's Releases. For more details, see the project on Bintray.

Note: this installs the underlying mediaframework library. For the demo package with IMA integration, please download or clone the source.


Please see the Javadoc


For a detailed description of the project, please see the wiki.

Where do I report issues?

Please report issues on the issues page.


If you have questions about the framework, you can ask them in our google group.

How do I contribute?

See CONTRIBUTING.md for details.

I want to use a newer version of Exoplayer

Change the version of ExoPlayer included in the googlemediaframework package's build.grade:

compile 'com.google.android.exoplayer:exoplayer:rX.X.X'

Note: you may have to modify the code if any underlying ExoPlayer APIs have changed.



  • Android 4.1+


  • Gradle (1.12 or above)
  • Android Studio (0.8 or above)
    • Build tools version 19.1.0 (installed via SDK manager)
    • Google Play Services version 4.3.23 or higher (installed via SDK manager)
    • Google Repository (installed via SDK manager)
  • ExoPlayer (Included as a jar file)