luna/catacomb
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add a renderer escape hatch (wgpu default, glow fallback)

Browse source 
The desktop forces the wgpu/Vulkan renderer because glow/OpenGL crashes
on NVIDIA + Wayland maximize. But on some systems wgpu creates the window
and never presents a frame, so nothing appears. Keep wgpu the default but
compile glow back in and let it be selected via `--renderer glow` or
`YT_OFFLINE_RENDERER=glow` for those machines.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Luna 2026-06-08 00:04:24 -07:00
parent 2692fa2c9e
commit 9ba375f7b1
4 changed files with 166 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

21
docs/src/troubleshooting.md
View file

@ -96,6 +96,27 @@ handles the resize cleanly. Make sure you have a working Vulkan driver
(`vulkan-icd-loader` + your GPU's Vulkan package), which any desktop with
working graphics already has.
## The desktop window opens but stays blank
The desktop defaults to the wgpu/Vulkan renderer. On some systems with a
broken Vulkan stack, the OS can create the window while wgpu never
presents a frame. Try the OpenGL renderer:
```bash
YT_OFFLINE_RENDERER=glow yt-offline
```
or:
```bash
yt-offline --renderer glow
```
If that works, update/reinstall your Vulkan driver later and switch back
to the default renderer. On NVIDIA + Wayland, prefer the default wgpu
renderer when possible because OpenGL has historically crashed on window
maximize.
## The web UI looks like an old version after an upgrade
The SPA is served `Cache-Control: no-store`, so a hard reload