jjenkx/mpv-atmos-patched — explained in plain English
Analysis updated 2026-05-18
Download a portable mpv build to pass Dolby TrueHD or Atmos audio through to an AVR receiver without dropouts
Use the Enhanced variant for faster network streaming with segmented downloads and prefetching
Play Blu-ray remuxes with seamless branching without the audio glitches upstream mpv can hit
Run mpv without installing anything else, since codecs and FFmpeg are bundled in the build
| jjenkx/mpv-atmos-patched | zalo/locuslucis | ibrews/mandelbulb-xr | |
|---|---|---|---|
| Stars | 4 | 3 | 0 |
| Language | GLSL | GLSL | GLSL |
| Last pushed | — | 2023-07-11 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | easy | easy | moderate |
| Complexity | 2/5 | 3/5 | 3/5 |
| Audience | general | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Just download and run the prebuilt AppImage, tarball, installer, or ZIP for your platform.
mpv-atmos-patched provides ready-to-run, portable builds of mpv, the popular open source media player, with a fix compiled in that lets it pass Dolby TrueHD and Atmos audio straight through to a home theater receiver over HDMI without touching the audio. Builds are available for both Linux and Windows and are put together entirely in the open using GitHub Actions from the code in this repository. Each build bundles its own patched FFmpeg and codec libraries, so it does not rely on anything already installed on your system and cannot be broken by an unrelated system update. There are two variants to choose from. Stock plus Atmos is a normal, upstream-faithful mpv with only the Atmos and TrueHD fix added, for people who want the smallest possible change from official mpv. Enhanced plus Atmos adds extra streaming features on top, such as faster parallel downloading for network streams, live download speed display, caching of audio and subtitle tracks you are not currently using, in-app seekbar thumbnail previews, prefetching the next file in a playlist, and memory tuning for long playlists. The core fix addresses a real bug in FFmpeg's TrueHD handling. To send TrueHD or Atmos audio to a receiver unmodified, it has to be wrapped in a container format, and FFmpeg's existing code for this has trouble with certain Blu-ray remuxes that include larger timing gaps or discontinuous timing at scene branch points, which can cause dropouts or a receiver failing to lock onto the audio. This project applies an upstream FFmpeg fix for that problem ahead of its official merge, so passthrough audio plays reliably even across those tricky branch points. The README describes this project as built with heavy AI coding assistance from a single maintainer rather than a team, and it welcomes bug reports and suggestions through GitHub issues. Downloads are provided as AppImages, tarballs, installers, or portable ZIP files depending on platform and variant, always pointing at the latest release. The builds are distributed under the GPLv3 license.
Portable, ready-to-run builds of the mpv media player with a fix for reliable Dolby TrueHD and Atmos audio passthrough to home theater receivers.
Mainly GLSL. The stack also includes mpv, FFmpeg, GLSL.
You may use and modify the code, but any distributed derivative work must also be released under the same GPL license and its source made available.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly general.
This repo across BitVibe Labs
double-check against the repo, no cap.