Troubleshooting4 min

Troubleshooting TiLive Recording Audio Delay

Audio drift is one of the most annoying live recording bugs because the video can look fine while the voice slowly falls behind or starts crackling.

Common causes

RTC capture can drift when the runtime mixes local and remote audio incorrectly, captures the wrong source, or records at unstable frame timing.

CPU pressure can also cause audio gaps if the recorder process cannot keep up with the incoming stream.

Prefer remote stream audio

For server-side recording, remote media audio is usually the safest default. It avoids capturing local system sound or double-mixing audio.

The recorder should keep this configurable, but the default should match the real production path.

Verify with ffprobe and preview

After recording, verify the output duration, dimensions, and file size before delivery.

Short smoke recordings are useful because they expose drift and crackling before users wait through a long live.

If audio sounds slow or crackly, test the same creator with the remote audio path before changing video settings.

Open @tiliverec_bot