AI 도구

SRT 화이트보드 애니메이션 — AI가 못 그리던 그림,
자막 하나로 손글씨 영상 만들기

2026년 8월 14일 · 자비스스튜디오

Claude도, ChatGPT도 직접 그림을 그려주지는 못합니다. 이미지 생성 API는 유료고, 무료 대안은 품질이 들쭉날쭉하죠.
srt-whiteboard-animation은 SRT 자막 파일 하나만 넣으면 따뜻한 크래프트지 위에 손글씨가 써지는 화이트보드 애니메이션 MP4를 만들어줍니다. 파이썬 + OpenCV 기반, MIT 라이선스, API 비용 0원.
SRT 화이트보드 애니메이션 파이프라인: 자막 → AI 분석 → 선화 생성 → 영상 렌더 → 완성(비용 0원)
자막 파일 하나로 화이트보드 애니메이션이 만들어지는 전체 흐름. 비용은 0원.

왜 이 도구가 필요한가

AI 코딩 에이전트(Claude Code, Cursor 등)를 쓰다 보면 한 가지 벽에 부딪힙니다. 텍스트는 잘 만들어주는데, 그림은 못 그린다는 것. DALL-E나 Midjourney를 연동하면 가능하지만 유료이고, 스타일도 화이트보드형 교육 콘텐츠와는 거리가 멀어요.

그런데 생각을 뒤집어 보면 — AI가 정말 잘하는 건 텍스트(자막) 생성이잖아요. 교육 콘텐츠의 대본, 설명 스크립트, SRT 자막 파일 같은 것들이요. 만약 자막만 넣으면 알아서 그림이 그려진다면?

핵심 아이디어: AI가 잘하는 것(자막 생성) → 이 도구가 잘하는 것(자막을 그림으로) → AI가 못 하던 무료 영상 제작이 가능해집니다.

이런 소식, 남들보다 먼저 받으실 분?
직접 돌려보고 되는 것만 골라 매주 보내드립니다. 광고성 하이프는 거릅니다.

📮 뉴스레터 신청

srt-whiteboard-animation이 뭔가요

중국의 AI 빌더 geeklee가 만든 오픈소스 프로젝트입니다. GitHub에서 416개의 별, 70개의 포크를 받았고, MIT 라이선스라 상업적 사용도 자유롭습니다.

이름 그대로 SRT 자막 파일을 화이트보드 손글씨 애니메이션으로 변환합니다. 결과물은 따뜻한 미색(米色) 종이 배경 위에 펜이 움직이며 그림을 그리는 영상 — 교육 콘텐츠, 설명 영상, 스토리텔링에 딱 맞는 스타일이에요.

