Demo Video Generator
概要
単一のプロンプトから、ナレーション、トランジション、CSSアニメーションを備えた1920x1080のデモ動画を生成します。Playwright(HTMLからフレームへのレンダリング)、FFmpeg(合成とトランジション)、Edge TTS(ニューラル音声合成)のMCPサーバーをオーケストレーションします。
前提条件
- Python 3.11以上および
uvパッケージマネージャー - FFmpegがインストールされていること(
ffmpeg -version) - Playwright Chromiumブラウザー(
uv run playwright install chromium) - Edge TTS音声合成のためのインターネット接続
インストール手順
マーケットプレイスからframecraftプラグインをインストールします:
claude plugin marketplace add jeremylongshore/claude-code-plugins-plus-skills
claude plugin install framecraft@claude-code-plugins-plus
クイックスタート
uv run python framecraft.py init my-demo # プロジェクトをスキャフォールド
uv run python framecraft.py render scenes.json --auto-duration
uv run python framecraft.py validate output.mp4 # 品質チェック
MCPオーケストレーション
Playwright、FFmpeg、Edge TTSのMCPサーバーが利用可能な場合、framecraftはそれらを直接オーケストレーションし、各フレームとオーディオセグメントを最大限に制御します。
パイプラインフォールバック
MCPサーバーが利用できない場合、framecraftはすべてを1回の呼び出しで処理するアトミックなCLIパイプラインを実行します。
ワークフロー
- ストーリーデザイン -- ナラティブアーク(問題解決、ヒーローズジャーニー、ビフォーアフター)を選択
- シーン作成 -- CSSアニメーション付きHTMLシーンを作成、または組み込みテンプレートを使用
- レンダリング -- Playwrightがフレームをキャプチャ、Edge TTSがナレーションを生成、FFmpegが合成
出力
- ナレーションとトランジション付きの1920x1080 MP4動画
- 反復調整のための個別シーンプレビュー
- 品質保証のための検証レポート
エラーハンドリング
| エラー | 原因 | 修正方法 |
|---|---|---|
ffmpeg: command not found | FFmpegがインストールされていない | brew install ffmpeg またはシステムのパッケージマネージャーでインストール |
playwright._impl._errors.Error | Chromiumがインストールされていない | uv run playwright install chromium を実行 |
edge_tts.exceptions.NoAudioReceived | TTSサービスが利用できない | インターネット接続を確認し、数秒後に再試行 |
FileNotFoundError: scenes.json | シーン設定ファイルがない | 最初に uv run python framecraft.py init my-demo を実行 |
| 空白または黒いフレーム | HTMLシーンのレンダリングに失敗 | HTMLの構文を確認し、アセットにアクセス可能であることを確認 |
例
{
"scenes": [
{
"title": "YourAppのご紹介",
"subtitle": "タスクを管理するスマートな方法",
"narration": "24のタスク。1つのダッシュボード。ストレスゼロ。",
"voice": "en-US-AndrewNeural",
"bullets": ["スマートな優先順位", "チーム同期", "ワンクリックレポート"],
"duration": 0
}
],
"output": "demo.mp4",
"width": 1920, "height": 1080,
"voice": "en-US-AndrewNeural",
"transition": "crossfade"
}
duration: 0 = TTSの長さから自動検出(1.5秒のバッファ付き)。
リソース
- テンプレートとパイプラインを含むソースリポジトリ: github.com/vaddisrinivas/framecraft
- Edge TTS音声リスト
- Playwrightドキュメント
- FFmpegドキュメント