david 0275986720 fix: make linux libmpv.so portable (ALSA config dir, fonts, strip)
Two runtime bugs in the shipped artifact:

1. ALSA: the static libasound carried ALSA_CONFIG_DIR pointing at the
   build prefix (linux_prefix/share/alsa), so snd_pcm_open("default")
   failed on any machine without that path ("Unknown PCM default",
   video worked, audio did not). Build alsa-lib with
   --with-configdir=/usr/share/alsa so the compile-time default is the
   canonical system location.

2. Size: the release .so still contained ~110 MB of DWARF debug sections
   (whole ffmpeg tree); strip --strip-all the artifact in the collect
   step, matching the windows build.

Also pin fontconfig's sysconfdir/localstatedir to /etc and /var so the
CONFIGDIR/FONTCONFIG_PATH/FC_CACHEDIR constants compiled into libass's
font stack resolve on any standard install (the runtime config search
falls back to the compiled-in CONFIGDIR and a built-in default config
when no FONTCONFIG_FILE/FONTCONFIG_PATH is set).

The workflow now verifies the artifact: ldd shows only system libs, no
debug sections remain, and no build-machine paths leaked into the
binary.
2026-10-02 03:24:18 +02:00

mpv-natives

Self-built libmpv native binaries for jlibmpv, the Java/JNA wrapper library.

Why this repository exists

jlibmpv is 100% MIT and deliberately does not bundle any native binaries (libmpv is GPL-licensed). End users who want a drop-in native they can point mpv.libmpv.path at (or that a RemoteNativeLocator can download) find them here, as versioned GitHub release assets.

  • Pinned version: mpv v0.41.0 — the exact client API (131077) the jlibmpv JNA bindings are validated against. A libmpv update means bumping MPV_REF in the workflows.
  • Build source: the mpv source tree is checked out at that tag by GitHub Actions and built with the vendored scripts in ci/ (build-libmpv-mingw64.sh, build-libmpv-macos.sh, build-libmpv-linux.sh). No mpv source or third-party binaries are stored in this repository.

Releases

Each platform build produces a zip with the native library (self-contained, single file) and a checksums.txt (SHA-256) for verification.

Asset Contents
mpv-natives-windows-x86_64-mpv-<ver>.zip libmpv-2.dll (all dependencies statically linked, mingw64 build)
mpv-natives-macos-universal-mpv-<ver>.zip libmpv.dylib (universal arm64 + x86_64, all dependencies statically linked)
mpv-natives-linux-x86_64-mpv-<ver>.zip libmpv.so (all dependencies statically linked, native x86_64 build)

Each native is fully self-contained: every dependency (ffmpeg, libass, libplacebo, harfbuzz, freetype, fribidi, …) is statically linked into the single library together with the C/C++ runtime where needed. The library depends only on the platform's system libraries, so there is no dependency closure to extract alongside it — jlibmpv loads it at runtime via JNA and never compiles against it, so no public headers are shipped.

On Linux the self-built libmpv.so additionally removes the need for the distribution package (libmpv1), which lags behind in codec support (dav1d/ AV1, x264/x265): the pinned ffmpeg 8.0.1 guarantees the full codec set on any recent glibc distribution.

How to use with jlibmpv

  1. Download the release asset for your platform and extract it.
  2. Point jlibmpv at the extracted native library — libmpv-2.dll (Windows), libmpv.dylib (macOS) or libmpv.so (Linux): -Dmpv.libmpv.path=/path/to/extracted/libmpv-2.dll.

Building

Builds run on GitHub Actions and are triggered by pushes to main or manually (Actions tab). There is nothing to build locally.

License

The artifacts are built from mpv (GPL-3.0-or-later) and its dependencies (LGPL/GPL) and are distributed under those licenses. See LICENSE for the repository's license terms.

S
Description
Backup (pull mirror) of github.com/kirbylink/mpv-natives
Readme MIT
112 KiB
Languages
Shell 100%