[PR #63] [MERGED] Add NVIDIA zero-copy pipeline toggle (fixes #60) #70

New issue

Closed

opened 2026-10-15 12:55:21 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-15 12:55:21 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/games-on-whales/unraid-plugin/pull/63
Author: @JBailes
Created: 7/19/2026
Status: ✅ Merged
Merged: 7/19/2026
Merged by: @JBailes

Base: main ← Head: fix/issue-60-nvidia-zero-copy

📝 Commits (1)

8a8a72c Add NVIDIA zero-copy pipeline toggle to work around driver negotiation failures (#60)

📊 Changes

4 files changed (+64 additions, -0 deletions)

View changed files

📝 docs/FAQ.md (+32 -0)
📝 gow.plg (+3 -0)
📝 packages/settings-ui/root/usr/local/emhttp/plugins/gow/gow.page (+20 -0)
📝 scripts/deploy.sh (+9 -0)

📄 Description

Problem

Reported in #60. After updating the NVIDIA driver, Moonlight connects to the Wolf UI, shows a few seconds of video, then disconnects with "no video received from host." The built-in Pong demo still works. The Wolf container log shows the zero-copy GStreamer pipeline failing to negotiate CUDA memory:

cudaconvertscale3 ... transform could not transform video/x-raw(memory:CUDAMemory), format=BGRA ...
streaming stopped, reason not-negotiated (-4)
[GSTREAMER] Pipeline error: Internal data stream error.

Wolf's zero-copy NVIDIA pipeline keeps frames in GPU (CUDA) memory for the lowest latency, but on some newer driver branches it fails to negotiate and the stream dies. Wolf exposes WOLF_USE_ZERO_COPY=FALSE to fall back to its legacy pipeline.

Change

Setup form: add an "NVIDIA zero-copy pipeline" checkbox (default on, shown only when an NVIDIA GPU is present). Unchecking it persists WOLF_ZERO_COPY=false in gow.cfg.
deploy.sh: when disabled, emit WOLF_USE_ZERO_COPY=FALSE on the Wolf service so Wolf uses the legacy pipeline.
FAQ: new entry describing the symptom, the log signature, and the fix.
Changelog entry in gow.plg.

Default behaviour is unchanged (zero-copy stays on); affected users flip the toggle and re-install to recover.

Testing

bash -n scripts/deploy.sh passes; verified the conditional emits the env line only for false/FALSE and never for the default.
Cannot reproduce the driver-specific negotiation failure without the affected NVIDIA hardware.

_{🔄 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/unraid-plugin/pull/63 **Author:** [@JBailes](https://github.com/JBailes) **Created:** 7/19/2026 **Status:** ✅ Merged **Merged:** 7/19/2026 **Merged by:** [@JBailes](https://github.com/JBailes) **Base:** `main` ← **Head:** `fix/issue-60-nvidia-zero-copy` --- ### 📝 Commits (1) - [`8a8a72c`](https://github.com/games-on-whales/unraid-plugin/commit/8a8a72cfe6a02fef6d54a64f62fb972f1651924f) Add NVIDIA zero-copy pipeline toggle to work around driver negotiation failures (#60) ### 📊 Changes **4 files changed** (+64 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `docs/FAQ.md` (+32 -0) 📝 `gow.plg` (+3 -0) 📝 `packages/settings-ui/root/usr/local/emhttp/plugins/gow/gow.page` (+20 -0) 📝 `scripts/deploy.sh` (+9 -0) </details> ### 📄 Description ## Problem Reported in #60. After updating the NVIDIA driver, Moonlight connects to the Wolf UI, shows a few seconds of video, then disconnects with **"no video received from host."** The built-in Pong demo still works. The Wolf container log shows the zero-copy GStreamer pipeline failing to negotiate CUDA memory: ``` cudaconvertscale3 ... transform could not transform video/x-raw(memory:CUDAMemory), format=BGRA ... streaming stopped, reason not-negotiated (-4) [GSTREAMER] Pipeline error: Internal data stream error. ``` Wolf's zero-copy NVIDIA pipeline keeps frames in GPU (CUDA) memory for the lowest latency, but on some newer driver branches it fails to negotiate and the stream dies. Wolf exposes `WOLF_USE_ZERO_COPY=FALSE` to fall back to its legacy pipeline. ## Change - **Setup form:** add an **"NVIDIA zero-copy pipeline"** checkbox (default on, shown only when an NVIDIA GPU is present). Unchecking it persists `WOLF_ZERO_COPY=false` in `gow.cfg`. - **deploy.sh:** when disabled, emit `WOLF_USE_ZERO_COPY=FALSE` on the Wolf service so Wolf uses the legacy pipeline. - **FAQ:** new entry describing the symptom, the log signature, and the fix. - **Changelog** entry in `gow.plg`. Default behaviour is unchanged (zero-copy stays on); affected users flip the toggle and re-install to recover. ## Testing - `bash -n scripts/deploy.sh` passes; verified the conditional emits the env line only for `false`/`FALSE` and never for the default. - Cannot reproduce the driver-specific negotiation failure without the affected NVIDIA hardware. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-15 12:55:21 +00:00