mpv-android is a video player for Android based on libmpv.
- Hardware and software video decoding
- Gesture-based seeking, volume/brightness control and more
- libass support for styled subtitles
- Secondary (or dual) subtitle support
- High-quality rendering with advanced settings (scalers, debanding, interpolation, …)
- Play network streams with the “Open URL” function
- Background playback, Picture-in-Picture, keyboard input supported
mpv-android is not a library/module (AAR) you can import into your app.
If you’d like to use libmpv in your app you can use our code as inspiration. The important parts are MPVLib
, BaseMPVView
and the native code. Native code is built by these scripts.
You can download mpv-android from the Releases section or
Note: Android TV is supported, but only available on F-Droid or by installing the APK manually.
Take a look at the README inside the buildscripts
directory.
Some other documentation can be found at this link.
⚠️ Please note ⚠️
Better support for scoped storage has been added (in most places).
The api29
APK with a reduced API level is still available but will be removed eventually.
Change log
- Features:
- Playback will pause when disconnecting headphones (#928)
- Enable filtering of media files in document picker
- Fixes:
- Improved subtitle font support for some languages (Hindi)
- Various fixes for gpu-next VO
- Fix app resetting when disconnecting Bluetooth hardware (@okhex)
Full set of build dependencies
- Android NDK r27c
- mbedtls 3.6.2
- dav1d videolan/dav1d@c8fdaa8
- ffmpeg FFmpeg/FFmpeg@0b8c9cf
- freetype 2.13.3
- fribidi 1.0.16
- harfbuzz 10.0.1
- libunibreak 6.1
- libass libass/libass@159cefc
- lua 5.2.4
- libplacebo haasn/libplacebo@5788a82
- libmpv mpv-player/mpv@dd5f206
- mpv-android 4258ae5
⬇️ Which APK do I download? ⬇️
Unless you have an old device, you generally want to get arm64-v8a
. Try armeabi-v7a
otherwise.
x86
devices are very rare. If you are unsure or require compatibility then the universal
APK will work everywhere.
Note: Android TV is supported, but only available on F-Droid or by installing the APK manually using e.g. Downloader.