geeklee/srt-whiteboard-animation

これは何？

主な機能

• 01SRT字幕を解析し、25〜35秒ごとのシーン分割を提案します。
• 02各領域を途切れないストロークで描画し、最初に輪郭線、次に色を塗ります。
• 03領域、タイミング、字幕との対応、重なりを保護する領域をJSONアノテーションファイルで管理します。
• 04領域、順序、タイミングを調整できるブラウザプレビュー画面を備えています。
• 05シーンごとにMP4へレンダリングし、複数のシーンを1本の動画に結合できます。

ユースケース

• 教育的な解説や講座の字幕を、手描き風のホワイトボード動画に変換する。
• シンプルなスケッチスタイルで、ナレーション付きのストーリーやショート動画を制作する。
• 各シーンが字幕の順序に沿って進む、知識共有用の動画を作成する。

クイックスタート

1. 1

   Python環境のセットアップを確認する

   python scripts/prepare_env.py --check
2. 2

   分離された仮想環境を準備する

   python scripts/prepare_env.py
3. 3

   SRT字幕を解析してシーン候補を作成する

   python scripts/parse_srt.py <字幕.srt> --target-sec 30 --min-sec 25 --max-sec 35
4. 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 は今もメンテナンスされていますか？

半年以内に更新あり。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