masihsultani/whiteboard-animator

これは何？

主な機能

• 01テキストを単語ごとに書き出し、輪郭を自動的になぞります。
• 02図形の大きさに応じて、ブラシストロークまたはスイープで塗りつぶします。
• 03付属のテキスト検出モデルを使ってCPU上で動作し、GPUもAPIキーも必要ありません。
• 04ナレーションファイルの長さに合わせて描画のタイミングを調整します。
• 05FFmpegを使って複数のシーンを1本のMP4に結合します。
• 06調整可能なパラメーターを備えたCLIとPython APIを提供します。

ユースケース

• 講義や解説動画向けに、図やホワイトボードのスケッチをアニメーション化する。
• ナレーション付きの教育コンテンツに、手描き風の描画演出を加える。
• コマンドラインからイラスト付きの複数シーンをまとめてレンダリングし、1本の動画にする。

クイックスタート

1. 1

   FFmpegをインストール（macOSではHomebrewを使用）

   brew install ffmpeg
2. 2

   PyPIからパッケージをインストール

   pip install whiteboard-animator
3. 3

   ホワイトボード画像を8秒のMP4にレンダリング

   whiteboard-animate sketch.png --duration 8 -o sketch.mp4

使う前に知っておきたいこと

• !FFmpegとffprobeを別途インストールし、PATHに追加する必要があります。
• !白い背景にマーカーで描いたようなイラストに最適です。写真や色付きの背景は、うまくアニメーション化されません。
• !ナレーションのペースはテキストから推定され、音声とは同期されないため、音声とのタイミングにずれが生じる場合があります。

トピック

よくある質問

whiteboard-animator とは？

ホワイトボード風の画像を、ナレーションに合わせたCPUレンダリングの手描き風MP4に変換するCLIツール兼Pythonライブラリ。 whiteboard-animatorは、白い背景にインクで描かれた完成画像から、手描きで描き上げていく動画を生成します。テキストは単語ごとに書き出し、輪郭はなぞり、図形はブラシストロークまたは斜め方向のスイープで塗りつぶします。枝分かれした線画は、ペンの経路を1本ずつ描画します。レンダリングはCPU上で実行でき、学習やAPIキーは不要です。付属のONNX CRAFTテキスト検出器で、テキストと図形を判別します。

whiteboard-animator は無料で使えますか？ライセンスは？

whiteboard-animator は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

whiteboard-animator は今もメンテナンスされていますか？

半年以内に更新あり。whiteboard-animator の最終コミットは 2026年9月8日 です。

whiteboard-animator は何に使えますか？

講義や解説動画向けに、図やホワイトボードのスケッチをアニメーション化する。 ナレーション付きの教育コンテンツに、手描き風の描画演出を加える。 コマンドラインからイラスト付きの複数シーンをまとめてレンダリングし、1本の動画にする。

whiteboard-animator のインストール方法は？

FFmpegをインストール（macOSではHomebrewを使用）: brew install ffmpeg PyPIからパッケージをインストール: pip install whiteboard-animator ホワイトボード画像を8秒のMP4にレンダリング: whiteboard-animate sketch.png --duration 8 -o sketch.mp4

whiteboard-animator はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/masihsultani/whiteboard-animator