venice-video-harness 2.4.0

package/dist/mini-drama/audio-mix.js

@@ -0,0 +1,118 @@
+// ---------------------------------------------------------------------------
+// Shared audio-mix helpers.
+//
+// SFX trim + fade — trims every raw SFX clip to a max duration and applies
+// a short fade-out, so fire crackle doesn't bleed across cuts and panic
+// shouts don't overlap dialogue.
+//
+// Loudness normalization — final pass targeting -16 LUFS integrated /
+// true-peak ≤ -1 dBTP. Applied as the last step of the final encode so all
+// upstream gain decisions are consistent.
+//
+// The assembler module consumes these via its `audioMix` options. Standalone
+// scripts can call the helpers directly.
+// ---------------------------------------------------------------------------
+import { execFile } from 'node:child_process';
+import { mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+export const DEFAULT_SFX_MAX_DURATION_SEC = 2.0;
+export const DEFAULT_SFX_FADE_OUT_SEC = 0.3;
+export const DEFAULT_DIALOGUE_GAIN_DB = 0;
+export const DEFAULT_MUSIC_GAIN_DB = -22;
+export const DEFAULT_SFX_GAIN_DB = -16;
+export const DEFAULT_LUFS_TARGET = -16;
+export const DEFAULT_TRUE_PEAK_DB = -1;
+/** Resolve a partial audio-mix config to a fully populated one. */
+export function resolveAudioMix(defaults) {
+    return {
+        sfxMaxDurationSec: defaults?.sfxMaxDurationSec ?? DEFAULT_SFX_MAX_DURATION_SEC,
+        sfxFadeOutSec: defaults?.sfxFadeOutSec ?? DEFAULT_SFX_FADE_OUT_SEC,
+        dialogueGainDb: defaults?.dialogueGainDb ?? DEFAULT_DIALOGUE_GAIN_DB,
+        musicGainDb: defaults?.musicGainDb ?? DEFAULT_MUSIC_GAIN_DB,
+        sfxGainDb: defaults?.sfxGainDb ?? DEFAULT_SFX_GAIN_DB,
+        lufsTarget: defaults?.lufsTarget ?? DEFAULT_LUFS_TARGET,
+        truePeakDb: defaults?.truePeakDb ?? DEFAULT_TRUE_PEAK_DB,
+        suppressModelNarration: defaults?.suppressModelNarration ?? false,
+    };
+}
+/**
+ * Trim a single SFX clip and apply a fade-out.
+ *
+ * Raw SFX clips from elevenlabs-sound-effects-v2 are 3-6 seconds long.
+ * Without trimming, fire crackle bleeds across cuts and panic shouts overlap
+ * dialogue. The fade-out is short (0.3s) — long enough to avoid a click,
+ * short enough to keep the SFX feeling punchy.
+ */
+export async function trimAndFadeSfx(opts) {
+    const global = resolveAudioMix(opts.globalDefaults);
+    const maxDur = opts.options?.maxDurationSec ?? global.sfxMaxDurationSec;
+    const fadeOut = opts.options?.fadeOutSec ?? global.sfxFadeOutSec;
+    await mkdir(dirname(opts.outputPath), { recursive: true });
+    const fadeStart = Math.max(0, maxDur - fadeOut);
+    await execFileAsync('ffmpeg', [
+        '-y',
+        '-i', opts.inputPath,
+        '-af', `atrim=0:${maxDur},afade=t=out:st=${fadeStart.toFixed(3)}:d=${fadeOut.toFixed(3)}`,
+        '-ar', '48000',
+        '-ac', '2',
+        opts.outputPath,
+    ]);
+    return opts.outputPath;
+}
+/**
+ * Apply trim+fade to every SFX clip in a directory.
+ *
+ * - The output directory mirrors the input layout.
+ * - Per-clip overrides can be supplied via the `perFile` map keyed on the
+ *   clip basename (e.g. `"fire-crackle.mp3"`) — useful for ambient SFX that
+ *   need a longer max duration than the global default.
+ * - Returns the list of output paths in input order.
+ */
+export async function trimAndFadeSfxBatch(opts) {
+    await mkdir(opts.outputDir, { recursive: true });
+    const outPaths = [];
+    for (const inputPath of opts.inputPaths) {
+        if (!existsSync(inputPath)) {
+            console.warn(`  SFX trim: skipping missing file ${inputPath}`);
+            continue;
+        }
+        const filename = basename(inputPath);
+        const outputPath = join(opts.outputDir, filename);
+        await trimAndFadeSfx({
+            inputPath,
+            outputPath,
+            options: opts.perFile?.[filename],
+            globalDefaults: opts.globalDefaults,
+        });
+        outPaths.push(outputPath);
+    }
+    return outPaths;
+}
+/**
+ * Final loudness normalization to a target integrated LUFS and true-peak
+ * ceiling. Uses ffmpeg's `loudnorm` filter (EBU R128 implementation).
+ *
+ * Two-pass loudnorm is more accurate but the single-pass form is fine for
+ * a final delivery encode — the input is already at a reasonable level
+ * after upstream gain decisions, and `loudnorm` will only nudge the
+ * envelope, not crush it.
+ */
+export async function loudnessNormalize(opts) {
+    const mix = resolveAudioMix(opts.audioMix);
+    await mkdir(dirname(opts.outputPath), { recursive: true });
+    const loudFilter = `loudnorm=I=${mix.lufsTarget}:TP=${mix.truePeakDb}:LRA=11`;
+    const args = ['-y', '-i', opts.inputPath];
+    if (opts.videoInput) {
+        args.push('-c:v', 'copy', '-af', loudFilter, '-c:a', 'aac');
+    }
+    else {
+        args.push('-af', loudFilter, '-ar', '48000', '-ac', '2');
+    }
+    args.push(opts.outputPath);
+    await execFileAsync('ffmpeg', args);
+    return opts.outputPath;
+}
+//# sourceMappingURL=audio-mix.js.map

package/dist/mini-drama/audio-mix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mix.js","sourceRoot":"","sources":["../../src/mini-drama/audio-mix.ts"],"names":[],"mappings":"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"}

package/dist/mini-drama/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+//# sourceMappingURL=cli.d.ts.map

package/dist/mini-drama/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/mini-drama/cli.ts"],"names":[],"mappings":";AAEA,OAAO,eAAe,CAAC"}