v0.1.7

Portable, self-contained mpv with TrueHD/Dolby Atmos (MAT) passthrough.
Linux (AppImage + tar.xz) and Windows (installer + portable zip), in stock and
enhanced variants.

Built from

Component	Version
mpv	v0.41.0-dev-g3ecc37d29 (3ecc37d29bc5)
FFmpeg	git-2026-07-15-1588bce (1588bce21b6d)
libplacebo	7.360.1 (cee9b076f2c6)

Every download ships a BUILD-INFO.txt listing the version of every bundled
dependency (x264, x265, libass, OpenSSL, Vulkan, wayland, …) plus the exact git commit
of all ~29 libraries built from source — so you can verify offline precisely what went
into your binary. The same files are attached below as BUILD-INFO-<platform>-<variant>.txt.

---

Getting started

🪟 Windows

…-windows-setup.exe — the installer. It asks you which kind of install you want,
and lets you browse for / type any install folder:

• System install — into Program Files (or wherever you point it). Start-menu entry,
  and it registers itself under its own name (mpv (Atmos) / mpv (Enhanced + Atmos)),
  so it appears in Windows'
  Settings → Apps → Default apps and in Open with for media files. Has an uninstaller.
  It never steals your existing defaults — you opt in from Windows' own UI.
• Portable install — pure extraction to a folder you choose. No registry writes,
  no uninstaller, nothing outside that folder.

…-windows-x86_64.zip — the same payload as a plain zip, if you'd rather not run
an installer at all. Unzip anywhere and run mpv.exe (or drag a video onto it).

Both variants can be installed side by side (they use different app ids).

⚠️ For anything on the command line, use mpv.com, not mpv.exe.
mpv.exe is the windowed player and prints nothing to the console.
mpv.com is the identical player with console output.

Open PowerShell in the unzipped folder (in Explorer: Shift + Right-click →
Open in Terminal), then:

.\mpv.com --audio-device=help      # list your audio devices
.\mpv.com --version                # version / build info
.\mpv.com "C:\path\to\movie.mkv"   # play, with log output visible

🐧 Linux

AppImage: chmod +x mpv-atmos-*.AppImage && ./mpv-atmos-*.AppImage <file>
Tarball: extract, then run the mpv launcher in the folder:

tar xf mpv-atmos-*.tar.xz && cd mpv-atmos-*
./mpv --audio-device=help          # list your audio devices
./mpv /path/to/movie.mkv           # play

Showing up in your desktop / file manager

File managers only offer apps the desktop knows about — most (GNOME Files included)
give you no way to browse for a binary in Open with. The tarball ships an installer
that registers this build under its own name (mpv-atmos / mpv-enhanced-atmos),
so it can sit alongside a system mpv without either replacing the other:

./install.sh              # adds the .desktop entry + icons, for your user only
./install.sh --default    # ...and also make it the default video/audio player
./uninstall.sh            # removes everything it added

No sudo, and it writes nothing outside ~/.local. It picks up mpv's own full list
of ~122 media types, so it appears for every format mpv can actually play. After it runs,
the build shows up in your launcher and in Open with — keep the extracted folder where
it is (the entry points at it).

🔊 Turning on TrueHD/Atmos passthrough

Passthrough ships OFF. It only works when aimed at your HDMI/AVR device, and
your receiver is almost never the system's default audio device.

⚠️ Do not just uncomment the audio block — you MUST also set audio-device.
Exclusive-mode spdif sent to the wrong output gives you no sound at best, and on
Linux can hang the machine hard enough that it won't even reboot.

1. List your devices — Windows: .\mpv.com --audio-device=help ·
   Linux: ./mpv --audio-device=help
2. Copy your receiver's device string (e.g. wasapi/{0.0.1.00000000}.{…} on
   Windows, alsa/hdmi:CARD=HDMI,DEV=0 on Linux).
3. Edit portable_config/mpv.conf: paste it into the audio-device= line, then
   remove the leading # from that line and from ao=, audio-channels=,
   audio-exclusive=, audio-spdif=, audio-buffer=.
4. Play something — your receiver should display Atmos / TrueHD / DTS-HD.
   Press i in mpv for the stats overlay.

The mpv.conf in your download walks you through this too, with the exact lines.

No receiver? Change nothing — you get normal PCM audio out of the box.

Enhanced vs stock

Enhanced adds parallel segmented downloading, next-file prefetch, in-process
thumbnails and unselected-track caching. See
TUNING.md for what
the flags do and how to size the caches without running out of RAM.
Stock is plain upstream mpv + the Atmos fix, nothing else.

Full Changelog: v0.1.6...v0.1.7