mpv-omniphony v0.4.2
mpv-omniphony v0.4.2 — mpv with the ad_orender
spatial audio decoder.
What's in each archive: mpv (or mpv.exe), a fallback engine
library (liborender.so.* / orender.dll), orender.h, plus the
bundled MinGW runtime DLLs on Windows. The live overlay is built
into mpv itself — no script to install.
Engine loading: mpv no longer links the engine — it loads
liborender at runtime with an ABI version check, searching:
--ad-orender-library / $ORENDER_LIBRARY → the engine deployed
by Omniphony Studio (per-user data dir) → the copy bundled next to
mpv → the system library path. Updating Omniphony Studio therefore
updates the engine mpv uses, with no new mpv build; an
incompatible library is rejected with a clear log line and mpv
falls back to its native decoders.
macOS (Apple Silicon): …-macos-arm64.zip contains a
self-contained, double-clickable mpv-omniphony.app (built with
mpv's own bundler — every dylib incl. ffmpeg and MoltenVK is bundled,
no Homebrew required). CLI users run
mpv-omniphony.app/Contents/MacOS/mpv. It is ad-hoc signed, not
notarized, so the first launch is blocked by Gatekeeper — clear the
download quarantine once with
xattr -dr com.apple.quarantine /path/to/mpv-omniphony.app, or
right-click → Open the first time.
Upgrading? The overlay is now built in: delete any
omniphony-overlay.lua you previously copied into your mpv
scripts/ directory. A leftover copy is harmless (it self-disables
on these PUC-Lua builds), but it is no longer needed.
NOT bundled: the decoder bridge plugin
(omniphony_bridge.so / .dll). Licensing constraints on the
underlying codec mean users must obtain it themselves
and point mpv at it with
--ad-orender-bridge-path=/path/to/bridge.{so,dll,dylib}.
liborender built from source at Omniphony v0.4.2.
License — GPL-3.0-or-later. This build combines mpv
(GPL-2.0-or-later) with liborender (GPL-3.0-or-later), so the
combined work is GPLv3. Corresponding source: mpv
v0.41.0 + this repo's patches/ at commit
2553c6d66c0be57de7b8eeee140f86a82bcdbacc, and liborender at Omniphony
v0.4.2 (https://github.com/mgth/Omniphony).
Bundled third-party libraries: see THIRD-PARTY-NOTICES.md.