Troubleshooting

--probe-hw shows no usable hardware encoders

• confirm FFmpeg build includes your target encoder (h264_nvenc, h264_qsv, etc.)
• run --probe-codecs --only-video --only-hw
• set --hw-accel none as a fallback path while debugging

OCR falls back to CPU unexpectedly

• verify runtime libraries for your platform/provider are installed
• use DPN_OCR_REQUIRE_GPU=1 to fail fast instead of silently falling back
• try --ocr-engine pp-ocr-v3 on older GPUs/runtime stacks

Output not directly playable on a target client

• verify target selection (--device)
• inspect stream details with --probe-streams
• set explicit bitrate/quality limits to match endpoint constraints
• compare against SUPPORTED_DEVICES.md