Files
mpv-natives/.github/workflows/build-linux.yml
T
kirbylinkanddavid 8ad01bbab1 fix: enable PipeWire/Pulse AOs so audio works on PipeWire desktops (#1)
* fix: link libmpv against the system libasound instead of a static build

A statically linked libasound fails at runtime with 'Unknown PCM
cards.pcm.default': the default PCM is resolved dynamically per sound card
(load_for_all_cards hook enumerating cards and loading cards/<driver>.conf),
and that machinery did not work in the vendored archive, so audio produced no
output even though the config file itself was found (the earlier
--with-configdir prefix bug is fixed).

Link libasound.so.2 dynamically from the system (libasound2-dev), exactly like
CoreAudio on macOS and WASAPI on Windows: the OS audio stack stays external,
all video dependencies remain static and self-contained.

The build script no longer builds alsa-lib (the _alsa step, ALSA_VER pin and
the autoreconf dependency it needed are gone); meson resolves the system
'alsa' dependency via pkg-config. The workflow installs libasound2-dev, drops
autoconf/automake/libtool, and verifies ldd shows libasound.so.2 instead of
asserting a baked-in config dir.

* fix: enable PipeWire/Pulse AOs so audio works on PipeWire desktops

On a desktop where PipeWire owns the sound cards, the direct ALSA/dmix
'default' path is broken: snd_pcm_open('default') resolves to a dmix slave
that cannot be opened (verified: aplay -D default fails identically, while
aplay -D pulse works). libmpv with only the ALSA AO therefore got no sound.

mpv auto-probes audio drivers in the order pipewire -> pulse -> alsa, so
enable all three (each linked against its system shared lib, consistent with
CoreAudio/WASAPI). On a PipeWire/Pulse box it now uses the working server
before ever falling back to the direct ALSA path.

The workflow installs libpipewire-0.3-dev and libpulse-dev alongside
libasound2-dev, and the artifact verification now accepts any of the three
system audio libs instead of only libasound.

---------

Co-authored-by: david <david@phoenix.ipv64.de>
2026-10-02 18:25:12 +02:00

138 lines
5.0 KiB
YAML

name: build-linux
# Builds a single self-contained libmpv.so for Linux (x86_64) from mpv source
# pinned to a release tag. Every video dependency is built static and linked
# into the one .so; glibc/pthread/dl/m, the system zlib and the system audio
# stack (PipeWire / PulseAudio / ALSA) stay external, mirroring CoreAudio
# (macOS) and WASAPI (Windows), so the OS audio is left dynamic and
# everything else is self contained.
#
# Linux is the easiest of the three platforms: a single native build on an
# ubuntu runner, no cross-compile, no lipo. The only Linux-specific work is the
# font stack: libass (a hard mpv dependency) needs fontconfig (-> expat) where
# macOS/Windows use CoreText/DirectWrite.
#
# Pinned to mpv v0.41.0 - the version whose client API (131077) the jlibmpv
# JNA bindings are validated against. Bump the ref here for a libmpv update.
# The build recipe (dependency versions, static flags) lives in
# ci/build-libmpv-linux.sh in this repository.
on:
push:
branches: [main]
workflow_dispatch:
env:
MPV_REF: v0.41.0
TARGET: x86_64-linux
jobs:
build:
runs-on: ubuntu-24.04
env:
CCACHE_BASEDIR: ${{ github.workspace }}
CCACHE_DIR: ${{ github.workspace }}/.ccache
CCACHE_MAXSIZE: 500M
steps:
- name: Check out mpv-natives (build scripts)
uses: actions/checkout@v4
with:
fetch-depth: 1
- name: Check out mpv (pinned tag)
uses: actions/checkout@v4
with:
repository: mpv-player/mpv
ref: ${{ env.MPV_REF }}
path: mpv
fetch-depth: 1
- name: Get time
id: get_time
run: echo "timestamp=$(date +%s%N)" >> $GITHUB_OUTPUT
- name: Restore ccache
uses: actions/cache/restore@v4
with:
path: ${{ env.CCACHE_DIR }}
key: ${{ env.TARGET }}-${{ steps.get_time.outputs.timestamp }}
restore-keys: ${{ env.TARGET }}-
- name: Install dependencies
run: |
sudo apt-get update
sudo apt-get install --no-install-recommends -y \
ccache nasm ninja-build pkgconf cmake \
libasound2-dev libpulse-dev libpipewire-0.3-dev
python3 -m pip install meson
# Run the vendored build script from inside the mpv source tree, so the
# native build writes linux_prefix/ and the meson build next to mpv's
# meson.build and produces the self-contained .so in mpv/artifact/.
- name: Build self-contained libmpv
working-directory: mpv
run: bash "${{ github.workspace }}/ci/build-libmpv-linux.sh"
- name: Print meson log on failure
if: failure()
run: cat mpv/linux_build/meson-logs/meson-log.txt
- name: Collect artifact
run: |
mkdir -p artifact-libmpv
cp -pv mpv/artifact/libmpv.so artifact-libmpv/
echo "=== contents ==="
ls -l artifact-libmpv
# Verify the artifact is self-contained and portable:
# (1) ldd shows only system libs - and among them libasound.so.2,
# because audio is left to the OS stack (CoreAudio/WASAPI model),
# (2) no .debug sections remain (strip worked, artifact stays small).
# fontconfig bakes its build prefix into the binary, but that is benign:
# with no config file at that path it falls back to a built-in config
# that scans /usr/share/fonts, so we do NOT fail on those strings.
- name: Verify artifact (ldd, size, alsa is a system lib)
run: |
cd artifact-libmpv
echo "=== dynamic deps (system libs only) ==="
ldd libmpv.so
echo "=== debug sections (expect 0) ==="
readelf -S libmpv.so | grep -c '\.debug' || true
echo "=== size ==="
du -h libmpv.so
echo "=== system audio libs present (pipewire/pulse/alsa, not vendored) ==="
if ldd libmpv.so | grep -Eq 'libpipewire-0\.3|libpulse\.so|libasound\.so'; then
echo "OK: at least one system audio lib present, as intended"
else
echo "ERROR: libmpv.so links no audio backend (no sound?)"
exit 1
fi
- name: Checksums
run: |
cd artifact-libmpv
sha256sum libmpv.so > checksums.txt
cat checksums.txt
- name: Artifact name
id: artifact
run: |
VER=$(cat mpv/MPV_VERSION | tr -d '[:space:]')
echo "name=mpv-natives-linux-x86_64-mpv-$VER" >> "$GITHUB_OUTPUT"
echo "version=$VER" >> "$GITHUB_OUTPUT"
# upload-artifact zips the directory itself, so handing it the folder
# (not a pre-zipped file) yields a single-level archive without the
# double-zip wrapper.
- name: Upload artifact
uses: actions/upload-artifact@v4
with:
name: ${{ steps.artifact.outputs.name }}
path: artifact-libmpv
- name: Save ccache
uses: actions/cache/save@v4
if: always()
with:
path: ${{ env.CCACHE_DIR }}
key: ${{ env.TARGET }}-${{ steps.get_time.outputs.timestamp }}