출력 스타일 미리보기
🏔️ 🐒 🍌 🎨
따뜻한 크래프트지(#F5EBD7) 위에 깊은 회색 펜으로 그린 미니멀 손그림.
빨강·주황·파랑은 포인트로만 — Notion 스타일의 절제된 일러스트.

어떻게 작동하나 — 전체 워크플로우

자막에서 영상까지, 7단계로 진행됩니다. 각 단계마다 사람이 확인하고 조정할 수 있어요.

📝
SRT 자막
AI가 생성
🔍
장면 분석
25~35초 단위
✏️
선화 생성
AI 그림
🗺️
영역 배치
annotation.json
🎬
MP4 렌더
손글씨 효과
SRT 자막 파싱 + 장면 전략
자막 파일을 넣으면 25~35초 단위로 장면을 나누고, 각 장면에 어떤 그림이 필요한지 전략을 짭니다. 그림을 그리기 전에 계획부터.
선화(Line Art) 생성
전략이 승인되면 각 장면의 선화 이미지(PNG)를 생성합니다. 미색 종이 위에 깊은 회색 펜 — 미니멀 손그림 스타일.
시맨틱 영역 주석(Annotation)
자막 이벤트 순서에 맞게 그림의 어느 영역을 언제 보여줄지 결정합니다. 마스크 분할 + 순서·타이밍이 annotation.json에 저장됩니다.
브라우저 프리뷰에서 조정
내장 HTML 프리뷰 도구(preview.html)에서 영역, 순서, 타이밍을 눈으로 보며 조정합니다. 코딩 없이 드래그앤드롭.
MP4 렌더링 + 장면 병합
잉크(선) → 색상 순서로 스트리밍 렌더링. 손 커서가 따라 움직이며, 여러 장면을 하나의 MP4로 병합합니다.

핵심 기술 — 마스크 분할 + 스트리밍 잉크

이 도구의 렌더링은 두 가지 핵심 기술로 작동합니다:

🎭
분구(分區) 마스크 편성
그림을 의미 단위 영역으로 나누고, 각 영역에 마스크를 씌워 자막 타이밍에 맞게 순차적으로 드러냅니다. 배경 → 주요 인물 → 액션 → 결과 순서로.
🖊️
스트리밍 잉크 드로잉
먼저 잉크(선화)가 그려지고, 이어서 색상이 채워지는 2단계 방식. 잉크:색상 비율 2:1. 프레임마다 끊기지 않고 연속으로 펜이 흘러갑니다.

annotation.json — 이게 핵심입니다

각 장면의 렌더링 설정은 annotation.json 파일로 제어됩니다. 자막 텍스트, 영역 좌표, 드러나는 방향과 타이밍이 모두 여기에.

{ "sceneId": "scene-01", "canvas": { "width": 1672, "height": 941 }, "sceneDurationMs": 9000, "elements": [{ "sequence": 1, "subtitle": "자막 텍스트", "region": { "x": 20, "y": 120, "width": 540, "height": 780 }, "reveal": { "direction": "top_to_bottom", "startMs": 300, "durationMs": 2600 } }] }

sequence로 순서, reveal로 드러나는 방향·시작·지속 시간을 정합니다. 브라우저 프리뷰 도구에서 시각적으로 조정할 수도 있어요.

설치하고 써보기

요구 사항

설치

# 1. 저장소 클론 git clone https://github.com/geeklee/srt-whiteboard-animation.git cd srt-whiteboard-animation # 2. 환경 확인 및 설정 python scripts/prepare_env.py --check python scripts/prepare_env.py

기본 사용법

# 자막 파싱 (25~35초 단위 장면 분할) python scripts/parse_srt.py my-subtitle.srt --target-sec 30 --min-sec 25 --max-sec 35 # 프리뷰 이미지 생성 (영역 확인용) python scripts/render_annotation_preview.py scene-01.png scene-01.annotation.json preview.png # MP4 렌더링 (잉크→색상 스트리밍) python scripts/render_stream_whiteboard.py scene-01.png scene-01.annotation.json output.mp4 assets/drawing-hand.png --ink-path grid --color-fill contour-wipe # 여러 장면 병합 python scripts/merge_scenes.py --inputs scene1.mp4 scene2.mp4 --output final.mp4

AI 에이전트와 함께 쓰면 진짜 강력합니다

이 도구의 진짜 가치는 AI 에이전트 워크플로우에 끼워넣을 수 있다는 점입니다.

  1. Claude/ChatGPT가 교육 스크립트를 작성하고 SRT 자막 파일로 변환
  2. 이미지 생성 AI(Pollinations, DALL-E 등)가 장면별 선화 PNG를 생성
  3. srt-whiteboard-animation이 자막 + 선화를 합쳐 MP4로 렌더링

즉, 텍스트 생성 AI + 이미지 생성 AI + 이 렌더링 도구를 조합하면, 사람이 직접 그림 하나 그리지 않고도 교육 콘텐츠 영상이 완성됩니다.

실전 시나리오: "프로그래밍 기초 강의 10분짜리 만들어줘" → Claude가 대본 + SRT 자막 생성 → Recraft v4로 장면별 손그림 PNG 생성 → srt-whiteboard-animation으로 MP4 렌더링 → 유튜브에 업로드. 비용 0원.

실제 파이프라인 결과물: Recraft v4로 생성한 화이트보드 선화 이미지
실제 파이프라인 테스트 결과 — Recraft v4로 생성한 선화 이미지. 이 이미지가 자막 타이밍에 맞춰 순차적으로 그려지는 애니메이션이 됩니다.

어디에 쓸 수 있나

📚
교육 · 설명 영상
프로그래밍 개념, 과학 원리, 역사 이야기. 칠판에 그리듯 설명하는 화이트보드 강의 스타일.
📖
스토리텔링
동화, 우화, 에세이를 손그림 애니메이션으로. 아이들 콘텐츠, 브랜드 스토리에 적합.
🎯
마케팅 · 제품 소개
제품 기능을 하나씩 그려가며 설명하는 영상. 복잡한 개념을 단순하게 전달.
🌐
다국어 콘텐츠
자막만 바꾸면 같은 그림으로 영어·한국어·중국어 버전. SRT 기반이라 다국어 확장이 쉬움.

기존 도구와 비교

기준 srt-whiteboard-animation Doodly / VideoScribe 직접 제작
비용 0원 (오픈소스) 월 $20~$67 0원 (시간 비용)
자동화 CLI + AI 연동 가능 수동 GUI 전부 수동
자막 동기화 SRT 기반 자동 동기화 수동 타이밍 수동 타이밍
커스터마이징 annotation.json 완전 제어 템플릿 내 제한적 무제한
학습 난이도 CLI 사용, Python 필요 GUI 직관적 그림 실력 필요
라이선스 MIT (상업 사용 자유) 상업용 라이선스 별도 본인 저작

알아두면 좋은 것들

1. 선화(PNG)는 별도로 만들어야 합니다 — 이 도구는 자막→영상 렌더러이지, 그림을 그려주는 AI가 아닙니다. 선화 이미지는 직접 그리거나, 이미지 생성 AI를 사용하세요.

2. 중국어 기반 프로젝트 — README와 예시가 중국어입니다. 기능 자체는 언어와 무관하게 작동합니다.

3. 캔버스 크기 권장 — 1672×941px 해상도에 최적화되어 있습니다.

4. 매 단계 확인 필요 — "자막 → 영상"이 원클릭은 아닙니다. 각 단계를 확인하며 진행하는 구조예요. 품질 관리를 위한 의도적 설계입니다.

실제 적용 계획

자비스스튜디오에서는 이 도구를 다음과 같이 활용할 예정입니다:

SKILL.md가 포함되어 있습니다: 이 저장소에는 AI 에이전트가 바로 읽고 실행할 수 있는 SKILL.md 파일이 있습니다. Claude Code의 스킬로 등록하면 "이 자막으로 화이트보드 영상 만들어줘"라고 말하는 것만으로 워크플로우가 실행됩니다.

카드뉴스로 한눈에 보기

이 도구의 핵심 내용을 7장 카드뉴스로 정리했습니다. 인스타그램·X 등 SNS에서도 공유할 수 있어요.

자막 하나로, 영상 하나를

AI가 못 그리던 그림, 이제 SRT 자막 하나로 화이트보드 애니메이션이 됩니다.
오픈소스, MIT 라이선스, 비용 0원.

GitHub에서 시작하기 →

실측 위주 AI 뉴스레터 — 직접 돌려보고 되는 것만 골라 매주 보내드립니다.

#SRT화이트보드 #화이트보드애니메이션 #오픈소스 #AI영상제작 #무료영상도구 #Python #OpenCV #교육콘텐츠 #자비스스튜디오

카드뉴스로도 정리했습니다

인스타그램에 올린 7장입니다.

카드뉴스 1번 카드뉴스 2번 카드뉴스 3번 카드뉴스 4번 카드뉴스 5번 카드뉴스 6번 카드뉴스 7번