Skip to content

Commit 0678f7c

Browse files
committed
fix(readme)
1 parent 42f908b commit 0678f7c

1 file changed

Lines changed: 4 additions & 13 deletions

File tree

docs/README.md

Lines changed: 4 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -218,22 +218,16 @@ bash scripts/install-sudoers.sh # Allows specific recovery scripts only
218218

219219
See **[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

Comments
 (0)