gitwtfhub

wtf is mpv-atmos-patched?

jjenkx/mpv-atmos-patched — explained in plain English

Analysis updated 2026-05-18

4GLSLAudience · generalComplexity · 2/5LicenseSetup · easy

TL;DR

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.

Mindmap

mindmap
  root((mpv-atmos-patched))
    What it does
      TrueHD Atmos passthrough
      Portable mpv builds
      Linux and Windows
    Variants
      Stock plus Atmos
      Enhanced plus Atmos
    Enhanced features
      Parallel segmented downloads
      Seekbar thumbnails
      Next file prefetch
    Core fix
      FFmpeg spdifenc patch
      Fixes branch point dropouts
    Audience
      Home theater users
      Media player enthusiasts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Download a portable mpv build to pass Dolby TrueHD or Atmos audio through to an AVR receiver without dropouts

REASON 2

Use the Enhanced variant for faster network streaming with segmented downloads and prefetching

REASON 3

Play Blu-ray remuxes with seamless branching without the audio glitches upstream mpv can hit

REASON 4

Run mpv without installing anything else, since codecs and FFmpeg are bundled in the build

What's in the stack?

mpvFFmpegGLSL

How it stacks up

jjenkx/mpv-atmos-patchedzalo/locuslucisibrews/mandelbulb-xr
Stars430
LanguageGLSLGLSLGLSL
Last pushed2023-07-11
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/53/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Just download and run the prebuilt AppImage, tarball, installer, or ZIP for your platform.

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.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Explain the difference between the Stock and Enhanced Atmos builds and help me pick one
Prompt 2
Walk me through installing the Windows portable build and playing my first file with Atmos passthrough
Prompt 3
Explain what the FFmpeg spdifenc patch actually fixes about TrueHD passthrough
Prompt 4
Help me tune the Enhanced build's cache and segmented download settings using TUNING.md

Frequently asked questions

wtf is mpv-atmos-patched?

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.

What language is mpv-atmos-patched written in?

Mainly GLSL. The stack also includes mpv, FFmpeg, GLSL.

What license does mpv-atmos-patched use?

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.

How hard is mpv-atmos-patched to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mpv-atmos-patched for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.