--- name: kinetic-typography description: Kinetic typography videos where big words are the visuals - slamming, stretching, stacking, splitting and swapping in time with a voiceover or music beat - rendered to MP4 at 9:16 or 16:9. Use for text-only explainers, hooks and title sequences, quotes, lyric or poem videos, announcements and word-by-word captions as the main design. Not for subtitles over other footage (use the platform's caption tools) or long reading-heavy slides (use data-story-charts or system-diagram-animation). license: MIT compatibility: HyperFrames (Node 22+, FFmpeg) with GSAP. Fonts from Google Fonts. --- # Kinetic Typography Make videos where the words themselves are the picture. A phrase lands, fills the frame, gets punched and is replaced by the next one, in rhythm. It should feel bold, fast and musical, like a poster that moves. ## Options | Option | Default | Notes | |---|---|---| | format | vertical 1080×1920 | or landscape 1920×1080, square 1080×1080 | | duration | 10–20 s | match the voiceover or the song section | | tone | punchy | `calm` (slides and fades of 0.4 s, fewer flips), `punchy` (default), `chaotic` (all caps, slams, shakes, a flip on every other phrase) | | rhythm | fixed tempo | or voiceover word times, or music beats | ## Brief (answer before planning) 1. What is the one sentence the viewer should remember? 2. Split the script into phrases of 1–4 words; mark one hero word per phrase. 3. Where does the energy peak (the phrase that gets the colour flip)? 4. What is the ending lockup (title, call to action, handle)? ## Reads sheet (write it with the beat list) For every beat, write the one thing the viewer must understand ("the robot can't fly", "the cache missed") and how long it stays readable. One read at a time. Text floors: a label stays at least 0.8 s, a sentence about 0.3 s per word once fully on screen. If the text won't fit the time, cut words rather than speed up. ## Motion discipline - Motion is causal: every move has a reason on screen (a click, a fall, a packet arriving), and the next move follows from it. - Pick one main direction of travel for the whole video and keep it. Use the other directions for meaning: up for success or conclusion, a zoom out for "here's the whole picture". - A scene's exit sets up the next entry: same axis, same direction, similar speed. Carry one object across the change instead of crossfading. - No idle filler motion (floating, breathing, wobbling) on diagrams, charts or text. If nothing should move, hold still; one deliberate camera drift is enough. - Easing: smooth ease-out for entries (`power2.out` to `power4.out`), quicker ease-in for exits (about 75% of the entry time). Entries at most 0.8 s. Total stagger for a group at most 0.5 s. Overshoot (`back.out`) only for small pops; no elastic or bounce. - One thing moves at a time when it matters; the eye can follow only one. - Add a 0.3–0.75 s beat of stillness right before the payoff. ## Style rules (always) These make it this style; keep them whatever the colours or words. 1. Type fills 50–80% of the frame width, because small text reads as captions, not as the visual. 2. One idea on screen at a time: 1–4 words, at most 3 lines. Everything else has left. 3. Every word arrives with a move (slam, slide, stretch, mask reveal, flip). Nothing simply fades in. 4. Changes land on a rhythm: a new word or move every 0.25–0.7 s, and keywords on the beat or the stressed syllable. 5. Contrast is extreme: near-black on off-white or the reverse, plus one accent colour for the key word only. 6. Each phrase gets one hero word: biggest, accent-coloured, or moving differently from the rest. ## Defaults (change freely) Fonts, colours, words, timing and background. If the user gives brand fonts or colours, theirs win. Precedence: user's brand or spec, then the explicit request, then these defaults. - Background `#111111`, text `#f4f1ea`, accent `#ff4d2e`. Flip to light-on-dark or dark-on-light per phrase for energy. - Display font: a heavy condensed face (Anton, Bebas Neue or Archivo Black), all caps for hero words. Support font: a heavy sans (Inter 800) for small connecting words. - Size: hero words 180–320 px in 9:16; small words 60–90 px. ## Setup (once) ```bash node -v # needs 22+ ffmpeg -version npx hyperframes init my-video --non-interactive --resolution portrait && cd my-video # landscape for 16:9 ``` Inside an existing empty folder use `npx hyperframes init . --non-interactive --resolution portrait`, then replace the generated `index.html` with the template below. ## Decide before building State these back to the user in one line before writing code. 1. **Aspect:** 9:16 (1080×1920) or 16:9 (1920×1080). Default is 9:16. 2. **Words and timing:** split the script into phrases of 1–4 words. With a voiceover, take times from its word timestamps (`npx hyperframes transcribe voice.wav`). Without one, give each phrase 0.6–1.4 s, and give hero words longer. 3. **Rhythm source:** voice (land on stressed syllables), music (land on beats; `npx hyperframes beats music.mp3`), or a fixed tempo (e.g. 120 BPM = a beat every 0.5 s). 4. **Hero word per phrase** and which move it gets. | Need | HyperFrames + GSAP (default) | Remotion | |---|:-:|:-:| | Word and letter moves, masks, stretches | yes | yes | | Timing from voice or beat data | yes (labels) | yes (frames) | | Runs with only Node and FFmpeg | yes | yes | | Licence | free | free up to 3 people, paid above | ## Move vocabulary | Move | How (GSAP) | Use for | |---|---|---| | Slam | `from {scale: 2.6, opacity: 0}`, `expo.out`, 0.22 s, plus a 6 px screen shake for 0.1 s | hero words | | Slide stack | lines `from {yPercent: 110}` inside `overflow:hidden` masks, stagger 0.06 s, `power4.out` 0.35 s | lists, two-line phrases | | Stretch | `scaleY: 1.6 → 1`, `transformOrigin: bottom`, `back.out(3)` 0.3 s | emphasis, verbs | | Letter cascade | letters `from {y: -120, rotation: -20, opacity: 0}`, stagger 0.025 s, `back.out(2)` | names, titles | | Flip swap | old word `rotationX: 90` out (0.12 s), new word `rotationX: -90 → 0` in (0.18 s) | X becomes Y | | Split | word halves slide apart `x: ±140` to reveal a smaller word between | contrasts | | Exit | `yPercent: -110` or `scale: 0.7, opacity: 0`, 0.15 s, `power2.in` | every phrase leaving | Exits are fast (0.12–0.18 s) and entrances are snappier than you think (0.18–0.35 s). Hold each phrase at least 0.35 s after it lands, so it can be read. ## Make it eye-catching - **Fill the frame.** Size words to the frame width, not to a font size. Condensed fonts at 250+ px are the look. - **Colour flips:** the background swaps between dark and light (or to the accent) on 2–3 key phrases, as a hard cut on the beat. - **Texture and depth:** a subtle grain overlay, a soft shadow or offset duplicate behind hero words (accent colour, offset 10–14 px), and an occasional giant faded word in the background. - **Camera energy:** a slow 2–4% scale drift on the whole stage, a punch-in (scale 1.06 for 0.1 s) on hero hits, and a 6–10 px shake on slams. - **Shapes with words:** underline bars that draw in, circles that pop behind a word, arrows. Accent colour, flat. - **End on a lockup:** the title or call to action, fully composed, held 1–1.5 s, matching the opening frame so it loops. - **Quality gate:** if any snapshot shows small centred text on a plain background, it isn't done. ## Build: template ```html