[PR #450] feat(vulkan): wolf:vulkan image (native Vulkan NV12 encode) + Fedora switch #476

New issue

Open

opened 2026-10-15 13:00:52 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-15 13:00:52 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/games-on-whales/wolf/pull/450
Author: @JBailes
Created: 6/27/2026
Status: 🔄 Open

Base: beta ← Head: feat/vulkan-image

📝 Commits (10+)

1e0692b feat(vulkan): native Vulkan NV12 H.264 encode support
9ff5f9c feat(fedora): switch images to Fedora base + embedded PulseAudio
bbdac70 ci: build & publish wolf:vulkan FROM gst-wayland-display:vulkan
ca14b47 ci: rebuild wolf:vulkan on updated base (LINEAR encode-src workaround)
847a1b8 ci: trigger wolf:vulkan rebuild (LINEAR encode-src base)
8cf4677 feat(vulkan): auto-enable RADV_PERFTEST=lowlatencyenc on AMD + Vulkan encoder
f06c7d8 fix(rtsp): round resolution to 64px CTB for vulkanh265enc
65ddb99 feat(vulkan): opt-in 10-bit HDR10 path for vulkanh265enc (WOLF_HDR)
73ad597 ci(vulkan): cache-bust wolf:vulkan to rebuild on fresh base
b558409 feat(vulkan): make the 10-bit/HDR path config-driven ([gstreamer.video] hdr)

📊 Changes

22 files changed (+614 additions, -139 deletions)

View changed files

➕ .ci-rebuild-trigger (+1 -0)
📝 .devcontainer/dev-setup.sh (+5 -6)
📝 .devcontainer/devcontainer.json (+9 -7)
📝 .github/workflows/docker-build.yml (+19 -0)
📝 docker/gpu-drivers.Dockerfile (+22 -26)
📝 docker/gstreamer.Dockerfile (+13 -42)
📝 docker/wolf.Dockerfile (+52 -40)
➕ docker/wolf.vulkan.Dockerfile (+136 -0)
📝 docs/modules/user/pages/configuration.adoc (+12 -0)
📝 src/moonlight-protocol/moonlight.cpp (+8 -1)
📝 src/moonlight-protocol/moonlight/control.hpp (+40 -0)
📝 src/moonlight-protocol/moonlight/protocol.hpp (+2 -1)
📝 src/moonlight-server/control/control.cpp (+19 -0)
📝 src/moonlight-server/events/events.hpp (+13 -0)
📝 src/moonlight-server/rest/endpoints.hpp (+15 -1)
📝 src/moonlight-server/rtsp/commands.hpp (+26 -0)
📝 src/moonlight-server/state/configTOML.cpp (+55 -2)
📝 src/moonlight-server/state/data-structures.hpp (+5 -0)
📝 src/moonlight-server/state/default/config.include.toml (+47 -1)
📝 src/moonlight-server/state/default/config.v7.toml (+47 -1)

...and 2 more files

📄 Description

Draft. Builds and publishes a wolf:vulkan image with native Vulkan NV12 H.264 encode, on a Fedora base. Pairs with games-on-whales/gst-wayland-display#37, which publishes the gst-wayland-display:vulkan base image this builds FROM.

What this adds

1. Native Vulkan NV12 H.264 encode (feat(vulkan))
A VULKAN encoder type wired through config/streaming: a vulkanh264enc h264_encoders block, producer_buffer_caps = video/x-raw(memory:VulkanImage), format=NV12, and video_params_zero_copy = "queue" so the encoder consumes the producer's NV12 VulkanImage directly (no videoscale/videoconvert/videorate, which can't negotiate the memory:VulkanImage feature). waylanddisplaysrc vulkan=true is set when the buffer caps ask for VulkanImage. Tunables: WOLF_VULKAN_QUALITY / _REF_FRAMES / _B_FRAMES (defaults tuned for low-latency: quality=0 num-ref-frames=1 b-frames=0).

