Canvas window shows "WS: disconnected"

1. Check that huff is fully started. The relay starts asynchronously — wait a second after launch.
2. Check port 8787 is not in use by another application. See Caveats — Port 8787.
3. If you opened canvas.html directly in a browser outside the Tauri app, the relay is not running. Start a standalone relay: node src/ws-server.js
4. On some systems the WebView connects via IPv6 ([::1]). huff binds both — if one fails the other should succeed within 1–2 seconds.

---

Camera not appearing or not starting

No camera in the dropdown

• Click ↻ Refresh in the Source group.
• macOS: System Preferences → Security & Privacy → Camera → confirm huff is allowed.
• Windows: Settings → Privacy → Camera → allow apps to access the camera.

Camera in dropdown but Start produces no output

• macOS distribution builds: must be codesigned with the camera entitlement. Dev mode works automatically. See Caveats.

---

MIDI device not appearing or not responding

Device not in the list

• Click ↻ Refresh in the MIDI panel.
• macOS: confirm the device appears in Audio MIDI Setup (Applications → Utilities).
• Windows: Device Manager → Sound, video and game controllers.

Device connected but not responding

• Check the channel field in your map file. -1 accepts all channels.
• Click Debug: log all ports to console in the MIDI panel and check the browser console (right-click controls window → Inspect → Console).

---

Syphon not appearing in receivers

1. Confirm the Syphon panel shows active.
2. In your receiver, trigger a manual re-scan of Syphon sources. Some apps only scan on launch.
3. Confirm both apps are on the same user account. Syphon uses shared memory and does not work across user sessions.

---

Spout init failed (Windows)

1. Install the Spout2 runtime from spout.zeal.co.
2. Confirm spout_bridge.dll is present next to the huff executable. If missing, reinstall.
3. On Windows 10, ensure WebView2 Runtime is installed.

---

High memory usage

• Lower the QUALITY slider. At quality=0 the ring holds only 4 frames.
• Reduce canvas resolution — make the controls window smaller.
• Disable Trails and Flow Warp — both read the full ring depth and keep it alive.

---

Glitch / effects stop responding to controls

1. Check that ON is toggled for the relevant effect group.
2. If CORRUPT % is at 0, no tiles will be displaced regardless of other settings.
3. If QUALITY is at 0, the ring holds only 4 frames — DEPTH and DEPTH SCATTER have very little range.
4. Right-click the controls window → Inspect → Console to check for JS errors.

---

Output looks frozen / only one frame

• The p5 draw loop may have halted due to a JS error. Check the console (right-click → Inspect → Console).
• If the video file is paused, the source is static — effects still run but the input is not changing.
• On Windows, some configurations throttle requestAnimationFrame when the window is not in focus. Keep the controls window visible.

---

Getting More Help

Open an issue on the GitHub repository with the console output and your OS/version. Include the huff version shown in the About overlay.