mpv-android

mpv-androidMIT活跃维护

基于 libmpv 的 Android 视频播放器,支持硬件解码和丰富字幕、音轨控制,适合播放本地高码率视频。

Video player for Android based on libmpv ↦ #mpv-android @ irc.libera.chat

2026-09-17发布于 2026-09-17 15:33 UTC3,690star +7 / 7 天536fork同步于 2026-11-10 05:39 UTC

怎么上手

README 里没有找到可直接复制的安装命令

README 里没有找到可直接复制的安装命令,请到 README 或官方文档查看安装方式。

硬件要求

README 没有说明硬件要求。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

这个项目的说明还在生成中,先参考下面「最近发版」和 README。

最近发版

5 个版本2026-09-17
  1. 2026-09-172026-09-17 Build最新正式版2026-09-17 · 2026-09-17 15:33 UTC
    :information_source: New allstorage APK

    The api29 APK has been removed and replaced with allstorage, which uses the "manage external storage" permission to allow unrestricted file access without having to downgrade the API level. It will stay separate and not be shipped to Google Play.

    Change log

    • Fixes:
      • Fixed freeze/long delay before first TLS connection (@obscenelyvague)
      • hwdec-related bug fixes

    Full set of build dependencies

    • Android NDK r30
    • mbedtls 3.6.7
    • dav1d videolan/dav1d@362bc1138228390a0a521ecf3af18b23c6afeb9e
    • ffmpeg ffmpeg/ffmpeg@094a2f8a2a5e7fa64736e067de224ce28fdf5979
    • libxml2 2.15.4
    • fontconfig 2.18.3
    • freetype 2.14.3
    • fribidi 1.0.16
    • harfbuzz 14.4.0
    • libunibreak 8.0
    • libass libass/libass@b2fe9d8770678a7b5271387d38c20657ebf3429a
    • lua 5.2.4
    • libplacebo haasn/libplacebo@3330a515d62139259c26239014f286e233bd3a5c
    • curl 8.21.0
    • libmpv mpv-player/mpv@0b7ed670f7c353dd3dd4f8ae0fc788a181a15aa6
    • mpv-android fdf74f6830c47dbaa8a22ac79726e8303f1db5af

    :arrow_down_small: Which APK do I download? :arrow_down_small:

    You generally want to get arm64-v8a. Try armeabi-v7a for old devices. Or x86 otherwise. If you are unsure 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.

  2. 2026-08-112026-08-11 Build2026-08-11 · 2026-08-11 22:01 UTC
    查看更新说明
    :warning: Please note :warning:

    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:
      • Option to remember screen brightness (@obscenelyvague)
      • Notification thumbnail is updated when playing new files
      • Now includes libcurl for better HTTP streaming efficiency
    • Fixes:
      • Connection failures to some TLS servers were resolved (mbedTLS bug)
      • Various bug fixes and improvements

    Note: This release requires at least Android 6, up from Android 5.0 required by previous releases.

    Full set of build dependencies

    • Android NDK r29
    • mbedtls 3.6.7
    • dav1d 1.5.4 (videolan/dav1d@54706fc6bc0cdecab7e9593974a4039cc038fca7)
    • ffmpeg 9.0 (ffmpeg/ffmpeg@d32b387f2b0a484599d4587d651891f0c63c4238)
    • libxml2 2.15.3
    • fontconfig 2.18.2
    • freetype 2.14.3
    • fribidi 1.0.16
    • harfbuzz 14.2.1
    • libunibreak 7.0
    • libass libass/libass@3087d2b2ffda76602a17f9b09d25cb8addc8d313
    • lua 5.2.4
    • libplacebo haasn/libplacebo@4d82c6898551068d4ae6a6b5538efcddc2c7cf64
    • curl 8.21.0
    • libmpv mpv-player/mpv@f4d13e1c2c91f3a56e589aef9cb44cbc02e26e47
    • mpv-android ad98fc97ff1d25e217389e7238a1abda8c13a6c4

    :arrow_down: Which APK do I download? :arrow_down:

    You generally want to get arm64-v8a. Try armeabi-v7a for old devices. Or x86 otherwise. If you are unsure 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.

  3. 2026-04-252026-04-25 Build2026-04-25 · 2026-04-25 22:08 UTC
    查看更新说明

    :warning: Please note :warning:

    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:
      • Configurable handling when opening new files in existing session
    • Fixes:
      • Various corrections

    Full set of build dependencies

    • Android NDK r29
    • mbedtls 3.6.6
    • dav1d videolan/dav1d@c0f2fe3135e2f193e31089ff013f628b01aa8d21
    • ffmpeg ffmpeg/ffmpeg@fc4960b155aa33b9a08cf26c5e0a0530f0545f24
    • libxml2 2.15.3
    • fontconfig 2.17.1
    • freetype 2.14.3
    • fribidi 1.0.16
    • harfbuzz 14.2.0
    • libunibreak 7.0
    • libass libass/libass@fadc390583f24eb5cf98f16925fd3adee50bca88
    • lua 5.2.4
    • libplacebo haasn/libplacebo@82224764a98164ce9d2d9a10e4fefca934e475fb
    • libmpv mpv-player/mpv@9ce79bcaa0132660a2e45b6bfc1fb0c199665277
    • mpv-android 3018d47277d5b3ca02acdd96466f261c1d23ee08

    :arrow_down: Which APK do I download? :arrow_down:

    You generally want to get arm64-v8a. Try armeabi-v7a for old devices. Or x86 otherwise. If you are unsure 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.

  4. 2026-03-222026-03-22 Build2026-03-22 · 2026-03-22 13:44 UTC
    查看更新说明

    :warning: Please note :warning:

    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:
      • Now uses installed system fonts for improved language support (subtitles etc.) (@moi15moi)
      • DASH playback support
    • Fixes:
      • Notable resource leak with gpu-next resolved
      • Other minor corrections

    Full set of build dependencies

    • Android NDK r29
    • mbedtls 3.6.5
    • dav1d videolan/dav1d@d69235dd804b24c04ed05639cffcc912cd6cfd75
    • ffmpeg 8.1 (ffmpeg/ffmpeg@9047fa1b084f76b1b4d065af2d743df1b40dfb56)
    • libxml2 2.15.2
    • fontconfig 2.17.1
    • freetype 2.14.2
    • fribidi 1.0.16
    • harfbuzz 13.0.1
    • libunibreak 6.1
    • libass libass/libass@fadc390583f24eb5cf98f16925fd3adee50bca88
    • lua 5.2.4
    • libplacebo haasn/libplacebo@33b5dfada6a84692912e4d41f673f895df79479e
    • libmpv mpv-player/mpv@c798884163c1b779b0b17755631e319a17683e52
    • mpv-android 7059a764b1f30fb24d9170289463446de0e6046e

    :arrow_down: Which APK do I download? :arrow_down:

    You generally want to get arm64-v8a. Try armeabi-v7a for old devices. Or x86 otherwise. 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.

  5. 2025-12-272025-12-27 Build2025-12-27 · 2025-12-27 16:55 UTC
    查看更新说明

    :warning: Please note :warning:

    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:
      • Multiple files can be directly opened in mpv-android via the share function in other apps (@puchu)
    • Fixes:
      • UI corrections and crashes resolved
      • FTP protocol whitelisted again

    Full set of build dependencies

    • Android NDK r29
    • mbedtls 3.6.5
    • dav1d videolan/dav1d@bf82cfa74e5f609220a0692ecb9e7ace33d353f1
    • ffmpeg ffmpeg/ffmpeg@d60c1d72c1299e683c1d2f86cb4332b4d88348a5
    • freetype 2.14.1
    • fribidi 1.0.16
    • harfbuzz 12.2.0
    • libunibreak 6.1
    • libass libass/libass@cbb743215bad0fe202477e569fe8005545258ccd
    • lua 5.2.4
    • libplacebo haasn/libplacebo@bc90ef94944a3dcaab324b86d3e3769ad1d8698b
    • libmpv 0.41.0 (mpv-player/mpv@41f6a645068483470267271e1d09966ca3b9f413)
    • mpv-android 6deb01cee00e347c8e72fc57dd61fbb43916a528

    :arrow_down: Which APK do I download? :arrow_down:

    You generally want to get arm64-v8a. Try armeabi-v7a for old devices. Or x86 otherwise. 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.

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    mpv for Android

    Build Status

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

    Features

    • 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

    Library?

    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.

    Downloads

    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.

    Building from source

    Take a look at the README inside the buildscripts directory.

    Some other documentation can be found at this link.