diagnose_av_health
Diagnose stream or recording stuttering by analyzing key OBS performance ratios to pinpoint if the cause is render overload, encoder lag, or network congestion, with targeted fixes for each.
Instructions
Diagnose why a stream/recording might be dropping frames or stuttering — pulls GetStats + GetStreamStatus + GetRecordStatus in one call and interprets the ratios instead of leaving the AI to fetch three things and do the arithmetic itself.
The three numbers that actually matter, and what each one means:
renderSkippedFrames/renderTotalFrames high: OBS's render thread can't keep up with your scene (too many sources/filters, canvas resolution too high, or GPU-bound). Fix: lower canvas resolution, cut filters, simplify the scene.
outputSkippedFrames/outputTotalFrames high with LOW congestion: encoding can't keep up (CPU/GPU encoder overloaded). Fix: switch to a hardware encoder (NVENC/AMF/QSV), lower the encoder preset, or lower output resolution/fps.
outputCongestion high: the network can't keep up with your bitrate. Fix: lower bitrate, check upload speed.
These thresholds are heuristics, not authoritative OBS cutoffs — a few skipped frames right after starting a stream is normal; this flags sustained skip ratios worth investigating, not noise.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||