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.

• 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 Google Play or the GitHub releases page.

Or you can get the stable releases here

Preview Builds

For testing purposes only

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

Setting Up Release Signing

To enable automatic signing for release builds in GitHub Actions, you need to configure the following secrets in your GitHub repository:

1. Navigate to your repository on GitHub
2. Go to Settings → Secrets and variables → Actions
3. Add the following repository secrets:

Encoding Your Keystore

To encode your keystore file to base64:

Linux/macOS:

base64 -i your-keystore.jks | tr -d '\n' > keystore.txt

Windows (PowerShell):

[Convert]::ToBase64String([IO.File]::ReadAllBytes("your-keystore.jks")) | Out-File -FilePath keystore.txt -NoNewline

Copy the contents of keystore.txt and paste it as the value for the SIGNING_KEYSTORE secret.

Creating a Release

1. Update versionCode and versionName in app/build.gradle.kts
2. Commit the changes
3. Create and push a tag: bash git tag -a v1.0.0 -m "Release version 1.0.0" git push origin v1.0.0
4. GitHub Actions will automatically build, sign, and create a draft release

Creating a Preview Release

1. Create and push a preview tag: bash git tag -a v1.0.0-preview.1 -m "Preview release" git push origin v1.0.0-preview.1
2. GitHub Actions will create a pre-release automatically

Acknowledgments

• mpv-android
• mpvKt
• Next player
• Gramophone

Support the Project

If you find mpvExtended useful, consider supporting the development:

Star History