takana/recipes/mpv.toml

# mpv 0.41.0 — reproductor de video. LA PRIMERA APP GRÁFICA DE USUARIO FINAL DEL CORPUS.
#
# Contexto: el corpus cierra cuatro escritorios (KDE 171/171, GNOME 119/119, COSMIC 90/90,
# sway 129/129) y de apps tenía doce cosas, ninguna capaz de abrir un video. El ADR 0015 ordenó los
# montones y puso a mpv primero del montón A —lo que no tiene ningún muro estructural, sólo falta
# escribirlo—; éste es ese primer paso.
#
# ══ POR QUÉ VIVE EN EL CORPUS Y NO EN UNA COLA ══════════════════════════════════════════════════
# Un reproductor lo quieren las cuatro imágenes. Una receta resuelve sus deps SIBLING-FIRST (su
# propia cola) y después el catálogo PADRE, nunca una cola hermana: desde `incoming-kde/` mpv no
# alcanzaría `incoming-cosmic/`, y al revés tampoco. En el corpus lo alcanzan las cuatro. El precio
# fue subir cinco recetas de sistema (nasm, alsa-lib, ffmpeg, vulkan-headers y las de Python), TODAS
# con ArtifactHash idéntico al de su cola de origen ⇒ cero rebuild y un solo artefacto por nombre.
#
# ══ LAS DOS DEPS QUE NO SE PUEDEN NEGOCIAR ═════════════════════════════════════════════════════
# `meson.build:29` (libplacebo >= 6.338.2) y `:32` (libass >= 0.12.2) no llevan `required:` ⇒ son
# duras. No hay mpv sin escribir esas dos recetas antes, y libplacebo a su vez arrastró glad+jinja2.
#
# ══ -Dbuild-date=false NO ES COSMÉTICO ═════════════════════════════════════════════════════════
# Su default es `true` y estampa la fecha de compilación DENTRO del binario. Con eso, dos builds del
# mismo commit dan bytes distintos y el artefacto deja de reproducir — la promesa que sostiene el
# store entero. Es el mismo tipo de fuga que `-ffile-prefix-map` cierra para las rutas `/src` en
# `.debug_*`, pero ésta no hace falta perseguirla: upstream trae la perilla.
#
# ══ TODO EXPLÍCITO, NADA EN `auto` ═════════════════════════════════════════════════════════════
# mpv trae ~90 opciones y casi todas nacen `auto`, o sea que MIRAN EL SANDBOX y se prenden si
# encuentran el `.pc`. Eso hace que el artefacto dependa de qué otra cosa quedó montada en el lab,
# que es la misma trampa que la receta de ffmpeg cierra con `--disable-autodetect`. Van todas
# escritas, y lo que se apaga se apaga por una razón:
#
#   x11, gl-x11, egl-x11, xv, x11-clipboard, vdpau   la distro es Wayland-only (decisión firme; ver
#                                                    la memoria del frente GNOME). No es "todavía no".
#   vulkan, shaderc, spirv-cross                     nuestra libplacebo va `pl_has_vulkan=0`: el
#                                                    loader arrastra el stack X11 por los WSI.
#   vaapi-drm                                        exige `features['drm']` de mpv, apagado abajo.
#   vaapi-x11                                        Wayland-only.
#   drm, gbm, dmabuf-wayland                         `vo=drm` quiere `libdisplay-info`, que no está.
#                                                    El camino de salida es EGL/Wayland, que sí está.
#   pipewire, pulse, jack, sndio, oss, openal        ver el bloque de AUDIO.
#   lua                                              ver el bloque de LUA.
#   cdda, dvdnav, dvbin, libbluray, libarchive,      cada una es una lib más en el cierre y ninguna
#   lcms2, uchardet, rubberband, zimg, vapoursynth,  hace falta para reproducir un fichero. Se
#   libavdevice, javascript, jpeg, caca, sixel,      prenden cuando alguien las pida, no antes.
#   sdl2-*, cplugins, openal
#   manpage-build                                    exige docutils (rst2man); no está en el corpus.
#   libmpv                                           nadie la consume todavía. Se prende el día que
#                                                    entre un frontend (celluloid y compañía).
#
# ══ vaapi: DECODIFICACIÓN POR HARDWARE, Y POR QUÉ PIDE `libva-wayland` ═════════════════════════
# Era el último hueco de esta receta. `libva` vivía sólo en `incoming-kde/` y el corpus no alcanza una
# cola hermana; el 2026-09-04 subió al corpus (mudanza de hash IDÉNTICO, medida con `takana hash`) y
# la copia de la cola se jubiló.
#
# `-Dvaapi=enabled` A SECAS NO HABILITA NADA, y esto es lo que hay que saber antes de tocarlo:
# `meson.build:1464` requiere el feature contra `vaapi-drm or vaapi-wayland or vaapi-x11 or
# vaapi-win32`. Sin backend, la perilla se evalúa a falso — y con `enabled` eso es un error de
# configure, no un apagado silencioso, que al menos falla ruidoso. De los cuatro backends: x11 y
# win32 fuera (Wayland-only), y `vaapi-drm` exige además `features['drm']`, apagado porque `vo=drm`
# pide `libdisplay-info`, que no está. Queda `vaapi-wayland`, que pide `libva-wayland.pc` ⇒ por eso
# libva se reconstruyó con `-Dwith_wayland=yes`.
#
# Lo que entra al binario con el feature prendido: `video/vaapi.c`, `hwdec_vaapi.c`, el filtro
# `vf_vavpp.c` y `dmabuf_interop_pl.c` — el interop es por libplacebo (el mismo que ya usa el vo), no
# por GL: `dmabuf-interop-gl` es un feature aparte.
#
# ⚠ EL DRIVER ES RUNTIME. libva es sólo la capa de despacho; quien decodifica es
# `intel-media-driver` o el gallium VA de mesa, cargados por `dlopen` según la GPU. Que esto selle y
# que `--hwdec=vaapi` funcione en una máquina son dos cosas distintas: en un equipo sin driver VA
# instalado, mpv cae a decodificación por software y no lo dice fuerte. Comprobar con
# `mpv --hwdec=vaapi -v` y buscar la línea del driver, nunca asumirlo por el sello.

