Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Render TikTok-style animated pill captions onto short-form videos using MoviePy + PIL. Takes a base MP4, a captions JSON, and optional background audio — out...
Render TikTok-style animated pill captions onto short-form videos using MoviePy + PIL. Takes a base MP4, a captions JSON, and optional background audio — out...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Animated pill-style caption overlays for short-form video. No Premiere, no CapCut — pure Python.
uv run --with moviepy --with pillow scripts/overlay.py \ --video base.mp4 \ --output final.mp4 \ --captions scripts/example_captions.json \ --audio music.mp3 \ --audio-start 8 \ --audio-vol 0.5 No --audio if you want to keep the original video audio.
--font-black /path/to/Montserrat-Black.ttf \ --font-bold /path/to/Montserrat-Bold.ttf Falls back to Montserrat from ~/.local/share/fonts/ if not specified.
Array of phases — each phase is a time window with one or more pill lines stacked vertically. [ { "start": 0, "end": 3.2, "y_frac": 0.06, "lines": [ { "text": "POV:", "size": 28, "bold": true, "bg": [0, 195, 255], "fg": [0, 0, 0], "bg_opacity": 0.9, "px": 20, "py": 9, "r": 12 }, { "text": "drink more water", "size": 50, "bg": [255, 255, 255], "fg": [0, 0, 0] } ] } ] FieldTypeDefaultDescriptionstartfloatrequiredPhase start time (seconds)endfloatrequiredPhase end time (seconds)y_fracfloat0.06Vertical position as fraction of video heightlines[].textstringrequiredCaption textlines[].sizeint50Font size (px)lines[].boldboolfalseUse bold font (vs black/heavy)lines[].bg[R,G,B][255,255,255]Pill background colorlines[].fg[R,G,B][0,0,0]Text colorlines[].bg_opacityfloat0.93Pill background opacity (0–1)lines[].pxint26Horizontal paddinglines[].pyint13Vertical paddinglines[].rint18Border radius
PIL's textbbox((0,0), text, font) returns (x0, y0, x1, y1) where y0 is a non-zero offset (typically 7–15px depending on font size). Drawing text at (x, y) without compensating for this offset causes text to appear below the pill's visual center. Fix implemented in pill(): bb = draw.textbbox((0, 0), text, font=font) x_off, y_off = bb[0], bb[1] vis_w = bb[2] - bb[0] # actual visual width vis_h = bb[3] - bb[1] # actual visual height # Compensate offsets when drawing text tx = cx - vis_w // 2 - x_off ty = y - y_off draw.text((tx, ty), text, font=font, fill=fg)
NotoColorEmoji.ttf fails with PIL at arbitrary sizes (bitmap font with limited supported sizes). Use text alternatives ("Free delivery" instead of "Free delivery 🚚") for reliable rendering.
See scripts/example_captions.json for the full 3-phase TikTok ad structure: Phase 1 (0–3.2s): Hook — top-screen pill stack Phase 2 (2.8–5.8s): Product claim — overlapping fade Phase 3 (5.3–8.0s): CTA — bottom-screen price + delivery + bio link
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.