Skip to content

fix(linux): Three.js sRGBEncoding compatibility fix for r152+#256

Open
MrHaku81 wants to merge 1 commit into
pollen-robotics:developfrom
MrHaku81:fix/threejs-srgb-encoding-linux
Open

fix(linux): Three.js sRGBEncoding compatibility fix for r152+#256
MrHaku81 wants to merge 1 commit into
pollen-robotics:developfrom
MrHaku81:fix/threejs-srgb-encoding-linux

Conversation

@MrHaku81
Copy link
Copy Markdown

Bug

THREE.sRGBEncoding and the outputEncoding renderer property were removed in Three.js r152. This project uses three: ^0.181.0 (r181), so THREE.sRGBEncoding resolves to undefined at runtime, causing a silent WebGL renderer initialization failure on Linux.

The symptom on Linux is that the 3D viewer fails to render correctly and the app shows a blank/broken view.

Fix

Replace the deprecated API with the modern equivalent:

- outputEncoding: THREE.sRGBEncoding,
+ outputColorSpace: THREE.SRGBColorSpace,

outputColorSpace with THREE.SRGBColorSpace is the correct replacement since Three.js r152 and is consistent with how React Three Fiber handles color space internally.

Tested on

  • CachyOS Linux (Arch-based), KDE Plasma, x86_64 — built from source, simulation mode (--mockup-sim) fully functional after this fix

Related

Notes

This fix was identified and tested while getting the app running on CachyOS Linux. The full debugging process and setup documentation (architecture overview, rebuild instructions, known warnings, manual daemon startup) is available at ~/reachy-debug.log in the test environment.

This investigation was assisted by Claude Code (Anthropic's CLI for Claude), which helped analyze the Tauri sidecar mechanism, the uv-trampoline source, and the Three.js API change.

🤖 Generated with Claude Code

@MrHaku81 MrHaku81 force-pushed the fix/threejs-srgb-encoding-linux branch from 0def449 to f31349d Compare April 22, 2026 16:34
@MrHaku81
Copy link
Copy Markdown
Author

Additionally, I've published an AUR package for Arch-based distributions, making installation straightforward:
📦 https://aur.archlinux.org/packages/reachy-mini-desktop-app
Install via AUR helper: yay -S reachy-mini-desktop-app

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant