mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-17 15:24:19 +00:00
* feat(cli): one owner for init media placeholders, audio stays on the video Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * feat(cli): init keeps a video's sound on the clip; silent files scaffold muted Supersedes the patchVideoSrc changes in #3977 and #3942 and carries their tests. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Co-Authored-By: miga-heygen <miga-heygen@users.noreply.github.com> Co-Authored-By: kapelame <kapelame@users.noreply.github.com> * feat(registry): example templates keep the a-roll's sound on the video Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(lint): video audio rules recommend keeping sound on the video Update video_missing_muted and video_audio_double_source message and fixHint text to recommend the new default: keep audio on the video with data-has-audio="true" (not muted). Tests verify the new wording is in place. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(parsers): a video is either audible (data-has-audio) or muted, never both Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(studio): follow the compiler's audio rule in the audio-track toggle Confirm before background removal drops a video's sound. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(skills): hyperframes-core teaches sound on the video by default Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(skills): workflows and scaffold guidance keep a video's sound on the clip Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs: footage with sound keeps it on the video clip Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(cli): init from-file a-roll is timed, muted strip is attribute-exact The from-file a-roll video gets data-start="0" so a scaffold lints clean, and the orphaned audio-only slot comment is dropped. setVideoAudio now walks the tag attribute by attribute, so a class value containing the word muted survives. The ffprobe-missing warning says the video is assumed to have sound and how to switch to muted, and DEFAULT_META notes the failure surfaces at render until lint support lands. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(studio): keep has-audio in step with the muted toggle, test cutout confirm Muting a video now clears has-audio and unmuting sets it to true, in both the Design and flat media panels, matching the Has audio track toggle. Audio elements are unchanged. Adds coverage for both panels plus the cutout window.confirm guard: declined leaves src alone, accepted swaps src and mutes, a silent video never prompts. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(parsers): updateElementInHtml hasAudio only applies to videos, true or false An audio element or an undefined hasAudio no longer picks up a muted attribute; only an explicit false on a video writes muted. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs: video_missing_muted rule text, silent-footage notes, consistent audible examples lint.mdx and cli.mdx describe the current video_missing_muted rule instead of the retired unmuted-video wording. The editing recipes say how to adapt for silent footage and require the outgoing clip's sound to end at a J-cut. The Remotion media example shows the audible mapping consistently, data-attributes states that has-audio is required unless muted, and the hairline frame note no longer claims the video is muted. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(cli): encode init media filenames and probe --audio duration Function replacers stop dollar-sign pattern expansion in filenames; src is percent-encoded. --audio now passes the probed track length as the composition duration in both init paths. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(lint): audio-state-aware media rules and time-aware double-source check video_missing_muted honors any explicit data-has-audio. video_audio_double_source only considers audible videos and only fires when the same-src clips overlap in time. duplicate_audio_track now covers audible videos. audio_file_without_element no longer claims silence when an audible video carries the sound. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(skills): audio-stream check for remotion ports, followable J-cut recipe Remotion Video maps to data-has-audio only when the file has an audio stream. The J/L-cut recipe now shows both shots with muted pictures and separate audio. embedded-captions removes the audio.mp3 scratch file it extracts. skills-manifest.json regenerated. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * refactor(lint): trim comments to satisfy the comment ratchet Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(studio): atomic muted edits, cutout keeps sound on a linked audio Muted and Has audio track commit one batched write (one persist, one undo entry) and remove data-has-audio instead of writing an empty marker. Unmuting a video probes its src: audible -> true, silent -> false, probe failed -> absent. Remove background on an audible video inserts a linked sibling <audio> with the original sound in the same write, replacing the drop-the-sound confirm. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(producer): skip hidden videos when auto-adding video audio A video hidden in Studio is dropped by the mixer, so its src never reached existingAudioSrcs and the render re-added it at full volume. The video parser now records the shared hidden predicate and the auto-detect step skips hidden videos. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(studio): keep useDomEditSession under the 600-line cap Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: miga-heygen <miga-heygen@users.noreply.github.com> Co-authored-by: kapelame <kapelame@users.noreply.github.com>
328 lines
12 KiB
JavaScript
328 lines
12 KiB
JavaScript
#!/usr/bin/env node
|
|
/*
|
|
* transcribe.cjs — word-level transcription via hyperframes' native Whisper
|
|
* (replaces the Python ElevenLabs Scribe path; no Python, no API key).
|
|
*
|
|
* node transcribe.cjs <project-dir> [model] [language]
|
|
* Reads: <project>/source.mp4 (audio track)
|
|
* Writes: <project>/transcript.json — { text, language_code, words:[{text,start,end,type}] }
|
|
*/
|
|
const path = require("path");
|
|
const fs = require("fs");
|
|
const cp = require("child_process");
|
|
|
|
const { hfCli } = require("./hf-cli.cjs");
|
|
|
|
function ensureSource(project) {
|
|
const src = path.join(project, "source.mp4");
|
|
if (fs.existsSync(src)) return src;
|
|
const EXCL = new Set(["final", "bg_plus_caps", "fg_caps", "audio"]);
|
|
let cands = fs
|
|
.readdirSync(project)
|
|
.filter(
|
|
(f) =>
|
|
["mp4", "mov", "webm", "mkv", "m4v"].includes(path.extname(f).slice(1).toLowerCase()) &&
|
|
!EXCL.has(path.basename(f, path.extname(f))) &&
|
|
!f.startsWith("index"),
|
|
)
|
|
.map((f) => path.join(project, f));
|
|
let found = cands.sort((a, b) => fs.statSync(b).size - fs.statSync(a).size)[0];
|
|
if (found) {
|
|
try {
|
|
fs.symlinkSync(path.basename(found), src);
|
|
} catch {
|
|
fs.copyFileSync(found, src);
|
|
}
|
|
}
|
|
return src;
|
|
}
|
|
function _usableWords(d) {
|
|
return d && Array.isArray(d.words) && d.words.some((w) => w && "start" in w && "end" in w);
|
|
}
|
|
// Mean loudness of the audio, for the no-speech guard below. Silence → whisper
|
|
// hallucinates (famously "Thank you."), and the decision gate refuses "no speech".
|
|
function meanVolumeDb(audio) {
|
|
try {
|
|
// ffmpeg writes volumedetect stats to STDERR — capture it (spawnSync, no throw).
|
|
const r = cp.spawnSync(
|
|
"ffmpeg",
|
|
["-hide_banner", "-nostats", "-i", audio, "-af", "volumedetect", "-f", "null", "-"],
|
|
{ encoding: "utf8" },
|
|
);
|
|
const out = (r.stderr || "") + (r.stdout || "");
|
|
const m = out.match(/mean_volume:\s*(-?[\d.]+) dB/);
|
|
return m ? parseFloat(m[1]) : null;
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
// Where does AUDIBLE content end? Whisper hallucinates trailing words over a silent
|
|
// tail (observed: "I'm sorry." repeated over dead air at a clip's end). silencedetect
|
|
// finds a terminal silence running to EOF; words "spoken" inside it are fabricated.
|
|
// Conservative: applause/music read as non-silence, so this fires only on truly dead
|
|
// tails. Returns {speechEnd, total} or null.
|
|
function audibleEnd(audio) {
|
|
try {
|
|
const r = cp.spawnSync(
|
|
"ffmpeg",
|
|
[
|
|
"-hide_banner",
|
|
"-nostats",
|
|
"-i",
|
|
audio,
|
|
"-af",
|
|
"silencedetect=noise=-35dB:d=0.6",
|
|
"-f",
|
|
"null",
|
|
"-",
|
|
],
|
|
{ encoding: "utf8" },
|
|
);
|
|
const out = (r.stderr || "") + (r.stdout || "");
|
|
const durM = out.match(/Duration:\s*(\d+):(\d+):([\d.]+)/);
|
|
const total = durM ? +durM[1] * 3600 + +durM[2] * 60 + +durM[3] : null;
|
|
if (total == null) return null;
|
|
const starts = [...out.matchAll(/silence_start:\s*([\d.]+)/g)].map((x) => +x[1]);
|
|
const ends = [...out.matchAll(/silence_end:\s*([\d.]+)/g)].map((x) => +x[1]);
|
|
if (!starts.length) return { speechEnd: total, total };
|
|
const lastStart = starts[starts.length - 1];
|
|
const closed = ends.some((e) => e > lastStart); // silence re-broken before EOF?
|
|
return { speechEnd: closed ? total : lastStart, total };
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
function main() {
|
|
const project = path.resolve(process.argv[2] || "");
|
|
if (!process.argv[2]) {
|
|
console.error("usage: transcribe.cjs <project-dir> [model] [language]");
|
|
process.exit(1);
|
|
}
|
|
// Default = multilingual `small`, NOT `small.en`. Per media-use: ".en models
|
|
// mistranslate non-English and mis-handle accented speech; default to small (auto-detects
|
|
// language)." We hardcoded small.en before — it hallucinated a wrong transcript on an
|
|
// accented speaker. Pass `small.en` only for known-clean-English; tough accents → a larger model.
|
|
const model = process.argv[3] || process.env.WHISPER_MODEL || "small";
|
|
const language = process.argv[4] || process.env.WHISPER_LANG || "";
|
|
const out = path.join(project, "transcript.json");
|
|
|
|
// already in our schema? skip — but validate the SHAPE, not just the keys:
|
|
// `hyperframes init` drops a whisper.cpp segment/token-format transcript.json
|
|
// (offsets-in-ms, nested tokens) that can carry a `words` key yet poison the
|
|
// compilers. Only a word-level {text,start,end} array counts as normalized.
|
|
try {
|
|
const d = JSON.parse(fs.readFileSync(out, "utf8"));
|
|
const wordShaped =
|
|
d &&
|
|
Array.isArray(d.words) &&
|
|
d.words.length > 0 &&
|
|
d.words.every(
|
|
(w) =>
|
|
w &&
|
|
typeof (w.text ?? w.word) === "string" &&
|
|
Number.isFinite(w.start) &&
|
|
Number.isFinite(w.end) &&
|
|
w.end < 36000, // ms-offset formats blow past any sane seconds value
|
|
);
|
|
if (wordShaped && d.language_code) {
|
|
console.log("[transcribe] already normalized, skipping");
|
|
return;
|
|
}
|
|
if (d && !wordShaped) {
|
|
console.log(
|
|
"[transcribe] existing transcript.json is NOT word-level (init stub / segment format) — regenerating",
|
|
);
|
|
}
|
|
} catch {}
|
|
|
|
const src = ensureSource(project);
|
|
if (!fs.existsSync(src)) {
|
|
console.error(`[transcribe] no source in ${project}`);
|
|
process.exit(2);
|
|
}
|
|
const audio = path.join(project, "audio.mp3");
|
|
// A stray audio.mp3 in the project makes lint call the render silent; only remove one this run made.
|
|
const audioIsScratch = !fs.existsSync(audio);
|
|
if (audioIsScratch)
|
|
cp.execFileSync(
|
|
"ffmpeg",
|
|
["-y", "-i", src, "-vn", "-acodec", "libmp3lame", "-q:a", "2", audio],
|
|
{ stdio: "ignore" },
|
|
);
|
|
|
|
// ── engine: WhisperX (preferred — wav2vec2 forced alignment gives word timings far
|
|
// tighter than whisper.cpp's segment-interpolated ones; our gates are 80ms-strict) →
|
|
// fallback hyperframes whisper.cpp. Force with TRANSCRIBE_ENGINE=whisper|whisperx.
|
|
let words = null,
|
|
engine = null;
|
|
const wantWx = (process.env.TRANSCRIBE_ENGINE || "whisperx") === "whisperx";
|
|
if (wantWx) {
|
|
try {
|
|
const wav = path.join(project, "_wx_audio.wav");
|
|
cp.execFileSync("ffmpeg", ["-y", "-i", src, "-vn", "-ac", "1", "-ar", "16000", wav], {
|
|
stdio: "ignore",
|
|
});
|
|
const outDir = path.join(project, "_wx_out");
|
|
fs.mkdirSync(outDir, { recursive: true });
|
|
const wxModel = model.replace(/\.en$/, ""); // whisperx model names are multilingual ids
|
|
// Pin whisperx so `uvx` fetches a reproducible build instead of resolving
|
|
// "latest" on every run (a supply-chain + determinism foot-gun). Override
|
|
// with $WHISPERX_VERSION if you've validated a different release.
|
|
const whisperxSpec = `whisperx==${process.env.WHISPERX_VERSION || "3.8.6"}`;
|
|
const wxArgs = [
|
|
"--python",
|
|
"3.12",
|
|
"--from",
|
|
whisperxSpec,
|
|
"whisperx",
|
|
wav,
|
|
"--model",
|
|
wxModel,
|
|
"--device",
|
|
"cpu",
|
|
"--compute_type",
|
|
"int8",
|
|
"--output_dir",
|
|
outDir,
|
|
"--output_format",
|
|
"json",
|
|
"--no_align_deletes",
|
|
"--print_progress",
|
|
"False",
|
|
];
|
|
if (language) wxArgs.push("--language", language);
|
|
// strip our flag if this whisperx build doesn't know it
|
|
let r = cp.spawnSync("uvx", wxArgs, { encoding: "utf8", timeout: 600000 });
|
|
if ((r.status || 0) !== 0 && /no_align_deletes/.test(r.stderr || "")) {
|
|
r = cp.spawnSync(
|
|
"uvx",
|
|
wxArgs.filter((a) => a !== "--no_align_deletes"),
|
|
{ encoding: "utf8", timeout: 600000 },
|
|
);
|
|
}
|
|
if ((r.status || 0) !== 0)
|
|
throw new Error(
|
|
(r.stderr || "whisperx failed").split("\n").slice(-4).join(" ").slice(0, 300),
|
|
);
|
|
const wxJson = JSON.parse(fs.readFileSync(path.join(outDir, "_wx_audio.json"), "utf8"));
|
|
const wx = [];
|
|
for (const seg of wxJson.segments || [])
|
|
for (const w of seg.words || []) {
|
|
// alignment occasionally yields a word with no timing (OOV) — interpolate from neighbors later; mark null now
|
|
wx.push({ text: String(w.word || "").trim(), start: w.start, end: w.end, type: "word" });
|
|
}
|
|
// interpolate missing timings from neighbors (rare OOV/number cases)
|
|
for (let i = 0; i < wx.length; i++) {
|
|
if (wx[i].start == null || wx[i].end == null) {
|
|
const prevEnd = i > 0 ? wx[i - 1].end : 0;
|
|
const nextStart = wx.slice(i + 1).find((x) => x.start != null);
|
|
const ns = nextStart ? nextStart.start : prevEnd + 0.3;
|
|
wx[i].start = prevEnd;
|
|
wx[i].end = Math.max(prevEnd + 0.05, ns - 0.02);
|
|
}
|
|
}
|
|
if (wx.length) {
|
|
words = wx.filter((w) => w.text);
|
|
engine = `whisperx(${wxModel}+wav2vec2)`;
|
|
}
|
|
try {
|
|
fs.unlinkSync(wav);
|
|
} catch {}
|
|
} catch (e) {
|
|
console.error(
|
|
`[transcribe] whisperx unavailable (${String(e.message || e).slice(0, 160)}) — falling back to whisper.cpp`,
|
|
);
|
|
}
|
|
}
|
|
|
|
if (!words) {
|
|
// run hyperframes Whisper → writes a flat word array to <dir>/transcript.json
|
|
const cli = hfCli();
|
|
const args = ["transcribe", audio, "-d", project, "--json", "--model", model];
|
|
if (language) args.push("--language", language);
|
|
let info = {};
|
|
try {
|
|
const so = cp.execFileSync("node", [cli, ...args], { encoding: "utf8" });
|
|
const line = so.trim().split("\n").filter(Boolean).pop();
|
|
info = JSON.parse(line);
|
|
} catch (e) {
|
|
console.error("[transcribe] hyperframes whisper failed:", e.message);
|
|
process.exit(1);
|
|
}
|
|
const flatPath = info.transcriptPath || out;
|
|
const flat = JSON.parse(fs.readFileSync(flatPath, "utf8"));
|
|
const arr = Array.isArray(flat) ? flat : flat.words || [];
|
|
words = arr
|
|
.filter((w) => (w.text ?? w.word) != null)
|
|
.map((w) => ({
|
|
text: w.text ?? w.word,
|
|
start: w.start ?? w.t0,
|
|
end: w.end ?? w.t1,
|
|
type: "word",
|
|
}));
|
|
// Under the default --engine auto the CLI may have run Parakeet; it reports which.
|
|
engine = info.engine === "parakeet" ? `parakeet(${info.model})` : `whisper.cpp(${model})`;
|
|
}
|
|
|
|
// Tail-hallucination guard: drop words whisper placed entirely inside a terminal
|
|
// silence (it fabricates e.g. repeated "I'm sorry." over dead air). Word START past
|
|
// the audible end (+0.4s slack) = fabricated; real final words start before it.
|
|
const ae = audibleEnd(audio);
|
|
let trimmedTail = 0;
|
|
if (ae && ae.speechEnd < ae.total - 0.8) {
|
|
const keep = words.filter((w) => w.start <= ae.speechEnd + 0.4);
|
|
trimmedTail = words.length - keep.length;
|
|
if (trimmedTail > 0) {
|
|
console.error(
|
|
`[transcribe] ⚠ trimmed ${trimmedTail} trailing word(s) starting after the audible end ` +
|
|
`(${ae.speechEnd.toFixed(2)}s; clip ${ae.total.toFixed(2)}s) — whisper hallucinates over silent tails.`,
|
|
);
|
|
words = keep;
|
|
}
|
|
}
|
|
|
|
if (audioIsScratch) fs.rmSync(audio, { force: true });
|
|
|
|
const text = words
|
|
.map((w) => w.text)
|
|
.join(" ")
|
|
.replace(/\s+([,.!?;:])/g, "$1")
|
|
.trim();
|
|
fs.writeFileSync(
|
|
out,
|
|
JSON.stringify(
|
|
{
|
|
text,
|
|
language_code: language || "en",
|
|
engine,
|
|
words,
|
|
...(trimmedTail ? { trimmed_tail_words: trimmedTail } : {}),
|
|
},
|
|
null,
|
|
2,
|
|
),
|
|
);
|
|
console.log(`[transcribe] ${engine} ${words.length} words → ${out}`);
|
|
console.log(`[transcribe] text: ${text.slice(0, 160)}${text.length > 160 ? "…" : ""}`);
|
|
|
|
// No-speech guard: whisper returns confident hallucinations over silence (e.g. the
|
|
// whole clip as "Thank you."). The decision gate REFUSES "no speech" — operationalize
|
|
// it so an agent trusting the transcript can't sail past the gate.
|
|
const meanDb = meanVolumeDb(audio);
|
|
if (meanDb != null && meanDb < -45) {
|
|
console.error(
|
|
`\n[transcribe] ⚠ NEAR-SILENT AUDIO — mean ${meanDb.toFixed(1)} dB (real speech ≈ -16..-26 dB).`,
|
|
);
|
|
console.error(
|
|
` This transcript is almost certainly a Whisper hallucination, NOT real speech.`,
|
|
);
|
|
console.error(
|
|
` Per the decision gate, REFUSE "no speech" — confirm with \`ffmpeg -i <src> -af silencedetect\`;`,
|
|
);
|
|
console.error(` do NOT author captions from fabricated words.`);
|
|
}
|
|
}
|
|
main();
|