zroeschen/Video-Production-Factory

HyperFrames CLI

すべてのコマンドは npx hyperframes で実行します。Node.js >= 22 および FFmpeg が必要です。

ワークフロー

1. スキャフォールディング — npx hyperframes init my-video
2. 作成 — HTML コンポジションを作成（hyperframes スキルを参照）
3. Lint — npx hyperframes lint
4. プレビュー — npx hyperframes preview
5. レンダリング — npx hyperframes render

プレビューの前に lint を実行してください。data-composition-id の欠落、トラックの重なり、未登録のタイムラインなどを検出できます。

スキャフォールディング

npx hyperframes init my-video                        # 対話型ウィザード
npx hyperframes init my-video --example warm-grain   # サンプルを選択
npx hyperframes init my-video --video clip.mp4        # 動画ファイルを指定
npx hyperframes init my-video --audio track.mp3       # 音声ファイルを指定
npx hyperframes init my-video --non-interactive       # プロンプトをスキップ（CI/エージェント向け）

テンプレート: blank、warm-grain、play-mode、swiss-grid、vignelli、decision-tree、kinetic-type、product-promo、nyt-graph

init は正しいファイル構造を作成し、メディアをコピーし、Whisper で音声を書き起こし、AI コーディングスキルをインストールします。手動でファイルを作成する代わりに使用してください。

Lint

npx hyperframes lint                  # カレントディレクトリ
npx hyperframes lint ./my-project     # 特定のプロジェクト
npx hyperframes lint --verbose        # 情報レベルの発見事項を表示
npx hyperframes lint --json           # 機械可読形式

index.html と compositions/ 内のすべてのファイルを lint します。エラー（修正必須）、警告（修正推奨）、情報（--verbose で表示）を報告します。

プレビュー

npx hyperframes preview                   # カレントディレクトリをサーブ
npx hyperframes preview --port 4567       # カスタムポート（デフォルト 3002）

ファイル変更時にホットリロードされます。ブラウザでスタジオが自動的に開きます。

レンダリング

npx hyperframes render                                # 標準 MP4
npx hyperframes render --output final.mp4             # 出力ファイル名を指定
npx hyperframes render --quality draft                # 高速イテレーション
npx hyperframes render --fps 60 --quality high        # 最終出力
npx hyperframes render --format webm                  # 透明な WebM
npx hyperframes render --docker                       # バイト単位で同一の出力

フラグ	オプション	デフォルト	備考
--output	パス	renders/名前_タイムスタンプ.mp4	出力パス
--fps	24, 30, 60	30	60fps はレンダリング時間が約2倍
--quality	draft, standard, high	standard	イテレーション中は draft 推奨
--format	mp4, webm	mp4	WebM は透明度をサポート
--workers	1-8 または auto	auto	各ワーカーが Chrome を起動
--docker	フラグ	off	再現可能な出力
--gpu	フラグ	off	GPU アクセラレーションエンコード
--strict	フラグ	off	lint エラー時に失敗
--strict-all	フラグ	off	エラーと警告の両方で失敗

品質ガイド: イテレーション中は draft、レビューは standard、最終出力は high。

音声書き起こし

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # 既存の字幕をインポート
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

テキスト読み上げ（TTS）

npx hyperframes tts "ここにテキスト" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # 全音声を一覧表示

トラブルシューティング

npx hyperframes doctor       # 環境をチェック（Chrome、FFmpeg、Node、メモリ）
 npx hyperframes browser      # バンドルされた Chrome を管理
npx hyperframes info         # バージョンと環境の詳細
npx hyperframes upgrade      # アップデートを確認

レンダリングに失敗した場合は、最初に doctor を実行してください。よくある問題: FFmpeg の欠落、Chrome の欠落、メモリ不足。

その他

npx hyperframes compositions   # プロジェクト内のコンポジションを一覧表示
npx hyperframes docs           # ドキュメントを開く
npx hyperframes benchmark .    # レンダリングパフォーマンスのベンチマーク