mpvExtended

mpvExtended is a fork of mpv-android, built on the libmpv library. It aims to combine the powerful features of mpv with an easy to use interface and additional features.

Upstream

This fork uses mpv-android as the canonical upstream for future sync work. The old mpvEx fork is not treated as upstream.

Typical sync flow:

git fetch upstream
git log --oneline HEAD..upstream/master

• Simpler and Easier to Use UI
• Material3 Expressive Design
• Advanced Configuration and Scripting
• Enhanced Playback Features
• Picture-in-Picture (PiP)
• Background Playback
• High-Quality Rendering
• Network Streaming
• File Management
• Completely free and open source and without any ads or excessive permissions
• Media picker with tree and folder view modes
• External Subtitle support
• Zoom gesture
• External Audio support
• Search Functionality
• SMB/FTP/WebDAV support
• Custom Playlist management support

This project is still in development and is expected to have bugs. Please report any bugs you find in the Issues section.

---

Installation

Stable Release

Download the latest stable version from the GitHub releases page.

Or you can get the stable releases here

---

Showcase

---

Building

Prerequisites

• JDK 17
• Android SDK with build tools 34.0.0+
• Git (for version information in builds)

APK Variants

The app generates multiple APK variants for different CPU architectures:

• universal: Works on all devices (larger size)
• arm64-v8a: Modern 64-bit ARM devices (recommended for most users)
• armeabi-v7a: Older 32-bit ARM devices
• x86: Intel/AMD 32-bit devices
• x86_64: Intel/AMD 64-bit devices

---

Releases

Creating a Release

1. Update versionCode and versionName in app/build.gradle.kts
2. Build the release APK:

   ./gradlew assembleDefaultRelease -x lintVitalAnalyzeDefaultRelease -x lintVitalReportDefaultRelease -x lintVitalDefaultRelease

3. Commit and push the version change:

   git add app/build.gradle.kts && git commit -m "release: bump version to x.x.x" && git push

4. Create a tag and push:

   git tag vx.x.x && git push origin vx.x.x

5. Create a GitHub Release and upload APKs:

   gh release create vx.x.x \
     app/build/outputs/apk/default/release/app-default-arm64-v8a-release.apk \
     app/build/outputs/apk/default/release/app-default-armeabi-v7a-release.apk \
     app/build/outputs/apk/default/release/app-default-universal-release.apk \
     app/build/outputs/apk/default/release/app-default-x86_64-release.apk \
     app/build/outputs/apk/default/release/app-default-x86-release.apk \
     --repo XIONGPEILIN/mpvExtended-android \
     --title "mpv NAS Player vx.x.x" \
     --notes "mpv NAS Player vx.x.x"

---

Acknowledgments

• mpv-android
• mpvKt
• Next player
• Gramophone

Star History