FlowVid Android libmpv

An Android AAR containing libmpv, built for FlowVid Android and Android TV under the LGPL. mpv uses -Dgpl=false; FFmpeg uses --disable-gpl; GPL and nonfree components such as x264 and x265 are not included.

This repository is derived from abdallahmehiz/mpv-android and retains its Android bindings while adding FlowVid's pinned LGPL build and immutable release path.

FlowVid Android and Android TV use immutable release v0.1.12-lgpl-8. Its AAR is byte-identical to v0.1.12-lgpl-6 and has SHA-256 729a70c1ac86ba4f1e03a9bde73762f6370ed97ae08dc8faabf448edcf9ebef6.

Capabilities

• Multiple independent MPV instances
• mpv_node support
• DASH support

Installation

Download the AAR from this repository's Releases, place it in your module's libs directory, and add the local file dependency:

dependencies {
    implementation files("libs/flowvid-libmpv.aar")
}

Getting Started

Using BaseMPVView

The simplest way to extend BaseMPVView:

class MyPlayerView(context: Context, attrs: AttributeSet?) : BaseMPVView(context, attrs) {

    override fun initOptions() {
        // Set options before mpv.init() is called
        mpv.setOptionString("hwdec", "auto")
    }

    override fun postInitOptions() {
        // Set options after mpv.init() is called
        mpv.setOptionString("sub-auto", "fuzzy")
    }
}

val playerView = MyPlayerView(context, null)
playerView.initialize(configDir = filesDir.path, cacheDir = cacheDir.path)
playerView.playFile("/path/to/video.mp4")

Using MPV() Directly

You can also use MPV() then attach to fully control your mpv instance.

val mpv = MPV()

mpv.create(context)
mpv.setOptionString("config", "yes")
mpv.init()

// Attach to a view surface
mpv.attachSurface(surface)

// Load and play a file
mpv.command("loadfile", "/path/to/video.mp4")

// Access props
val paused: Boolean? = mpv.prop["pause"]
mpv.prop["pause"] = false

// access and set nodes
val node: MPVNode? = mpv.getPropertyNode("track-list")
mpv.setPropertyNode("chapter-list", myCustomChaptersList)

// observe as kotlin flows
val pauseState: StateFlow<Boolean?> = mpv.propFlow["pause"]

// cleanup
mpv.detachSurface()
mpv.destroy()

Multiple Instances

Each MPV() or BaseMPVView instance is independent:

val player1 = MPV()
val player2 = MPV()

player1.create(context)
player2.create(context)

// Each player can play different content simultaneously

Building from source

Take a look at the README inside the buildscripts directory.

Some other documentation can be found at this link.