srt-whiteboard-animation

Convert SRT subtitles into whiteboard hand-drawn animation videos with streaming ink strokes.

Updated Aug 16, 2026
One-click install
npx skills add https://github.com/chuanyue98/skillhub --skill srt-whiteboard-animation-chuanyue98
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: srt-whiteboard-animation
Source: https://github.com/chuanyue98/skillhub/tree/main/vendored/geeklee/srt-whiteboard-animation
Command: npx skills add https://github.com/chuanyue98/skillhub --skill srt-whiteboard-animation-chuanyue98

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires opencv-python, numpy, av, Pillow, and includes scripts (resource) and assets (resource) components.

What problem does it solve? Turning subtitle scripts into engaging whiteboard-style hand-drawn videos normally requires manual storyboarding, illustration, region masking, and frame-by-frame animation work. This Skill automates the full pipeline from SRT subtitles to a finished MP4 with continuous pen-stroke drawing. ## Core Features & Use Cases - SRT Parsing and Storyboarding: Parses SRT subtitle files and groups cues into 25-35 second scenes with suggested durations and illustration strategies. - Semantic Region Annotation: Creates annotation.json files mapping image regions to subtitle events with sequence, timing, and protected overlap regions, editable in a browser-based preview tool. - Streaming Ink Rendering: Renders each region with continuous pen strokes (ink line art then color fill) using grid or skeleton path tracing, then merges multiple scenes into one MP4. - Use Case: A course creator has a 3-minute narrated script as an SRT file and wants a warm paper-textured whiteboard animation video; the Skill splits it into scenes, generates consistent line art, annotates drawing order by narrative, and renders the final video. ## Quick Start Use this Skill to turn my SRT subtitle file into a whiteboard hand-drawn animation video, starting by parsing the subtitles and proposing a storyboard.

Frequently Asked Questions about srt-whiteboard-animation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn SRT subtitles into a whiteboard animation video?▼

Parse the SRT file with parse_srt.py to get scene suggestions, generate line art per scene, annotate regions in annotation.json, then render each scene with render_stream_whiteboard.py and merge scenes with merge_scenes.py into a final MP4.

What Python dependencies does whiteboard animation rendering need?▼

The renderer requires opencv-python, numpy, PyAV, and Pillow. Run scripts/prepare_env.py to create an isolated virtual environment and install all dependencies automatically, then use the printed ENV_PY interpreter for rendering.

Can I adjust the drawing order and timing of whiteboard animation regions?▼

Yes, open assets/preview.html in Chrome or Edge, load the folder containing your images and annotation.json files, then drag regions, reorder modules, edit start and end times, and save changes back to the annotation files.

What is the difference between grid and skeleton ink path modes?▼

Grid mode traces ink through cell centers of a grid and is the stable default for any image. Skeleton mode uses Zhang-Suen thinning to trace 1-pixel stroke centerlines, producing pen strokes that follow line art more closely on clean illustrations.

Why do overlapping regions appear too early in my whiteboard video?▼

Early reveal happens when a region rectangle overlaps later content without protection. Add protectedRegions with integer pixel coordinates to the earlier element's reveal config so the renderer masks those areas until their scheduled time.