Skip to content

AbubakrChan/product-launch-motion / legacy

product-launch-motion-v1

Verified

Legacy v1 (voiceover-led, GSAP + HyperFrames). Use when making, directing or rescuing a product launch video, promo, teaser, demo reel, sizzle, feature-announcement film or animated product explainer built from code — and when an existing one looks basic, reads as a slideshow, has reveals that miss the voiceover, an invisible cursor, an inaudible sound effect, a clipped or too-quiet mix, or every video coming out looking the same. Covers SaaS, apps, hardware, e-commerce, dev tools, services. Keywords include motion design, storyboard, voiceover sync, kinetic typography, GSAP, HyperFrames, Remotion, film grain, LUFS, ffmpeg.

FileKindSize
CASE-STUDY.mdmarkdown12.8 KB
SKILL.mdskill md17.4 KB
assets/BRIEF.mdmarkdown3.0 KB
assets/STORYBOARD.mdmarkdown2.7 KB
assets/cues.example.jsonconfig3.2 KB
assets/film.example.jsonconfig3.4 KB
assets/frame-skeleton.htmlother17.3 KB
evals/BASELINE.mdmarkdown7.5 KB
evals/evals.jsonconfig5.3 KB
film-preview.webpbinary975.7 KB
references/01-renderer-contract.mdmarkdown14.8 KB
references/02-story-and-truth.mdmarkdown20.7 KB
references/03-word-locked-sync.mdmarkdown9.2 KB
references/04-motion-grammar.mdmarkdown19.6 KB
references/05-camera-3d-cursor.mdmarkdown12.4 KB
references/06-look-and-grade.mdmarkdown18.3 KB
references/07-sound-and-master.mdmarkdown10.3 KB
references/08-qa-and-direction.mdmarkdown11.7 KB
references/09-shot-catalog.mdmarkdown38.9 KB
references/10-traps.mdmarkdown14.6 KB
references/11-creative-direction.mdmarkdown17.4 KB
references/12-deliverables.mdmarkdown7.1 KB
scripts/assemble.mjsexecutablescript9.3 KB
scripts/level-sfx.mjsexecutablescript8.5 KB
scripts/master.shexecutablescript3.8 KB
scripts/transitions.mjsexecutablescript7.2 KB
scripts/verify-cue.shexecutablescript3.4 KB
scripts/wire-audio.mjsexecutablescript5.3 KB
scripts/wire-grade.mjsexecutablescript9.7 KB
scripts/word-timings.mjsexecutablescript4.6 KB
still-1.jpgbinary16.9 KB

scripts/word-timings.mjs

View on GitHub
#!/usr/bin/env node
// word-timings.mjs — turn word-level transcripts into the cue table the frames read.
//
// Law 2: every reveal is cued to the MEASURED start time of the word it illustrates.
// Estimates drift; a transcript of the file you are actually shipping does not.
//
// Accepts Whisper JSON (segments[].words[]), a flat words array, or an OpenAI-style
// verbose_json. Emits one normalised table keyed by frame id.
//
// usage:
//   # one file per frame, named <frame-id>.json
//   node scripts/word-timings.mjs --in transcripts/ --out audio_meta.json
//
//   # a single transcript for one frame
//   node scripts/word-timings.mjs --transcript 01.json --id 01-hook --out audio_meta.json
//
//   # print a paste-ready cue comment for a frame
//   node scripts/word-timings.mjs --out audio_meta.json --cues 01-hook

import { readFileSync, writeFileSync, readdirSync, existsSync } from "node:fs";
import { join, basename, extname } from "node:path";

const argv = process.argv.slice(2);
// `--help` prints the header comment above. One source of truth for the usage text, and it
// exits 0 — a --help that exits non-zero breaks every Makefile and CI job that wraps it.
if (argv.includes("--help") || argv.includes("-h")) {
  const doc = [];
  for (const line of readFileSync(new URL(import.meta.url), "utf8").split("\n").slice(1)) {
    if (!line.startsWith("//")) break;
    doc.push(line.replace(/^\/\/ ?/, ""));
  }
  console.log(doc.join("\n").trim());
  process.exit(0);
}

const flag = (name, fallback) => {
  const i = argv.indexOf(`--${name}`);
  return i === -1 ? fallback : argv[i + 1];
};

const OUT = flag("out", "audio_meta.json");
const inDir = flag("in", null);
const single = flag("transcript", null);
const singleId = flag("id", null);
const cuesFor = flag("cues", null);

// ── print mode: a paste-ready cue comment for a frame ────────────────────────
if (cuesFor) {
  if (!existsSync(OUT)) {
    console.error(`no table at ${OUT} — build it first`);
    process.exit(1);
  }
  const table = JSON.parse(readFileSync(OUT, "utf8"));
  const frame = table[cuesFor];
  if (!frame) {
    console.error(`no frame "${cuesFor}" in ${OUT}. Have: ${Object.keys(table).join(", ")}`);
    process.exit(1);
  }
  const line = frame.words.map((w) => w.w).join(" ");
  console.log(`/* VO: "${line}"`);
  const parts = frame.words.map((w) => `"${w.w}"@${w.start.toFixed(2)}`);
  for (let i = 0; i < parts.length; i += 6) {
    console.log(`   ${parts.slice(i, i + 6).join("  ")}`);
  }
  console.log(`   duration ${frame.duration.toFixed(3)}s                                   */`);
  process.exit(0);
}

/** Pull a flat [{w,start,end}] out of whatever shape the transcriber produced. */
function normalise(raw) {
  let words = [];
  if (Array.isArray(raw.words)) {
    words = raw.words;
  } else if (Array.isArray(raw.segments)) {
    words = raw.segments.flatMap((s) => s.words ?? []);
  } else if (Array.isArray(raw)) {
    words = raw;
  }
  const out = words
    .map((w) => ({
      w: String(w.word ?? w.w ?? w.text ?? "").trim(),
      start: Number(w.start ?? w.startTime ?? w.from),
      end: Number(w.end ?? w.endTime ?? w.to),
    }))
    .filter((w) => w.w && Number.isFinite(w.start));
  if (!out.length) {
    throw new Error("no word-level timestamps found — did you pass --word_timestamps True?");
  }
  return out;
}

const table = existsSync(OUT) ? JSON.parse(readFileSync(OUT, "utf8")) : {};
const added = [];

function addFile(file, id) {
  const raw = JSON.parse(readFileSync(file, "utf8"));
  const words = normalise(raw);
  const duration = Number(raw.duration ?? words[words.length - 1].end ?? 0);
  table[id] = { duration, words };
  added.push({ id, n: words.length, duration });
}

if (single) {
  if (!singleId) {
    console.error("--transcript needs --id <frame-id>");
    process.exit(1);
  }
  addFile(single, singleId);
} else if (inDir) {
  for (const f of readdirSync(inDir).filter((f) => extname(f) === ".json").sort()) {
    addFile(join(inDir, f), basename(f, ".json"));
  }
} else {
  console.error("pass --in <dir> or --transcript <file> --id <frame-id>");
  process.exit(1);
}

writeFileSync(OUT, `${JSON.stringify(table, null, 2)}\n`);

console.log(`✓ ${OUT}`);
for (const a of added) {
  console.log(`  ${a.id.padEnd(24)} ${String(a.n).padStart(4)} words  ${a.duration.toFixed(3)}s`);
}
console.log(`\nSpot-check the FIRST and LAST word of every line against the wav: transcribers`);
console.log(`clip leading consonants, and a wrong first word offsets an entire shot.`);
console.log(`\nPaste a cue comment into a frame with:  node scripts/word-timings.mjs --cues <frame-id>`);
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall