A media player for Android based on mpv / mpv-android, aiming to provide a nicer user interface over the original.
English | 简体中文
This repository is an independently maintained, feature-enhanced fork of
mpvKt by
@abdallahmehiz. It builds on the original
with an upgraded mpv core, ongoing fixes, and additional features. Development
is tracked on the dev branch.
Highlights of this fork so far:
- Original-font subtitle rendering — mpv's built-in fontconfig indexes system fonts, your fonts folder and the video's own directory in place, so ASS subtitles render with the fonts their authors intended, exactly like on desktop. No font copying, file renames don't break matching, and a missing-font dialog offers one-tap copying plus a shortcut to the font settings.
- mpv-android-lib 0.1.13 — upgraded from 0.1.9 through a compatibility layer, no user-facing regression; native libraries target API 23 and subtitles gain fontconfig-based system-font discovery.
- Reworked screenshots — dedicated with/without-subtitles buttons, swipe-up-to-cancel, custom save directory with proper storage permissions.
- 18 languages with an in-app language switcher.
- Dozens of upstream issue fixes: subtitle delay resets, crashes on opening unsupported files, PiP NPEs, teardown segfaults, and more.
Player
- Powered by mpv: hardware & software decoding,
gpu-nextrenderer - Precise seeking, configurable seek duration and double-tap actions
- Video filters: brightness, contrast, gamma, saturation, hue
- Debanding (CPU/GPU), YUV420P pixel format option
- Chapters with a current-chapter indicator
- Playback speed with per-video memory and defaults
- Picture-in-Picture, background playback, sleep timer
- Resume playback position across sessions
Gestures
- Horizontal slide to seek, vertical slides for volume and brightness
- Double-tap to seek or play/pause, configurable per side (left/center/right)
- Hold to play at multiple speeds
- Full gesture customization via
input.conf
Subtitles
- ASS fonts resolved in place via fontconfig: system fonts, your fonts folder and the video's own directory, matched by the family names inside the font files — rename-safe, nothing is copied
- Automatic loading of external subtitles with matching names
- Preferred subtitle/audio languages (ISO codes)
- Primary + secondary subtitles with independent delays
- Full typography control: font, size, colors, border style, shadow, scale, position, ASS/SSA override
- Per-track delay calibration ("voice heard / text seen") with set-as-default
Screenshots
- One-tap capture with or without subtitles
- Hold a screenshot button and slide left/right to scrub frames, release to capture the exact frame
- Swipe up to cancel with an on-screen hint
- Custom save directory (or the default
Pictures/mpvKt)
Customization & power-user
- Edit
mpv.confandinput.confin-app - Custom buttons that execute arbitrary Lua code
- Verbose logging and log export for bug reports
Prebuilt, signed APKs are published on the
Releases page —
arm64-v8a covers most devices, universal covers all architectures.
Building from source only takes one command (see below).
The build toolchain (JDK 21, Android SDK, Gradle) is provisioned automatically
into the gitignored .android-env/ directory on first run — nothing is
installed system-wide and no Android Studio is required.
Linux:
./build.sh assembleDebugWindows:
build.bat assembleDebugSubsequent runs skip provisioning and build directly. APKs land in
app/build/outputs/apk/ (per-ABI and universal variants). Debug builds are
signed with the debug key; release builds expect keystore credentials via
environment variables (see CI workflow).
Issues and pull requests are welcome at
100pangci/mpvKt. Please target the dev
branch and run ./build.sh detekt assembleDebug (or the .bat equivalent)
before submitting.
- abdallahmehiz for creating mpvKt
- mpv-android for the base mpv library
- K1rakishou/Fuck-Storage-Access-Framework and zhanghai/MaterialPreference
- AgNO3/jcifs-ng for the SMB client (LGPL-2.1)
- All upstream contributors and translators
The mpv binding this project builds on is
io.github.100pangci:mpv-android-lib
— a maintained fork of the library originally extracted from
mpv-android by the first
mpvKt author, with an instance-based MPV API, mpv_node bindings,
multi-instance and DASH support. The fork tracks the upstream
mpv-android master buildscripts and is rebuilt and republished under our
own group id whenever it needs patching; since 0.1.13 its native
libraries target API 23 and subtitles get fontconfig-based system-font
discovery. The player layer of this fork (the MPVLib compatibility
singleton and MPVView) targets that API.
This project is licensed under the Mozilla Public License 2.0. It includes code derived from mpvKt, which was originally licensed under the Apache License 2.0. Redistribution of that derived code must also comply with applicable Apache-2.0 conditions; see LICENSE-APACHE.







