@@ -218,22 +218,16 @@ bash scripts/install-sudoers.sh # Allows specific recovery scripts only
218218
219219See ** [ WAYLAND_OPTIMISATION.md] ( WAYLAND_OPTIMISATION.md#usb-capture-device-crash-recovery ) ** for detailed configuration and troubleshooting.
220220
221- ### Troubleshooting OBS Connection
222-
223- - ** Loopback device not created:** See above modprobe command
224- - ** Device disconnects under load:** Run ` sudo ./scripts/maintenance.sh ` → select repair (option 6)
225- - ** Auto-reconnect not working:** Check ` journalctl -u usb-capture-monitor.service -f ` for errors
226- - ** OBS crashes with "double free or corruption":** Use ` obs-safe ` launcher or ` make optimise-drivers `
227- - ** HW acceleration crashes on Wayland:** Run ` make optimise-drivers ` to fix GPU driver issues
228-
229221## Troubleshooting
230222
231223### OBS-Related Issues
232224
233225- ** Loopback device not created:** Run ` sudo modprobe v4l2loopback video_nr=10 exclusive_caps=1 ` and restart OBS
234226- ** Device disconnects under load:** Run ` sudo ./scripts/maintenance.sh ` → select option 6 (repair)
235227- ** Auto-reconnect not working:** Check logs with ` journalctl -u usb-capture-monitor.service -f `
236- - ** HW acceleration crashes on Wayland:** Run ` make optimise-drivers ` to fix GPU driver issues (see Wayland section below)
228+ - ** OBS crashes with "double free or corruption":** Use ` obs-safe-launch.sh ` launcher or run ` make optimise-drivers `
229+ - ** HW acceleration crashes on Wayland:** Run ` make optimise-drivers ` to fix GPU driver issues (see Wayland section above)
230+
237231
238232### Service Debugging
239233
@@ -483,11 +477,8 @@ ffmpeg -f v4l2 -i /dev/video0 \
483477
484478### Why Use v4l2loopback Instead of Direct Capture
485479
486- Never capture the physical USB device directly in OBS. Always use the v4l2loopback bridge:
487-
488- ** Why:**
489480- ** Isolation** : If the hardware hangs, only FFmpeg crashes (and auto-restarts), OBS continues
490- - ** Stability** : OBS doesn't touch unreliable hardware directly
481+ - ** Stability** : OBS doesn't use unreliable hardware/ports directly
491482- ** Auto-recovery** : Automatic reconnection on device disconnect
492483- ** Compatibility** : Works with all capture devices, eliminates driver-specific crashes
493484
0 commit comments