# ══ AUDIO: PIPEWIRE NATIVO, CON ALSA DETRÁS ════════════════════════════════════════════════════
# El servidor de audio de la distro es PipeWire (decisión del usuario, 2026-07-29) y desde el
# 2026-09-03 `libpipewire-0.3` vive en el CORPUS, así que mpv le habla NATIVO: control por-stream,
# metadata de sesión, sin pasar por la emulación. La promoción se pudo hacer porque se midió que
# ningún pipewire enlaza glib (sus NEEDED son dbus/pulse/sndfile) ⇒ es compartible entre las cuatro
# imágenes sin repetir el episodio de las dos glib. Ver la cabecera de `recipes/pipewire.toml`.
#
# ALSA queda ENCENDIDA TAMBIÉN, y no es redundancia: mpv prueba `pipewire` primero y cae a `alsa` si
# no hay demonio con quien hablar. En una imagen sin PipeWire corriendo —KDE hoy no lo lista entre
# sus raíces— eso es la diferencia entre sonar y no sonar.
#
# Y el camino ALSA tampoco pelea con PipeWire: la receta de pipewire va con `-Dpipewire-alsa=enabled`
# y cablea el plugin en `/etc/alsa/conf.d`, así que un cliente ALSA que abre "default" desemboca en
# PipeWire. La cadena de respaldo es `--ao=alsa` → `libasound` → `libasound_module_pcm_pipewire.so`
# → PipeWire: protocolo en vez de ABI compartida.
# ⚠ El precio, que conviene tener escrito: con `99-pipewire-default.conf` puesto, `pcm.!default` ES
# PipeWire. En una máquina donde PipeWire NO esté corriendo, un cliente ALSA ya no cae a la tarjeta:
# no suena. Es el trato que hace toda distro con pipewire-alsa, y acá es coherente porque PipeWire
# es el servidor decidido; pero explica un silencio que sin esta nota se diagnostica mal.
#
# ══ LUA: EL OSC, Y POR QUÉ NO ES LA `lua` DEL CORPUS ═══════════════════════════════════════════
# El OSC (la barra de búsqueda, el overlay de estadísticas, la consola) es Lua: `player/lua/osc.lua`.
# Sin Lua, mpv reproduce y responde al teclado pero no dibuja NADA de interfaz.
#
# La `lua` del corpus NO sirve: `meson.build:701` sólo acepta 5.1, 5.2 o LuaJIT (el `lua.pc` genérico
# va acotado a `>=5.1.0, <5.3.0`) y la nuestra es 5.4.8, que entró para wireplumber. Por eso existe
# `recipes/lua5.2.toml`, que instala SÓLO la librería —sin `/usr/bin/lua`, sin `luac` y sin `lua.pc`
# genérico— justamente para que las dos puedan convivir en una imagen sin pisarse.
# `-Dlua=lua5.2` y no `auto`: `auto` recorre ocho nombres de `.pc` y se lleva el primero que
# encuentre en el sandbox, o sea que el artefacto dependería de qué otra cosa quedó montada.
#
# ══ EL ffmpeg QUE HEREDA — YA CON SIMD (2026-09-04) ════════════════════════════════════════════
# El ffmpeg del corpus venía de la campaña KDE (entró para que kpipewire grabara un stream) y traía
# `--disable-x86asm`: para grabar un stream daba igual, para un reproductor era decodificar sin SIMD.
# Acá decía que NO se arreglaba porque produciría un ffmpeg distinto al de `incoming-kde/` y habría
# dos peleando por las mismas rutas en una imagen KDE.
#
# Esa condición ya no se cumple: `incoming-kde/ffmpeg.toml` fue jubilada y hoy hay UNA sola receta
# ffmpeg en todo el disco, que la cola resuelve por caída al catálogo padre. Con el duplicado fuera,
# encender x86asm dejó de tener precio y se encendió — radio medido: 4 dependientes (mpv,
# wf-recorder, kpipewire, spectacle). Ver la cabecera de `recipes/ffmpeg.toml`.
#
# La lección, que vale más que el flag: **un comentario que prohíbe algo por una condición del mundo
# envejece hacia la mentira cuando la condición se levanta**, y nadie lo revisa porque leerlo suena a
# que ya está decidido. Al jubilar un duplicado, buscar quién lo citaba como razón.
#
# Fuente por commit git (ADR 0006): los `/archive/` de GitHub los genera la forge al vuelo y su
# sha256 cambia cuando el servidor actualiza git/gzip. `v0.41.0` es un tag ANOTADO ⇒ esto es el
# `^{}` pelado, no el sha del tag.
name    = "mpv"
version = "0.41.0"
license = "GPL-2.0-or-later"

[source]
repo   = "https://github.com/mpv-player/mpv.git"
commit = "41f6a645068483470267271e1d09966ca3b9f413"

[build]
compiler = "zig-cc"
target   = "x86_64-linux-musl"
# Dinámico como foot: el cierre gráfico de abajo ya es dinámico y no es negociable —mesa expone
# EGL/GL como `.so`, ffmpeg va `--enable-shared --disable-static` y libplacebo lleva C++ adentro.
# Las libs que sí son `.a` (libass, freetype, harfbuzz, fribidi, fontconfig) entran igual: quien las
# consume es un EJECUTABLE, no un objeto compartido, así que la regla del `.a` no-PIC no aplica.
link  = "dynamic"
flags = []

[build.phases]
configure = "PYTHONPATH=/usr/lib/python3.12/site-packages meson setup output --prefix=/usr --buildtype=release -Dprefer_static=true -Dbuild-date=false -Dcplayer=true -Dlibmpv=false -Dtests=false -Dmanpage-build=disabled -Dhtml-build=disabled -Dpdf-build=disabled -Dwayland=enabled -Degl=enabled -Degl-wayland=enabled -Dgl=enabled -Dplain-gl=disabled -Dalsa=enabled -Dzlib=enabled -Diconv=enabled -Dvector=enabled -Dx11=disabled -Dgl-x11=disabled -Degl-x11=disabled -Dxv=disabled -Dx11-clipboard=disabled -Dvdpau=disabled -Dvulkan=disabled -Dshaderc=disabled -Dspirv-cross=disabled -Dvaapi=enabled -Dvaapi-wayland=enabled -Dvaapi-drm=disabled -Dvaapi-x11=disabled -Ddrm=disabled -Dgbm=disabled -Ddmabuf-wayland=disabled -Dpipewire=enabled -Dpulse=disabled -Djack=disabled -Dsndio=disabled -Doss-audio=disabled -Dopenal=disabled -Dsdl2-audio=disabled -Dsdl2-video=disabled -Dsdl2-gamepad=disabled -Dlua=lua5.2 -Djavascript=disabled -Dcdda=disabled -Ddvdnav=disabled -Ddvbin=disabled -Dlibbluray=disabled -Dlibarchive=disabled -Dlibavdevice=disabled -Dlcms2=disabled -Duchardet=disabled -Drubberband=disabled -Dzimg=disabled -Dvapoursynth=disabled -Djpeg=disabled -Dcaca=disabled -Dsixel=disabled -Dcplugins=disabled -Dcuda-hwaccel=disabled -Dcuda-interop=disabled"
compile   = "PYTHONPATH=/usr/lib/python3.12/site-packages ninja -C output"
install   = "PYTHONPATH=/usr/lib/python3.12/site-packages DESTDIR=/out meson install -C output --no-rebuild"

# `.pc Requires` → `[deps].build`, el patrón del corpus: freetype2 pide zlib+libpng, fontconfig pide
# expat, harfbuzz pide glib-2.0 (arrastra pcre2+libffi), wayland-client pide libffi, y mesa pone
# egl/gl/wayland-egl. linux-headers va porque el sandbox no los da solos.
[deps]
build = [
  "meson", "samurai", "python3", "pkgconf", "linux-headers",
  "ffmpeg", "libplacebo", "libass", "libunibreak", "lua5.2", "libva",
  "pipewire", "alsa-lib",
  "mesa", "libdrm", "wayland", "wayland-protocols", "libxkbcommon",
  "freetype", "fribidi", "harfbuzz", "fontconfig",
  "glib", "pcre2", "libffi", "expat", "libpng", "zlib", "zlib-shared",
]