david
248a9a0ecf
Add a native x86_64 Linux build (ci/build-libmpv-linux.sh, build-linux.yml). Every dependency is static and linked into a single libmpv.so; only glibc/pthread/dl/m and the system zlib remain external. The Linux-only additions are the font stack (fontconfig -> expat, where macOS/Windows use CoreText/DirectWrite) and alsa audio output; gl is the plain render-API support (no X11/Wayland context, since jlibmpv supplies the GL context via JOGL). For consistency, ship a single native per platform and no public headers (jlibmpv loads the library via JNA and never compiles against it). Remove the accidental header/import-library copies from the Windows build and the phantom header copy from the macOS build.
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 bumpingMPV_REFin 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
- Download the release asset for your platform and extract it.
- Point jlibmpv at the extracted native library —
libmpv-2.dll(Windows),libmpv.dylib(macOS) orlibmpv.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.