AbubakrChan/product-launch-motion / legacy
product-launch-motion-v1
VerifiedLegacy 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.
scripts/verify-cue.sh
View on GitHub#!/usr/bin/env bash
# verify-cue.sh — prove a sound cue is actually present in the film you are shipping.
#
# Law 6, operationalised. A cue can be correct in the source, present in the assembled
# index, and still contribute nothing to the mix — that is exactly how an inaudible typing
# effect survived a release. The composition is not evidence. The delivered file is.
#
# usage:
# ./scripts/verify-cue.sh <master.mp4> <start_s> <dur_s> [previous-master.mp4]
#
# Prints two things:
# 1. WINDOW mean and peak across the whole window (and the previous master's, if given)
# 2. ENVELOPE peak per 100ms slice
#
# Read the ENVELOPE. A window peak only proves the cue is loud SOMEWHERE inside the window
# — it cannot see a cue that starts late. A levelled asset cut from a field recording often
# opens with room tone, so the sound lands hundreds of milliseconds after the animation it
# is supposed to punctuate. That defect passed a window-peak check in a real film: the peak
# was -1.4 dB and the first half of the typing was silent.
#
# For percussive cues (clicks, keystrokes, ticks) read PEAK, not mean: mean tells you a bed
# is present, peak tells you a transient is heard. A cue is audible when its transients land
# within roughly 12 dB of the narration in that window.
set -euo pipefail
# `--help` prints the header comment above — one source of truth for the usage text, and it
# exits 0 so wrapping this in a Makefile or CI job does not fail the build.
if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
sed -n '2,/^$/p' "$0" | sed -E 's/^# ?//'
exit 0
fi
FILE="${1:-}"
START="${2:-}"
DUR="${3:-}"
PREV="${4:-}"
if [[ -z "$FILE" || -z "$START" || -z "$DUR" ]]; then
echo "usage: ./scripts/verify-cue.sh <master.mp4> <start_s> <dur_s> [previous-master.mp4]" >&2
exit 1
fi
[[ -f "$FILE" ]] || { echo "no such file: $FILE" >&2; exit 1; }
measure() {
ffmpeg -hide_banner -ss "$2" -t "$3" -i "$1" -vn -af volumedetect -f null /dev/null 2>&1 \
| grep -E "mean_volume|max_volume" | sed -E 's/.*\] //' | tr '\n' ' '
}
peak_only() {
ffmpeg -hide_banner -ss "$2" -t "$3" -i "$1" -vn -af volumedetect -f null /dev/null 2>&1 \
| grep -E "max_volume" | sed -E 's/.*max_volume: //; s/ dB//'
}
END=$(awk -v s="$START" -v d="$DUR" 'BEGIN{printf "%.2f", s+d}')
printf 'window %ss → %ss\n\n' "$START" "$END"
echo "WINDOW"
if [[ -n "$PREV" ]]; then
[[ -f "$PREV" ]] || { echo "no such file: $PREV" >&2; exit 1; }
printf ' %-26s %s\n' "$(basename "$PREV")" "$(measure "$PREV" "$START" "$DUR")"
fi
printf ' %-26s %s\n' "$(basename "$FILE")" "$(measure "$FILE" "$START" "$DUR")"
echo
echo "ENVELOPE (peak per 100ms — the cue should start where the animation starts)"
SLICES=$(awk -v d="$DUR" 'BEGIN{printf "%d", (d/0.1)+0.999}')
for ((i = 0; i < SLICES; i++)); do
T=$(awk -v s="$START" -v i="$i" 'BEGIN{printf "%.3f", s + i*0.1}')
P=$(peak_only "$FILE" "$T" 0.1)
if [[ -n "$PREV" ]]; then
PP=$(peak_only "$PREV" "$T" 0.1)
printf ' t=%-8s %8s dB (was %8s dB)\n' "$T" "$P" "$PP"
else
printf ' t=%-8s %8s dB\n' "$T" "$P"
fi
done
echo
echo "If the first slices are much quieter than the rest, the cue starts LATE — the asset"
echo "probably has a silent head. Re-cut it from its first transient:"
echo " node scripts/level-sfx.mjs <asset> # auto-trims the head by default"
echo "If every slice is quiet, the SOURCE is too quiet for any cue volume to fix:"
echo " node scripts/level-sfx.mjs <asset> --bed <narration dB in this window>"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |