CRITICAL GUIDELINES
Windows File Path Requirements
MANDATORY: Always Use Backslashes on Windows for File Paths
When using Edit or Write tools on Windows, you MUST use backslashes (\) in file paths, NOT forward slashes (/).
FFmpeg Karaoke & Animated Text
Use this skill for karaoke subtitles, kinetic typography, scrolling credits, animated lower thirds, typewriter text, timers, and dynamic text overlays. Keep answers practical: identify whether ASS or drawtext is the right tool, provide a copy-paste-ready command or ASS snippet, and call out timing units.
Quick Reference
| Effect |
Pattern |
| Karaoke ASS |
Use ASS format with \k, \kf, or \ko timing tags |
| Burn karaoke |
ffmpeg -i input.mp4 -vf "ass=karaoke.ass" -c:v libx264 -crf 18 -c:a copy output.mp4 |
| Scrolling credits |
-vf "drawtext=textfile=credits.txt:y=h-80*t" |
| Typewriter |
Stagger drawtext layers with enable='gte(t,...)' |
| Fade in text |
-vf "drawtext=text='Title':alpha='min(1,t/2)'" |
| Bouncing text |
-vf "drawtext=text='Bounce':y='h/2+50*sin(t*5)'" |
| Moving text |
-vf "drawtext=text='Move':x='w-mod(t*100,w+tw)'" |
| Rotation |
Use ASS (\frz, \frx, \fry); drawtext does not rotate text natively |
When to Use This Skill
Use for animated text and karaoke:
- Music video lyrics with karaoke highlighting
- Movie-style scrolling credits
- Animated titles and lower thirds
- Typewriter text reveal
- Kinetic typography and word pops
- Countdown timers, stopwatches, frame counters, timecode overlays
- Multi-line text and textfile-driven overlays
Tool Choice: ASS vs drawtext
| Need |
Best Tool |
Why |
| Word/syllable karaoke highlighting |
ASS |
Native \k, \kf, \ko support |
| Styled subtitles with outline/glow/rotation |
ASS |
Rich subtitle styling and transform tags |
| Simple overlay text |
drawtext |
Fast, direct FFmpeg filter |
| Timecode, frame numbers, metadata text |
drawtext |
Built-in variable expansion |
| Scrolling credits/news tickers |
drawtext |
Straightforward position expressions |
| Per-word kinetic captions |
ASS or multiple drawtext layers |
ASS is easier for rotation/scale; drawtext is direct for formula motion |
CRITICAL: ASS Time Unit Reference
ASS uses TWO DIFFERENT time unit systems. This is a common source of bugs. Karaoke tags use centiseconds; ASS animation tags use milliseconds; FFmpeg drawtext expressions use seconds.
Karaoke Tags = CENTISECONDS (1/100 second)
| Tag |
Unit |
Example |
Duration |
\k |
centiseconds |
{\k50} |
0.5 seconds |
\kf |
centiseconds |
{\kf100} |
1.0 second |
\ko |
centiseconds |
{\ko25} |
0.25 seconds |
Conversion: seconds * 100 = centiseconds.
Animation Tags = MILLISECONDS (1/1000 second)
| Tag |
Unit |
Example |
Duration |
\t(t1,t2,...) |
milliseconds |
\t(0,500,...) |
0-500ms animation |
\fad(in,out) |
milliseconds |
\fad(200,300) |
200ms in, 300ms out |
\move(x1,y1,x2,y2,t1,t2) |
milliseconds |
\move(0,0,100,100,0,1000) |
1 second move |
Conversion: seconds * 1000 = milliseconds.
FFmpeg drawtext = SECONDS
| Expression |
Unit |
Example |
t |
seconds |
t=2.5 means 2.5 seconds |
enable='between(t,0,3)' |
seconds |
visible from 0-3 seconds |
alpha='min(1,t/2)' |
seconds |
fade over 2 seconds |
Common Mistake
; WRONG - mixing units:
Dialogue: 0,0:00:00.00,0:00:02.00,Style,,0,0,0,,{\k100\t(0,100,...)}Word
; {\k100} = 1 second, but \t(0,100,...) = 0.1 seconds
; CORRECT - matched duration:
Dialogue: 0,0:00:00.00,0:00:02.00,Style,,0,0,0,,{\k100\t(0,1000,...)}Word
For the full timing-unit reference, use ffmpeg-animation-timing-reference.
Karaoke Core Pattern
[Script Info]
ScriptType: v4.00+
PlayResX: 1920
PlayResY: 1080
[V4+ Styles]
Format: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, OutlineColour, BackColour, Bold, Italic, Underline, StrikeOut, ScaleX, ScaleY, Spacing, Angle, BorderStyle, Outline, Shadow, Alignment, MarginL, MarginR, MarginV, Encoding
Style: Karaoke,Arial,72,&H00FFFFFF,&H000000FF,&H00000000,&H80000000,1,0,0,0,100,100,0,0,1,3,2,2,10,10,50,1
[Events]
Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
Dialogue: 0,0:00:01.00,0:00:05.00,Karaoke,,0,0,0,,{\k50}Twinkle {\k50}twinkle {\k50}little {\k50}star
Burn into video:
ffmpeg -i input.mp4 \
-vf "ass=karaoke.ass" \
-c:v libx264 -crf 18 -c:a copy \
output_karaoke.mp4
For advanced styles, neon/gradient karaoke, per-character timing, and animated karaoke transforms, see references/karaoke-ass-patterns.md.
drawtext Core Patterns
# Fade in title over 2 seconds
ffmpeg -i input.mp4 \
-vf "drawtext=text='Title':fontsize=100:fontcolor=white:x=(w-tw)/2:y=(h-th)/2:alpha='min(1,t/2)'" \
output.mp4
# Vertical bounce
ffmpeg -i input.mp4 \
-vf "drawtext=text='BOUNCE':fontsize=80:fontcolor=yellow:x=(w-tw)/2:y='(h-th)/2+50*sin(t*5)'" \
bounce.mp4
# Scroll credits upward at 80px/sec
ffmpeg -i input.mp4 \
-vf "drawtext=textfile=credits.txt:fontsize=48:fontcolor=white:x=(w-tw)/2:y=h-80*t" \
-c:v libx264 -crf 18 output.mp4
For spring/elastic/wobble formulas, typewriter effects, lower thirds, countdowns, stopwatches, metadata overlays, and multi-line text, see references/drawtext-animation-recipes.md.
Workflow
- Choose ASS or drawtext using the tool-choice table.
- Verify timing units before writing tags or expressions.
- Probe input when needed (
ffprobe) to confirm duration, frame rate, and resolution.
- Set output encoding explicitly when burning text (
-c:v libx264 -crf 18, audio copy only when compatible).
- Use short test renders (
-ss, -t) before rendering a full music video or credit roll.
- Check readability: karaoke should track words within ~30ms; captions need enough display time; scrolling credits should move slowly enough to read.
Reference Map
references/karaoke-ass-patterns.md - ASS karaoke basics, \k / \kf / \ko, BPM timing, tag selection, neon/gradient styles, per-character karaoke, ASS color format, animated karaoke effects.
references/drawtext-animation-recipes.md - Spring bounce, elastic overshoot, easing approximations, wobble/wiggle, pulse, wipes, typewriter, fades, moving text, kinetic typography, lower thirds, countdowns, stopwatches, dynamic variables, multi-line text.
references/scrolling-credits-and-expressions.md - Music/education/credits timing, vertical credits, horizontal tickers, ASS rotation workaround, drawtext variables and expression cookbook.
Related Skills
ffmpeg-animation-timing-reference - Timing units, caption durations, easing, sync tolerances
ffmpeg-captions-subtitles - Subtitle fundamentals, extraction, burn-in, styling
ffmpeg-kinetic-captions - Word-level pop/bounce/grow caption effects
viral-video-animated-captions - Social-video caption templates
ffmpeg-shapes-graphics - Boxes, backgrounds, graphic overlays
ffmpeg-transitions-effects - xfade and video transitions
1---
2name: ffmpeg-karaoke-animated-text
3description: |
4 Complete karaoke subtitle system and advanced animated text effects.
5 PROACTIVELY activate for: (1) Karaoke-style highlighted lyrics, (2) ASS/SSA advanced subtitle styling, (3) Scrolling credits (horizontal/vertical), (4) Typewriter text animation, (5) Bouncing/moving text, (6) Text fade in/out effects, (7) Word-by-word text reveal, (8) Kinetic typography, (9) Lower thirds animation, (10) Countdown timers and dynamic text.
6 Provides: ASS karaoke timing format, drawtext with time expressions, scrolling text patterns, text animation formulas, kinetic typography techniques, subtitle styling reference, multi-line animated text.
7metadata:
8 source: https://skillmd.com/skills/josiahsiegel/ffmpeg-karaoke-animated-text
9---
10
11## CRITICAL GUIDELINES
12
13### Windows File Path Requirements
14
15**MANDATORY: Always Use Backslashes on Windows for File Paths**
16
17When using Edit or Write tools on Windows, you MUST use backslashes (`\`) in file paths, NOT forward slashes (`/`).
18
19---
20
21# FFmpeg Karaoke & Animated Text
22
23Use this skill for karaoke subtitles, kinetic typography, scrolling credits, animated lower thirds, typewriter text, timers, and dynamic text overlays. Keep answers practical: identify whether ASS or `drawtext` is the right tool, provide a copy-paste-ready command or ASS snippet, and call out timing units.
24
25## Quick Reference
26
27| Effect | Pattern |
28|--------|---------|
29| Karaoke ASS | Use ASS format with `\k`, `\kf`, or `\ko` timing tags |
30| Burn karaoke | `ffmpeg -i input.mp4 -vf "ass=karaoke.ass" -c:v libx264 -crf 18 -c:a copy output.mp4` |
31| Scrolling credits | `-vf "drawtext=textfile=credits.txt:y=h-80*t"` |
32| Typewriter | Stagger `drawtext` layers with `enable='gte(t,...)'` |
33| Fade in text | `-vf "drawtext=text='Title':alpha='min(1,t/2)'"` |
34| Bouncing text | `-vf "drawtext=text='Bounce':y='h/2+50*sin(t*5)'"` |
35| Moving text | `-vf "drawtext=text='Move':x='w-mod(t*100,w+tw)'"` |
36| Rotation | Use ASS (`\frz`, `\frx`, `\fry`); `drawtext` does not rotate text natively |
37
38## When to Use This Skill
39
40Use for animated text and karaoke:
41
42- Music video lyrics with karaoke highlighting
43- Movie-style scrolling credits
44- Animated titles and lower thirds
45- Typewriter text reveal
46- Kinetic typography and word pops
47- Countdown timers, stopwatches, frame counters, timecode overlays
48- Multi-line text and textfile-driven overlays
49
50## Tool Choice: ASS vs drawtext
51
52| Need | Best Tool | Why |
53|------|-----------|-----|
54| Word/syllable karaoke highlighting | ASS | Native `\k`, `\kf`, `\ko` support |
55| Styled subtitles with outline/glow/rotation | ASS | Rich subtitle styling and transform tags |
56| Simple overlay text | `drawtext` | Fast, direct FFmpeg filter |
57| Timecode, frame numbers, metadata text | `drawtext` | Built-in variable expansion |
58| Scrolling credits/news tickers | `drawtext` | Straightforward position expressions |
59| Per-word kinetic captions | ASS or multiple `drawtext` layers | ASS is easier for rotation/scale; drawtext is direct for formula motion |
60
61---
62
63## CRITICAL: ASS Time Unit Reference
64
65**ASS uses TWO DIFFERENT time unit systems. This is a common source of bugs.** Karaoke tags use centiseconds; ASS animation tags use milliseconds; FFmpeg `drawtext` expressions use seconds.
66
67### Karaoke Tags = CENTISECONDS (1/100 second)
68
69| Tag | Unit | Example | Duration |
70|-----|------|---------|----------|
71| `\k` | centiseconds | `{\k50}` | 0.5 seconds |
72| `\kf` | centiseconds | `{\kf100}` | 1.0 second |
73| `\ko` | centiseconds | `{\ko25}` | 0.25 seconds |
74
75Conversion: `seconds * 100 = centiseconds`.
76
77### Animation Tags = MILLISECONDS (1/1000 second)
78
79| Tag | Unit | Example | Duration |
80|-----|------|---------|----------|
81| `\t(t1,t2,...)` | milliseconds | `\t(0,500,...)` | 0-500ms animation |
82| `\fad(in,out)` | milliseconds | `\fad(200,300)` | 200ms in, 300ms out |
83| `\move(x1,y1,x2,y2,t1,t2)` | milliseconds | `\move(0,0,100,100,0,1000)` | 1 second move |
84
85Conversion: `seconds * 1000 = milliseconds`.
86
87### FFmpeg drawtext = SECONDS
88
89| Expression | Unit | Example |
90|------------|------|---------|
91| `t` | seconds | `t=2.5` means 2.5 seconds |
92| `enable='between(t,0,3)'` | seconds | visible from 0-3 seconds |
93| `alpha='min(1,t/2)'` | seconds | fade over 2 seconds |
94
95### Common Mistake
96
97```ass
98; WRONG - mixing units:
99Dialogue: 0,0:00:00.00,0:00:02.00,Style,,0,0,0,,{\k100\t(0,100,...)}Word
100; {\k100} = 1 second, but \t(0,100,...) = 0.1 seconds
101
102; CORRECT - matched duration:
103Dialogue: 0,0:00:00.00,0:00:02.00,Style,,0,0,0,,{\k100\t(0,1000,...)}Word
104```
105
106For the full timing-unit reference, use `ffmpeg-animation-timing-reference`.
107
108---
109
110## Karaoke Core Pattern
111
112```ass
113[Script Info]
114ScriptType: v4.00+
115PlayResX: 1920
116PlayResY: 1080
117
118[V4+ Styles]
119Format: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, OutlineColour, BackColour, Bold, Italic, Underline, StrikeOut, ScaleX, ScaleY, Spacing, Angle, BorderStyle, Outline, Shadow, Alignment, MarginL, MarginR, MarginV, Encoding
120Style: Karaoke,Arial,72,&H00FFFFFF,&H000000FF,&H00000000,&H80000000,1,0,0,0,100,100,0,0,1,3,2,2,10,10,50,1
121
122[Events]
123Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
124Dialogue: 0,0:00:01.00,0:00:05.00,Karaoke,,0,0,0,,{\k50}Twinkle {\k50}twinkle {\k50}little {\k50}star
125```
126
127Burn into video:
128
129```bash
130ffmpeg -i input.mp4 \
131 -vf "ass=karaoke.ass" \
132 -c:v libx264 -crf 18 -c:a copy \
133 output_karaoke.mp4
134```
135
136For advanced styles, neon/gradient karaoke, per-character timing, and animated karaoke transforms, see `references/karaoke-ass-patterns.md`.
137
138## drawtext Core Patterns
139
140```bash
141# Fade in title over 2 seconds
142ffmpeg -i input.mp4 \
143 -vf "drawtext=text='Title':fontsize=100:fontcolor=white:x=(w-tw)/2:y=(h-th)/2:alpha='min(1,t/2)'" \
144 output.mp4
145
146# Vertical bounce
147ffmpeg -i input.mp4 \
148 -vf "drawtext=text='BOUNCE':fontsize=80:fontcolor=yellow:x=(w-tw)/2:y='(h-th)/2+50*sin(t*5)'" \
149 bounce.mp4
150
151# Scroll credits upward at 80px/sec
152ffmpeg -i input.mp4 \
153 -vf "drawtext=textfile=credits.txt:fontsize=48:fontcolor=white:x=(w-tw)/2:y=h-80*t" \
154 -c:v libx264 -crf 18 output.mp4
155```
156
157For spring/elastic/wobble formulas, typewriter effects, lower thirds, countdowns, stopwatches, metadata overlays, and multi-line text, see `references/drawtext-animation-recipes.md`.
158
159## Workflow
160
1611. **Choose ASS or drawtext** using the tool-choice table.
1622. **Verify timing units** before writing tags or expressions.
1633. **Probe input when needed** (`ffprobe`) to confirm duration, frame rate, and resolution.
1644. **Set output encoding explicitly** when burning text (`-c:v libx264 -crf 18`, audio copy only when compatible).
1655. **Use short test renders** (`-ss`, `-t`) before rendering a full music video or credit roll.
1666. **Check readability**: karaoke should track words within ~30ms; captions need enough display time; scrolling credits should move slowly enough to read.
167
168## Reference Map
169
170- `references/karaoke-ass-patterns.md` - ASS karaoke basics, `\k` / `\kf` / `\ko`, BPM timing, tag selection, neon/gradient styles, per-character karaoke, ASS color format, animated karaoke effects.
171- `references/drawtext-animation-recipes.md` - Spring bounce, elastic overshoot, easing approximations, wobble/wiggle, pulse, wipes, typewriter, fades, moving text, kinetic typography, lower thirds, countdowns, stopwatches, dynamic variables, multi-line text.
172- `references/scrolling-credits-and-expressions.md` - Music/education/credits timing, vertical credits, horizontal tickers, ASS rotation workaround, `drawtext` variables and expression cookbook.
173
174## Related Skills
175
176- `ffmpeg-animation-timing-reference` - Timing units, caption durations, easing, sync tolerances
177- `ffmpeg-captions-subtitles` - Subtitle fundamentals, extraction, burn-in, styling
178- `ffmpeg-kinetic-captions` - Word-level pop/bounce/grow caption effects
179- `viral-video-animated-captions` - Social-video caption templates
180- `ffmpeg-shapes-graphics` - Boxes, backgrounds, graphic overlays
181- `ffmpeg-transitions-effects` - xfade and video transitions