From 7ea0bd11d8d46a4afc23a3ed1dd741fc01302cf1 Mon Sep 17 00:00:00 2001 From: Abhijeet Dash Date: Thu, 10 Sep 2026 10:48:20 +0530 Subject: [PATCH] docs: document getCompanionAudioFallbackInfo resolution rules --- electron/ipc/recording/diagnostics.ts | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/electron/ipc/recording/diagnostics.ts b/electron/ipc/recording/diagnostics.ts index 7cc8d06e..76a9a343 100644 --- a/electron/ipc/recording/diagnostics.ts +++ b/electron/ipc/recording/diagnostics.ts @@ -496,6 +496,16 @@ export async function getCompanionAudioFallbackPaths(videoPath: string) { return paths; } +/** + * Resolve which audio files the editor should play alongside `videoPath`, and + * the start delay recorded for each. + * + * The renderer treats a `.system.`/`.mic.` pair as independent tracks and mutes + * the video's own track when both are present. The macOS helper writes system + * audio to the inline track but keeps both sources as sidecars, so once a mac + * system sidecar exists the sidecars are authoritative and are returned in place + * of the video. Other layouts keep the embedded track and add the mic sidecar. + */ export async function getCompanionAudioFallbackInfo(videoPath: string) { const companionCandidates = await getUsableCompanionAudioCandidates(videoPath); if (companionCandidates.length === 0) {