mpvRx

Project Overview

mpvRx is an Android video player built on libmpv, forked from mpv-android. It keeps the mpv playback core while greatly extending themes, gestures, the HDR pipeline, and player controls, and adds adaptive optimization for device temperature and battery. The app has no ads and no trackers, and its interface follows the Material 3 Expressive style.

mpv pushed further, with a calmer surface and steady performance.

Key Features

• Theme and visual system: 25+ color themes with pure-black AMOLED variants, and five player-control animation styles
• Gesture system: configurable double-tap seek zones, multi-tap continuous seeking, swipe-to-seek, long-press speed, and subtitle drag and zoom gestures
• HDR video pipeline: shader-based via hdr-toys, supporting HDR10, HLG, BT.2020 gamut mapping, and Linear HDR modes
• Thermal and battery management: samples thermal headroom during playback, caps the shader budget, and downgrades Anime4K quality
• Anime4K and upscaling: seven quality tiers, auto-disabled for high-resolution content and auto-downgraded under heat
• Ambient light effects: GLOW and FRAME_EXTEND modes with tunable parameters and shader caching
• Subtitle system: primary and secondary subtitles with automatic offset, online subtitle search, font management, and speech-to-subtitle generation
• Player controls: customizable four-zone layout with 25+ button types and custom script buttons
• Google Cast: a native cast button that discovers Chromecast devices and continues playback position
• Picture-in-picture and music: PiP window and a music player screen

Target Audience

• Android users who want high quality and deep customization
• Users who often watch HDR video on a phone
• People who need online and bilingual subtitles
• Advanced players who like tuning playback settings

Quick Start

1. Download and install the APK from Releases or Obtainium and grant media read permission
2. Open a local video, or use "Open URL" to play a network address
3. Pick a color scheme under "Settings > Theme" and optionally enable pure black
4. Adjust double-tap zones, speed, and subtitle gestures under "Settings > Gestures"
5. For HDR sources, choose the HDR mode and render backend in decoder settings
6. Use the built-in search for subtitles, or generate them from speech

Core Advantages

• Highly customizable: nearly everything from themes and controls to shaders can be tuned
• Performance with restraint: rendering load adapts to temperature for steadier long sessions
• Effortless subtitles: online search, dual subtitles, and speech-to-subtitle in one place
• Clean and quiet: no ads or trackers, with restrained permissions

System Requirements

Item	Requirement
OS	Android
Dependencies	Media read permission for local playback; network access for streaming and subtitle search
License	AGPL-3.0

Notes

• HDR modes, Anime4K, and ambient effects add significant GPU load and may drop frames on older devices
• Speech-to-subtitle is experimental and needs a cloud or local Whisper provider
• Cast and picture-in-picture behavior varies by device and system version