Log in
TechniqueBy HypernaturalVersion 5, updated

Synthesized SFX for motion graphics

hn/python-synth-sfx-for-motion-graphics

Add sound effects to a motion-graphics or interactive-titles cut: cue each sound from the hn4a-compositor build, synthesize it from a 24-sound kinetic-type palette (pops, clicks, stamps, impacts, bass drops, thwacks, squashes, splats, boings, panned whooshes, risers, record scratches, glitches, dings, confetti cannons) locally with numpy/scipy (free), panned by where its graphic sits, and mix the track under the voice. Use for free, slightly cartoony effects that land exactly on graphics events, or SFX in place of the original audio; for realistic or described sounds use elevenlabs-sound-effects (guide-add-sound-effects weighs the two).

SKILL.md

Effects made in Python, free, and mixed by the compositor. They come out clean and a little cartoony, which suits kinetic type. For realistic foley or a sound described in words, generate it with elevenlabs-sound-effects (guide-add-sound-effects weighs the two), or use the person's own files, placed at the same cues. If the person has brand sounds or a sonic logo, use them in place of the synthesized ones.

1. Cues from the spec, not by ear

Have the build script write the cue list as it writes the spec, so a re-timed spec re-cues the sound: a layer's start (entrance), end (exit), the key where a box height reaches its minimum (flat), the contact time where x keys start moving (hit), each with the x where its graphic sits. One sound per visible event; leave space between them, and vary the sound by kind of graphic (one sound repeated 8+ times in 20 s grates).

2. The palette

references/sfx.md holds 24 recipes and the mixer. Pick by event:

EventSounds
A title or badge pops in; blinks outpop; down_pop
A label, a cursor, a counter stepclick, tick; type_key repeated at the typing's rate
A title card, an end cardblip (8-bit), ding on a check or "done"
A highlight or revealsparkle; riser into it
A word slams down, a stamp lands, the hero wordimpact, stamp, bass_drop
A hand hits a title; it's squashed; pressed flatthwack; squash; splat
Something drops on a head, bouncesbonk, boing
Something flies past or offwhoosh, panned with to_x from the hit side to the exit side
A stop, a glitch, a slicerecord_scratch, glitch, snip
Applause, confetti, a title crushedclap, cannon, crumple

The six recipes the first job tuned by ear: a pop is a sine sweep from about 780 Hz up to 1600 Hz over 90 ms with an exponential decay (~38/s) and a 2–6 kHz noise tick; the squash a sawtooth from 260 Hz down to 70 Hz with an 18 Hz wobble, low-passed at 1.4 kHz, with a gated band-passed creak, getting louder as it flattens; the splat a 90 Hz falling thump (~14/s) with low-passed noise; the down-pop a sine from 900 to 300 Hz over 120 ms, quieter; the thwack a 140 Hz falling thump with a 0.8–5 kHz noise burst over 250 ms; the whoosh noise through a band-pass whose centre sweeps 400 Hz to 4 kHz over ~0.45 s.

3. Build the track

Write references/sfx.md's script into the job's scripts/ as sfx.py, as is; the build script writes work/sfx_cues.json (the format is in the reference) and then:

exec python scripts/sfx.py build work/sfx_cues.json audio/sfx.wav

Every sound's transient lands 10 ms before its cue, panned by its graphic's x (equal-power, ±0.8 at the frame edges); the sum is soft-limited where sounds stack and normalized to a −1 dBFS peak, 48 kHz stereo, the comp's exact length. The noise is seeded, so a rebuild sounds the same.

4. Mix it

In the spec, the effects under the voice: "audio": [{"src": "../audio/voice.wav", "start": 0, "trim": 0, "volume": 1}, {"src": "../audio/sfx.wav", "start": 0, "trim": 0, "volume": 0.6}]. With no voice (effects in place of the original sound), the effects alone at 1. To keep the original sound under the effects, list the footage as its own audio entry at a lower volume. Changing audio needs a whole render, not --into.

5. Check

  • After the render, run volumedetect on a stretch with no events: about -91 dB means the original audio is really gone.
  • You can't hear: put the render to the person with review_approve, each sound and its moment in brief, and ask them to listen. Adjust gain or swap a recipe per their notes, then rebuild from the script.

Workflows that use this skill

FAQs

Add sound effects to a motion-graphics or interactive-titles cut: cue each sound from the hn4a-compositor build, synthesize it from a 24-sound kinetic-type palette (pops, clicks, stamps, impacts, bass drops, thwacks, squashes, splats, boings, panned whooshes, risers, record scratches, glitches, dings, confetti cannons) locally with numpy/scipy (free), panned by where its graphic sits, and mix the track under the voice. Use for free, slightly cartoony effects that land exactly on graphics events, or SFX in place of the original audio; for realistic or described sounds use elevenlabs-sound-effects (guide-add-sound-effects weighs the two).

Install Hypernatural Desktop, a free Mac app, and connect it to Claude Code, Codex or Claude Desktop. Then describe the video you want and your agent finds the skill itself, or paste this page's link (https://hypernatural.ai/skill/hn/python-synth-sfx-for-motion-graphics) and it installs hn/python-synth-sfx-for-motion-graphics and follows it.

Nothing. The skill is free and runs with tools on your own Mac, like python, ffmpeg and hn4a-compositor.

Yes. Ask your agent to adjust it for your job, or to save its own version. You can publish your version under your own handle so anyone can install it.

Go make something cool.

Install the app, open your agent, describe the video. That's the whole onboarding.

Sticker HypernaturalSticker BannerSticker TVBoy