2. wolf:vulkan image (ci)
docker/wolf.vulkan.Dockerfile is FROM ghcr.io/games-on-whales/gst-wayland-display:vulkan — which already carries patched GStreamer 1.28.4 (vulkan-video + the vulkanh264enc DPB-pool patch) and the plugin under /opt/gst. So the heavy gst-Vulkan + plugin build happens once in that image; here we only compile Wolf on top. A Build Wolf (Vulkan) step in docker-build.yml publishes ghcr.io/<owner>/wolf:vulkan.

3. Fedora image switch (feat(fedora))
Moved here from #431 per request. gpu-drivers, gstreamer and wolf images build on Fedora (base-app:fedora) instead of Ubuntu/apt. Wolf runs its own PulseAudio under supervisord (the Fedora base ships a conflicting pipewire-pulseaudio shim, swapped with --allowerasing), with graceful SIGINT shutdown to match stopsignal=INT.

Relationship to other PRs

games-on-whales/gst-wayland-display#37 — publishes gst-wayland-display:vulkan, the base image this builds FROM.
#431 — keeps the smoke-test harness + Wayland resolution tests; the Fedora switch was moved out of it into this PR.

Status / testing

Hardware-validated end-to-end on an AMD RX 7900 XTX (RADV + RPM Fusion freeworld mesa): waylanddisplaysrc → NV12 VulkanImage → vulkanh264enc → Moonlight streams real content. Draft pending CI image builds and broader GPU validation.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/games-on-whales/wolf/pull/450 **Author:** [@JBailes](https://github.com/JBailes) **Created:** 6/27/2026 **Status:** 🔄 Open **Base:** `beta` ← **Head:** `feat/vulkan-image` --- ### 📝 Commits (10+) - [`1e0692b`](https://github.com/games-on-whales/wolf/commit/1e0692b369f256e1382a9c7dc81cc270eed0ca1c) feat(vulkan): native Vulkan NV12 H.264 encode support - [`9ff5f9c`](https://github.com/games-on-whales/wolf/commit/9ff5f9c9abfdf2c2211dbdb10b03fa8d897c8945) feat(fedora): switch images to Fedora base + embedded PulseAudio - [`bbdac70`](https://github.com/games-on-whales/wolf/commit/bbdac703dec534717ea6e48d4d0a0f0af37b3ebb) ci: build & publish wolf:vulkan FROM gst-wayland-display:vulkan - [`ca14b47`](https://github.com/games-on-whales/wolf/commit/ca14b47d6d4bf5e0c8d25f1fa98cb97b4bf4dbd9) ci: rebuild wolf:vulkan on updated base (LINEAR encode-src workaround) - [`847a1b8`](https://github.com/games-on-whales/wolf/commit/847a1b8c40e2e625887f98da3f81e67f9ca2d8ca) ci: trigger wolf:vulkan rebuild (LINEAR encode-src base) - [`8cf4677`](https://github.com/games-on-whales/wolf/commit/8cf4677a7e98b5c250e8a128916e24cd904346f3) feat(vulkan): auto-enable RADV_PERFTEST=lowlatencyenc on AMD + Vulkan encoder - [`f06c7d8`](https://github.com/games-on-whales/wolf/commit/f06c7d8bc052131794f746bc9267dfaedd275dad) fix(rtsp): round resolution to 64px CTB for vulkanh265enc - [`65ddb99`](https://github.com/games-on-whales/wolf/commit/65ddb998b70ce13915f9b24c4a1824e22e604206) feat(vulkan): opt-in 10-bit HDR10 path for vulkanh265enc (WOLF_HDR) - [`73ad597`](https://github.com/games-on-whales/wolf/commit/73ad597b975000ef0557fe116f0fc3cb0cd0d5cd) ci(vulkan): cache-bust wolf:vulkan to rebuild on fresh base - [`b558409`](https://github.com/games-on-whales/wolf/commit/b5584090af31ef4e7e4882ea7dab5e7c4bc3974b) feat(vulkan): make the 10-bit/HDR path config-driven ([gstreamer.video] hdr) ### 📊 Changes **22 files changed** (+614 additions, -139 deletions) <details> <summary>View changed files</summary> ➕ `.ci-rebuild-trigger` (+1 -0) 📝 `.devcontainer/dev-setup.sh` (+5 -6) 📝 `.devcontainer/devcontainer.json` (+9 -7) 📝 `.github/workflows/docker-build.yml` (+19 -0) 📝 `docker/gpu-drivers.Dockerfile` (+22 -26) 📝 `docker/gstreamer.Dockerfile` (+13 -42) 📝 `docker/wolf.Dockerfile` (+52 -40) ➕ `docker/wolf.vulkan.Dockerfile` (+136 -0) 📝 `docs/modules/user/pages/configuration.adoc` (+12 -0) 📝 `src/moonlight-protocol/moonlight.cpp` (+8 -1) 📝 `src/moonlight-protocol/moonlight/control.hpp` (+40 -0) 📝 `src/moonlight-protocol/moonlight/protocol.hpp` (+2 -1) 📝 `src/moonlight-server/control/control.cpp` (+19 -0) 📝 `src/moonlight-server/events/events.hpp` (+13 -0) 📝 `src/moonlight-server/rest/endpoints.hpp` (+15 -1) 📝 `src/moonlight-server/rtsp/commands.hpp` (+26 -0) 📝 `src/moonlight-server/state/configTOML.cpp` (+55 -2) 📝 `src/moonlight-server/state/data-structures.hpp` (+5 -0) 📝 `src/moonlight-server/state/default/config.include.toml` (+47 -1) 📝 `src/moonlight-server/state/default/config.v7.toml` (+47 -1) _...and 2 more files_ </details> ### 📄 Description > **Draft.** Builds and publishes a `wolf:vulkan` image with native Vulkan NV12 H.264 encode, on a Fedora base. Pairs with games-on-whales/gst-wayland-display#37, which publishes the `gst-wayland-display:vulkan` base image this builds FROM. ## What this adds **1. Native Vulkan NV12 H.264 encode** (`feat(vulkan)`) A `VULKAN` encoder type wired through config/streaming: a `vulkanh264enc` `h264_encoders` block, `producer_buffer_caps = video/x-raw(memory:VulkanImage), format=NV12`, and `video_params_zero_copy = "queue"` so the encoder consumes the producer's NV12 `VulkanImage` directly (no `videoscale`/`videoconvert`/`videorate`, which can't negotiate the `memory:VulkanImage` feature). `waylanddisplaysrc vulkan=true` is set when the buffer caps ask for VulkanImage. Tunables: `WOLF_VULKAN_QUALITY` / `_REF_FRAMES` / `_B_FRAMES` (defaults tuned for low-latency: `quality=0 num-ref-frames=1 b-frames=0`). **2. `wolf:vulkan` image** (`ci`) `docker/wolf.vulkan.Dockerfile` is `FROM ghcr.io/games-on-whales/gst-wayland-display:vulkan` — which already carries patched GStreamer 1.28.4 (vulkan-video + the `vulkanh264enc` DPB-pool patch) and the plugin under `/opt/gst`. So the heavy gst-Vulkan + plugin build happens once in that image; here we only compile Wolf on top. A `Build Wolf (Vulkan)` step in `docker-build.yml` publishes `ghcr.io/<owner>/wolf:vulkan`. **3. Fedora image switch** (`feat(fedora)`) Moved here from #431 per request. `gpu-drivers`, `gstreamer` and `wolf` images build on Fedora (`base-app:fedora`) instead of Ubuntu/apt. Wolf runs its own PulseAudio under supervisord (the Fedora base ships a conflicting `pipewire-pulseaudio` shim, swapped with `--allowerasing`), with graceful SIGINT shutdown to match `stopsignal=INT`. ## Relationship to other PRs - **games-on-whales/gst-wayland-display#37** — publishes `gst-wayland-display:vulkan`, the base image this builds FROM. - **#431** — keeps the smoke-test harness + Wayland resolution tests; the Fedora switch was moved out of it into this PR. ## Status / testing Hardware-validated end-to-end on an AMD RX 7900 XTX (RADV + RPM Fusion freeworld mesa): `waylanddisplaysrc → NV12 VulkanImage → vulkanh264enc → Moonlight` streams real content. Draft pending CI image builds and broader GPU validation. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi added the

pull-request

label

2026-10-15 13:00:52 +00:00