Skip to content
100pangciPublic

About

A media player for android, based on mpv-android and built with Jetpack Compose.

Resources

Stars

18 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

app icon mpvKt

A media player for Android based on mpv / mpv-android, aiming to provide a nicer user interface over the original.

English | 简体中文

License Release Platform Languages PRs Welcome

About this fork

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.

Features

Player

  • Powered by mpv: hardware & software decoding, gpu-next renderer
  • 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.conf and input.conf in-app
  • Custom buttons that execute arbitrary Lua code
  • Verbose logging and log export for bug reports

Showcase

Installation

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).

Building

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 assembleDebug

Windows:

build.bat assembleDebug

Subsequent 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).

Contributing

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.

Acknowledgments

About mpv-android-lib

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.

License

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.

About

A media player for android, based on mpv-android and built with Jetpack Compose.

Resources

Stars

18 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages