# mpvRx > A focused Android media player powered by mpv, with deep playback controls, libraries, streaming, subtitles, and scripting. mpvRx is an Android media player built on libmpv. Use these docs for installation, playback, libraries, streaming, configuration, and the Lua/JavaScript bridge. ## Documentation - [Documentation](https://mpvrx.vercel.app/docs): Install mpvRx, choose a build, tune playback, connect media sources, and extend the player with Lua or JavaScript. ### Getting started - [Installation](https://mpvrx.vercel.app/docs/getting-started/installation): Install mpvRx from GitHub Releases or track stable updates through Obtainium. - [Build variants](https://mpvrx.vercel.app/docs/getting-started/build-variants): Choose between Standard, No Vulkan, and FongMi releases and select the right APK architecture. - [First playback](https://mpvrx.vercel.app/docs/getting-started/first-playback): Grant only the access you need, open your first file, and establish a clean playback baseline. ### Playback - [Controls and gestures](https://mpvrx.vercel.app/docs/playback/controls-and-gestures): Configure the mpvRx player surface, gestures, orientation, background playback, and precision controls. - [Precision playback tools](https://mpvrx.vercel.app/docs/playback/precision-playback-tools): Review exact frames, capture snapshots, loop ranges, navigate chapters, skip segments, and set a sleep timer. - [Orientation, background playback, and PiP](https://mpvrx.vercel.app/docs/playback/orientation-background-and-pip): Control rotation, keep media playing outside the player, and understand picture-in-picture handoffs. - [Video, HDR, and shaders](https://mpvrx.vercel.app/docs/playback/video-hdr-and-shaders): Configure render backends, HDR pipelines, debanding, Anime4K, filters, and thermal-aware playback. - [Subtitles](https://mpvrx.vercel.app/docs/playback/subtitles): Select, style, search, synchronize, and generate subtitles in mpvRx. - [Audio and music](https://mpvrx.vercel.app/docs/playback/audio-and-music): Use audio tracks, background playback, the music library, lyrics, playlists, and visualizers. - [Statistics and refresh rate](https://mpvrx.vercel.app/docs/playback/statistics-and-refresh-rate): Read playback diagnostics, evaluate thermal load, and match the display refresh rate to video FPS. ### Library and streaming - [Local and network libraries](https://mpvrx.vercel.app/docs/library-and-streaming/local-and-network): Browse local storage and connect SMB, FTP, SFTP, or WebDAV media sources. - [Playlists, queues, and history](https://mpvrx.vercel.app/docs/library-and-streaming/playlists-and-history): Create local playlists, import M3U sources, save the active queue, manage favorites, and control playback history. - [Jellyfin and Navidrome](https://mpvrx.vercel.app/docs/library-and-streaming/jellyfin-and-navidrome): Connect media servers, browse remote libraries, and understand direct streaming and account behavior. - [Online media and torrents](https://mpvrx.vercel.app/docs/library-and-streaming/online-and-torrents): Open direct streams, supported online sources, magnet links, and torrent files responsibly. - [Downloads and online quality](https://mpvrx.vercel.app/docs/library-and-streaming/downloads-and-online-quality): Choose a download folder, manage direct and yt-dlp jobs, and configure online format preferences. - [Google Cast](https://mpvrx.vercel.app/docs/library-and-streaming/casting): Send compatible local files and remote streams to Chromecast and Cast-enabled displays. ### Advanced workflows - [Secure Folder](https://mpvrx.vercel.app/docs/advanced/secure-folder): Set up protected media, use biometric unlock, move and restore items, hide the entry point, and recover a forgotten PIN. - [Syncplay rooms](https://mpvrx.vercel.app/docs/advanced/syncplay): Connect to a Syncplay server and synchronize pause, seek, position, and readiness with a room. - [Video compression](https://mpvrx.vercel.app/docs/advanced/video-compression): Compress one or several videos with quality presets, codec and resolution controls, target size, metadata, and destination options. - [Screenshots and media information](https://mpvrx.vercel.app/docs/advanced/screenshots-and-media-info): Configure screenshot formats and filename templates, capture subtitle-inclusive frames, and inspect complete media metadata. ### Customization - [Interface and themes](https://mpvrx.vercel.app/docs/customization/interface-and-themes): Personalize mpvRx themes, player animations, browser layouts, and per-orientation controls. - [mpv configuration](https://mpvrx.vercel.app/docs/customization/mpv-configuration): Edit mpv.conf and input.conf safely, use profiles, and recover from problematic options. - [Lua and JavaScript scripting](https://mpvrx.vercel.app/docs/customization/scripting): Load mpv scripts in mpvRx, organize modules, and create custom player buttons. - [Custom command bridge](https://mpvrx.vercel.app/docs/customization/custom-commands): Call native mpvRx UI, seek, keyboard, and HTTP actions from Lua or JavaScript. - [AI and speech tools](https://mpvrx.vercel.app/docs/customization/ai-tools): Configure optional AI providers for subtitle translation, formatting, file naming, and speech transcription. ### Reference - [Privacy and permissions](https://mpvrx.vercel.app/docs/reference/privacy-and-permissions): Understand why mpvRx requests Android permissions and how optional network, speech, update, and secure-folder features use them. - [Performance and battery](https://mpvrx.vercel.app/docs/reference/performance-and-battery): Establish a low-power baseline, measure playback, and add rendering features within the device's thermal budget. - [Troubleshooting](https://mpvrx.vercel.app/docs/reference/troubleshooting): Isolate common installation, playback, network, subtitle, server, script, and Cast problems. - [Releases and updates](https://mpvrx.vercel.app/docs/reference/releases): Understand stable and preview releases, APK naming, update paths, and release verification. - [Build from source](https://mpvrx.vercel.app/docs/reference/build-from-source): Build mpvRx with the Gradle wrapper and select a distribution flavor. - [Support and contributing](https://mpvrx.vercel.app/docs/reference/support-and-contributing): Report reproducible problems, request features, contribute safely, and find project resources. ## Agent resources - [llms-full.txt](https://mpvrx.vercel.app/llms-full.txt): The full Markdown of every page in one file. - [Page Markdown](https://mpvrx.vercel.app/index.md): Append `.md` to any page URL to fetch that page as raw Markdown. - [JSON API](https://mpvrx.vercel.app/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://mpvrx.vercel.app/openapi.json. - [API catalog](https://mpvrx.vercel.app/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here. - [agent-readability.json](https://mpvrx.vercel.app/agent-readability.json): Manifest of every agent-facing artifact on this site. - [Sitemap](https://mpvrx.vercel.app/sitemap.xml): Every indexable page URL with its last-modified date.