mpvEx

项目概述

mpvEx（又称 mpvExtended）是一款 Android 媒体播放器，构建在 libmpv 之上，是 mpv-android 的分支，目标是既保留 mpv 的强大能力，又提供简单易用的界面。它用 Kotlin 与 Jetpack Compose 编写，界面走 Material 3 Expressive 风格。除了本地播放，它还支持网络流与局域网共享访问，并且完全免费开源、没有广告。

把 mpv 的能力装进一个好上手又好看的 Android 界面。

主要功能

• 易用界面：比原生 mpv 更简单直观的播放与浏览操作
• Material 3 Expressive 设计：现代界面风格，随系统呈现一致观感
• 画中画与后台播放：支持 PiP 小窗与后台继续播放
• 网络串流：可播放网络流媒体，以及 SMB、FTP、WebDAV 共享
• 高质量渲染：提供高质量画面渲染
• 文件管理：媒体选择器支持树形与文件夹两种浏览模式，带搜索功能
• 字幕与音轨：支持外挂字幕与外挂音频
• 手势缩放：画面手势缩放
• 播放列表管理：支持自定义播放列表
• 配置与脚本：支持高级配置与脚本扩展

适用人群

• 想要好看又好用的 Android 播放器用户
• 常看本地高清视频与剧集的人
• 需要访问 NAS 或局域网共享的用户
• 喜欢用脚本深度定制播放器的进阶用户

快速上手

1. 从 Releases 下载稳定的 APK，多数设备选 arm64-v8a
2. 安装并打开应用，授予媒体与存储读取权限
3. 用媒体选择器在树形或文件夹模式下找到视频并播放
4. 在「设置」中配置网络共享（SMB、FTP、WebDAV）与自定义播放列表
5. 播放时切换外挂字幕、音轨，并使用画中画与后台播放
6. 需要更多控制时，在设置里开启高级配置与脚本

核心优势

• 能力与易用兼得：在 mpv 的强大内核上叠加友好的界面
• 无广告无骚扰：完全免费开源，没有广告也不索取多余权限
• 媒体来源广：本地、网络流与局域网共享都能播
• 现代观感：Material 3 Expressive 界面随系统主题保持一致

系统要求

项目	要求
操作系统	Android
支持架构	arm64-v8a、armeabi-v7a、x86、x86_64、universal
依赖	本地播放需媒体读取权限，网络播放需联网

注意事项

• 项目仍在开发中，可能遇到 Bug，可在 Issues 中反馈
• 画中画与后台播放的效果随设备与系统版本而异
• 局域网共享需要正确的服务器地址、端口与账号信息