mpv-android/mpv-android

mpv-android is a video player for Android based on libmpv.

The project addresses the need for a feature-rich video player on Android by wrapping the libmpv library, which powers the desktop mpv player. It leverages libmpv's mature video decoding and rendering capabilities while providing an Android-native interface. The approach uses Kotlin for the Android layer and native code to bind libmpv, allowing the player to inherit mpv's advanced features rather than reimplementing them.

Developers should choose this tool if they need a capable video player for Android with support for hardware and software decoding, advanced rendering options like scalers and debanding, and styled subtitles via libass. It suits projects requiring network stream playback, background playback, and Picture-in-Picture functionality. The project is explicitly not a library or module for import into other apps; it is a standalone application. However, the codebase can serve as a reference for developers who want to integrate libmpv into their own Android applications, with the key integration points documented in the MPVLib class, BaseMPVView class, and native code.

The project maintains active engagement with its community through an IRC channel. Development shows consistent attention to both the Kotlin codebase and the native layer, with build infrastructure managed through dedicated scripts. The maintainers provide documentation beyond the README and support multiple distribution channels including direct releases, Google Play, and F-Droid, with specific consideration for Android TV availability.