스토리 아이디어, 각본, 소설을 대본·스토리보드·캐릭터·영상 생성 에이전트의 협업으로 여러 장면의 영상으로 만드는 에이전트형 영상 생성 프레임워크입니다.
geeklee/srt-whiteboard-animation
SRT 자막을 따뜻한 베이지색 종이 배경의 손그림 화이트보드 애니메이션 영상으로 변환해 MP4로 내보내는 AI 스킬입니다.
- 스타
- 4,616
- 포크
- 720
- 열린 이슈
- 8
- 마지막 커밋
- 3개월 전
어떤 프로젝트인가요?
이 프로젝트는 SRT 자막 파일을 손으로 그린 화이트보드 스타일 애니메이션으로 변환하는 AI 에이전트 스킬입니다. 각 장면은 선화와 영역, 그리는 순서, 타이밍, 각 요소에 연결된 자막을 정의하는 주석 파일로 구성됩니다. 요소는 이야기 흐름에 따라 나타나며, 각 영역에서는 펜이 끊김 없이 선을 그립니다. 먼저 윤곽선을 그리고 그다음 색을 채웁니다.
작업은 단계별로 진행됩니다. 스킬이 SRT를 분석해 약 25~35초 길이로 장면을 나누도록 제안한 다음, 선화를 생성하고 주석을 작성합니다. 렌더링 전에 브라우저 기반 미리보기 페이지에서 사용자가 영역과 타이밍을 조정할 수 있습니다. 장면별로 MP4를 렌더링한 뒤 하나의 긴 영상으로 합칠 수도 있습니다. 결과물은 따뜻한 종이 배경과 짙은 회색 스케치 선을 사용하고, 빨강·주황·파랑은 포인트 색상으로 절제해 활용하는 미니멀한 스타일입니다.
프로젝트는 Python으로 작성되었으며 OpenCV를 사용합니다. 격리된 가상 환경을 준비하는 헬퍼 스크립트도 포함되어 있습니다.
핵심 기능
- 01SRT 자막을 분석하고 25~35초 길이의 장면 분할을 제안합니다.
- 02각 영역을 끊김 없는 선으로 그리며, 먼저 윤곽선을 그리고 그다음 색을 채웁니다.
- 03영역, 타이밍, 자막 연결 정보, 겹침 방지 영역을 JSON 주석 파일로 관리합니다.
- 04영역, 순서, 타이밍을 조정할 수 있는 브라우저 미리보기 페이지를 제공합니다.
- 05장면별로 MP4를 렌더링하고 여러 장면을 하나의 영상으로 합칩니다.
활용 사례
- 교육 설명이나 강의 자막을 손그림 화이트보드 영상으로 변환하기.
- 간단한 스케치 스타일의 내레이션 스토리나 숏폼 영상 콘텐츠 제작하기.
- 각 장면이 자막 순서에 맞춰 진행되는 지식 공유 영상 만들기.
빠른 시작
- 1
Python 환경 설정을 확인합니다
python scripts/prepare_env.py --check - 2
격리된 가상 환경을 준비합니다
python scripts/prepare_env.py - 3
SRT 자막을 파싱해 장면 후보를 만듭니다
python scripts/parse_srt.py <字幕.srt> --target-sec 30 --min-sec 25 --max-sec 35 - 4
스트림 렌더러로 장면을 MP4로 렌더링합니다
<ENV_PY> scripts/render_stream_whiteboard.py <图片路径> <标注路径> <输出.mp4> assets/drawing-hand.png --ink-path grid --color-fill contour-wipe
사용 전 알아둘 점
- 각 장면마다 직접 만든 어노테이션 파일이 필요하므로 워크플로에 많은 수작업이 필요합니다.
- 렌더링 전에 여러 단계에서 확인을 거쳐야 하므로 완전히 자동화되어 있지 않습니다.
- 이 프로젝트는 AI 에이전트 스킬로 작성되어 워크플로에서 AI 어시스턴트를 전제로 합니다.
토픽
자주 묻는 질문
- srt-whiteboard-animation은(는) 무엇인가요?
- SRT 자막을 따뜻한 베이지색 종이 배경의 손그림 화이트보드 애니메이션 영상으로 변환해 MP4로 내보내는 AI 스킬입니다. 이 프로젝트는 SRT 자막 파일을 손으로 그린 화이트보드 스타일 애니메이션으로 변환하는 AI 에이전트 스킬입니다. 각 장면은 선화와 영역, 그리는 순서, 타이밍, 각 요소에 연결된 자막을 정의하는 주석 파일로 구성됩니다. 요소는 이야기 흐름에 따라 나타나며, 각 영역에서는 펜이 끊김 없이 선을 그립니다. 먼저 윤곽선을 그리고 그다음 색을 채웁니다.
- srt-whiteboard-animation은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- srt-whiteboard-animation은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- srt-whiteboard-animation은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. srt-whiteboard-animation의 마지막 커밋은 2026년 7월 27일입니다.
- srt-whiteboard-animation은(는) 어디에 사용할 수 있나요?
- 교육 설명이나 강의 자막을 손그림 화이트보드 영상으로 변환하기. 간단한 스케치 스타일의 내레이션 스토리나 숏폼 영상 콘텐츠 제작하기. 각 장면이 자막 순서에 맞춰 진행되는 지식 공유 영상 만들기.
- srt-whiteboard-animation는 어떻게 설치하나요?
- Python 환경 설정을 확인합니다: python scripts/prepare_env.py --check 격리된 가상 환경을 준비합니다: python scripts/prepare_env.py SRT 자막을 파싱해 장면 후보를 만듭니다: python scripts/parse_srt.py <字幕.srt> --target-sec 30 --min-sec 25 --max-sec 35 스트림 렌더러로 장면을 MP4로 렌더링합니다: <ENV_PY> scripts/render_stream_whiteboard.py <图片路径> <标注路径> <输出.mp4> assets/drawing-hand.png --ink-path grid --color-fill contour-wipe
- srt-whiteboard-animation은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/geeklee/srt-whiteboard-animation
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
텍스트-비디오 및 이미지-비디오 생성 모델을 다양한 품질·의미 차원에서 점수화하는 벤치마크 모음이자 평가 툴킷입니다.
주제, 글, 이야기를 손그림 애니메이션과 중국어 손글씨가 담긴 해설 영상으로 만드는 Codex 및 Claude Code 스킬
Gemini로 중국어 대사나 추상적인 아이디어를 펜 선 스케치 설명 애니메이션 에셋으로 만드는 Codex Skill입니다.
주제를 내레이션, 하드 자막, 커버 이미지가 포함된 설명 영상으로 만들고 HTML 프레임을 로컬에서 MP4로 렌더링하는 Agent Skill입니다.
대화 기록만 재생하는 대신 기억을 저장·회상·성찰해 AI 에이전트가 시간이 지날수록 학습하도록 돕는 에이전트 메모리 시스템입니다.