AI Edit Studio

AI Edit Studio — Director 0.10

クリエイター、ゲーム開発者、そしてエージェント向けのローカルファーストの動画エディターです。人間向けのプロ仕様のタイムラインと、エージェント向けの同じ59種類のツール（MCP、HTTP/OpenAPI、CLI）を、ひとつのエンジンで提供します。映像素材がマシンの外に出ることはありません。オリジナル素材は読み取りのみです。

以前の名称は Game Trailer Studio です。既存のプロジェクト、ストレージパス、GAME_TRAILER_STUDIO_* 設定、Start-Game-Trailer-Studio.* スクリプトは引き続き動作します。この README のオランダ語版はdocs/README.nl.mdにあります。

できること

0.10の新機能 — 音楽エンジン

• 編集に合わせた音楽を作曲（Audioタブ → 音楽を作曲、または studio_music）：6種類のスタイル（ポップドロップ、トラップ、ハウス、ローファイ、シンセウェーブ、シネマティックトレーラー）から選び、このコンピューター上で合成楽器を使ってオリジナル曲を作成します。サンプルもインターネット接続も不要で、無料で使用できます。編集とまったく同じ長さになり、ドロップはカット位置（または drop という名前のマーカー）にぴったり合い、最後のフレームでフィニッシュヒットが鳴ります。同じシードなら同じ曲になり、新しいバリエーションを選ぶと新しいメロディーとグルーヴになります。ビートグリッドは正確なので、ビートに合わせてカットをスナップすると実際のビートに合います。ステム（ドラム、ベース、音楽、エフェクト）も任意で利用できます。
• 自分の音楽も、SunoやUdioなどで作成した曲を含め、*選択…*からワンクリックで利用できます。
• オンライン生成（任意）：自分のElevenLabsキーを使用します。送信されるのはテキストプロンプトと長さのみです。
• 修正点：ディスクを埋め尽くす可能性があった効果音トラック、FFmpeg 4.xで読み込めなかったフィルタースクリプト、縦に伸びた履歴カード、右パネルのタブの表示切れ、スタート画面のツール数、タイムライン上のテキストを無視していたレビューのヒント。

0.9の新機能 — 仕上げ

• 見た目 — LUT（内蔵の6種類のルック、または独自の.cube。強度調整付き）、ショットごとの自動カラーおよびカメラマッチング、手ぶれショットのスタビライズ（2パスのvid.stab、一度だけ測定）。
• サウンド — 小節線に合わせた音楽のカットで編集とぴったり同じ長さに調整、ハム音・クリック音・クリッピング・ノイズの修復、ショットの音量を均一化、ローカルで作成する効果音（whoosh、hit、pop、riser…）、ミキシング用のステム、カットする代わりに再生速度を上げる無音部分の処理。
• トーキングヘッド — 強調部分でのズームやゆっくりしたプッシュイン、名前が話された箇所へのBロール配置、プログレスバー、登録・リンク用ポップアップ。
• ワークフロー — 多数のプロジェクトに対する一括操作、2つのバージョンを並べた1本の動画の作成。

0.8の新機能 — 長尺編集

• セグメント分割・キャッシュレンダー — 長尺編集は完成済みのセグメントごとにレンダリングされます。修正後は変更された部分だけを再レンダリングし、最後に短いパスでサウンドをミックスします。修正を確認するには、1つの部分だけ（I/O範囲）をレンダリングできます。
• フレーム単位で正確なカット — 多数のショットを含む編集でカット（およびそれに伴うキャプション、音声、音楽）が後ろにずれていくドリフトを修正しました。また、0.5～0.7でショットがわずかに早く始まることがあったインポイントの不具合も修正しました。以前に書き出した動画は再レンダリングしてください。
• アウトライン — ショットに紐づくチャプター：セクション全体を移動、削除、カラーグレーディングできます。チャプターはYouTubeチャプターになります。
• 映像素材を検索 — 話された内容（誤字を許容）、ラベル、マーカー、見どころを検索して、ワンクリックで挿入できます。
• 長さに合わせる — 45 → 30分、または3:12 → 2:59：無音部分、フィラーワード、最も弱い文章やショットから順に削除します。
• 台本 → ラフカット、音声同期＋マルチカム（話者に合わせて映像が切り替わります）、ショットにピン留めするレビュー用メモ、重い映像素材向けのプロキシ、Premiere/Resolve/Avid（EDL）、Final Cut/Resolve（FCPXML）、OTIO、ショットリストCSV、YouTubeチャプターへの引き継ぎ。すべて新しいLongタブとエージェント用ツールから利用できます。

0.7の新機能

• アニメーション字幕 — カラオケ風、ポップ、ハイライトマーカー、または一度に1語ずつ表示する字幕です。トランスクリプトに基づいて単語単位で正確に同期し、ブランドカラーとフォントで libass によりレンダリングします。エディターでライブプレビューできます。
• クリップ検索 — 長尺動画から、単体で完結する最適なクリップ（文単位で区切り）を抽出します。クリップごとにすぐ使えるプロジェクトを作成し、レンダリングをキューに登録します。
• レイヤー — 編集映像の上に B ロールのカットアウェイやピクチャーインピクチャーを追加できます。メインの音声はそのまま再生されます。
• サウンドとモーション — ショットごとの J/L カット、ビートに合わせたパンチインズーム、段階的な速度ランプ、フリーズフレーム。
• プロ向けオーディオ — 音声の補正（ノイズ除去、プレゼンス、ディエッサー）とマスタリング時のラウドネス目標値（デフォルトは −14 LUFS）。
• エージェント向け — レンダリングの QC（LUFS、ピーク、黒画面／フリーズ、無音）、レンダーキュー、ロングポーリングの studio_wait、ライブ SSE イベント、レシピ（1 回の呼び出しで複数ステップのワークフローを実行）。

0.6 の新機能

• ✦ ディレクターモード — プラットフォーム（TikTok、Reels、Shorts、フィード、YouTube、予告編、Vlog、映画）を選ぶと、完成した編集を作成します。無音部分と黒画面を削除し、3 つの候補から最も強力なフックを選び、トランジションとビート同期を追加し、音声から字幕を作成して、自動レビューで修正を適用し、縦型にリフレームして、各プラットフォーム向けにレンダリングします。他のフックを使った A/B テスト用プロジェクトも任意で作成できます。
• テキストで編集 — ローカル音声認識（whisper.cpp、初回のみ任意でインストール）を使って、トランスクリプト内の単語、フィラーワード、長い無音部分を削除したり、フレーズを検索したり、選択した箇所からペーパー編集を作成したりできます。字幕も連動します。
• スマートリフレーム — 9:16、1:1、4:5 では、ショットごとに測定した動きに合わせてクロップし、動きに応じてパンします。
• 公開パック — 動きが大きく鮮明なフレームから、タイトル入りのサムネイルとカバー画像、加工していない静止画、SRT/VTT、YouTube のチャプター、プラットフォームごとのタイトル／説明／ハッシュタグ案を作成します。投稿は一切行いません。
• ブランドキット — ロゴ（位置／サイズ／不透明度）、色、フォント、イントロとアウトロ、CTA、ハッシュタグを設定できます。ワンクリックまたはワンコールで適用できます。

エディター向け（http://127.0.0.1:32146/ を開きます。インターフェースは英語またはオランダ語で、右上から切り替えられます）

• マーカー、V1（フィルムストリップのサムネイル＋エネルギーバー）、A1（測定された波形）、音楽（ビートグリッド）、テキストトラックを備えたタイムライン。ドラッグして並べ替え、端をドラッグしてリップルトリム、Alt+ドラッグでスリップ編集、ブレードツール、スナップに対応しています。
• NLE ショートカット：Space、J/K/L、I/O、S（カット）、Q/W（再生ヘッド位置までトリム）、Delete（リップル）、Alt+←/→、M、N、V/B、Ctrl+Z/S、Ctrl+Enter、?。
• ショットごとの設定：速度、ゲイン、クロップ／ズーム／フォーカスポイント、ケン・バーンズ効果（ズーム → 終了時のズーム）、反転、トランジション（ディゾルブ、黒／白へのディップ、ワイプ、スライド、円形、ピクセル化、放射状）、色（明るさ、コントラスト、彩度、色温度、シャープ化、ノイズ除去）。
• 画面上のテキスト：フェード付きのタイトルカード、ローワーサード、大きなソーシャル用テキスト、メモ。すべてのカットに追従する、SRT からのソース時間に同期した字幕。字幕スタイルは 3 種類です。
• 音楽：ビート検出、ビートに合わせたカットのスナップ、音楽の開始位置のオフセット、音声の下での音楽のダッキング。
• ライブ品質チェック：スコア、フックの強さ、ジャンプカット、フラッシュショット、黒フレーム、字幕の速度、ビートからずれたカットを確認し、ワンクリックで修正できます。
• テンプレート（Shorts のフック、ゲームの予告編、YouTube のティーザー、開発ログ、シネマティック、フィード投稿）と、エージェントと共有できる名前付きスタイル。
• 履歴：リビジョンごとの作成者、「何が変わった？」の表示、非破壊の復元に対応しています。エージェントによる編集もライブで反映されます。
• 書き出し：1080p／1440p／4K、9:16、1:1、4:5（ぼかした背景に全フレームを表示、または指定した範囲でクロップ）、16 MiB 以下の WhatsApp 用バージョン。
• 長尺動画：最大 20 分、200 ショット、24 個のソース（各 2 時間）。静止画（PNG/JPG/WebP）もソースとして使えます。

エージェント向け — AGENTS.md、Claude、Cursor、OpenAI Codex、OpenAI API、n8n などのセットアップについては docs/INTEGRATIONS.md、問題の修正については TROUBLESHOOTING.md をご覧ください。

接続方法	エントリ
Claude Code プラグイン	/plugin marketplace add <this folder> → /plugin install ai-edit-studio@ai-edit-studio（ツール＋ワークフロースキル＋video-director エージェント）
OpenAI Codex	node cli.mjs codex-setup（または plugins/ai-edit-studio の Codex プラグイン）— ツール＋同じスキル
OpenAI API	examples/openai/（Responses API、Agents SDK）；GET /api/agent/tools?format=openai
MCP（stdio）	claude mcp add ai-edit-studio -- node mcp.mjs
HTTP	GET /api/agent/tools、POST /api/agent/call、POST /api/agent/tools/{name}
OpenAPI 3.1	GET /api/openapi.json
CLI	node cli.mjs studio <tool> --request file.json [--wait]

素材からレンダリングまで、1 回の呼び出しで実行できます：studio_auto_edit。テキストベースの編集：studio_transcribe、studio_transcript、 studio_text_edit。さらに、studio_reframe、studio_publish_pack、studio_brand。安定したクリップ ID に対するアトミックな studio_edit のバッチ処理（dryRun 対応）、編集内容を確認するための studio_timeline ＋ studio_storyboard、機械で適用できる修正を含む studio_review、ビート、ハイライト、スタイル、字幕の インポート、履歴／差分／復元、複製、レンダリングに対応します。エージェントによる変更はすべて、エージェント名が記録されたリビジョンになります。

インストールと起動（Windows ベータ版）

npm を使用する場合（Node 20 以降と FFmpeg が必要です）：

npm install -g ai-edit-studio
ai-edit-studio install      # data folder + connects Claude Code, Codex, Claude Desktop and Cursor
ai-edit-studio serve        # starts the editor on http://127.0.0.1:32146

エージェント用の MCP サーバーとして、事前のインストールなしで利用する場合：claude mcp add ai-edit-studio -- npx -y ai-edit-studio mcp （同じコマンドを Cursor、Claude Desktop、Codex の設定でも使用できます）。レジストリ名：io.github.laaielichter/ai-edit-studio。

**ダウンロードした zip からインストールする場合：**解凍し、Install-AI-Edit-Studio.cmd をダブルクリックして（macOS/Linux の場合は ./install.sh）、 INSTALL.md の手順に従います。データフォルダーを設定し、Claude Code、OpenAI Codex、Claude Desktop、 Cursor をまとめて接続します。

ソースからインストールする場合：

要件：libx264 を含む Node 20 以降と FFmpeg ビルドが必要です（Windows では FFmpeg 9.0.1、Linux では 6.1 でテスト済みです。利用可能な場合は NVENC を使用します）。

# double-click Start-Game-Trailer-Studio.vbs  (hidden server, opens the browser)
# or:
npm start
node cli.mjs doctor      # checks FFmpeg, encoder, storage and the (optional) speech engine
node cli.mjs speech-setup --model base   # optional: local speech recognition (whisper.cpp + model, ~200 MB)

FFmpeg／ffprobe は、PATH、アプリまたはデータフォルダー内の tools/ffmpeg/bin、あるいは FFMPEG_PATH／FFPROBE_PATH から検出されます。

**ストレージ。**プロジェクトとレンダリング結果はデータフォルダーに保存されます。インストーラーで選択したフォルダー、選択していない場合は Windows では Documents\AI Edit Studio、macOS/Linux ではアプリの隣にある .studio-data が使用されます。別のフォルダーを選ぶには：

./Start-Game-Trailer-Studio.ps1 -DataRoot 'D:\AI-Edit-Studio'
# or set GAME_TRAILER_STUDIO_DATA_ROOT=<absolute folder>

サーバーは 127.0.0.1:32146 のみでバインドされます（変更するには GAME_TRAILER_STUDIO_PORT を設定します）。旧キャプチャコンソールは /legacy.html にあります。

正直な制限事項

• 音声認識はローカルでのみ実行され、オプションの whisper.cpp のインストールが必要です（または文字起こしを用意してください）。顔の トラッキングには対応していません（リフレームは計測した動きに追従します）。動画生成、アップロード、公開にも対応していません。
• エネルギー、フック、ハイライト、Director モードでは、ストーリーや好みではなく、動き、音量、シーンの切り替わり、ビート、単語を使用します。 公開パックの投稿文は、独自のタイトル、概要、行動喚起のみを使って作成される下書きです。
• ブラウザーのプレビューは、見た目、色、テキスト、トランジションを近似して表示します。最終的には FFmpeg によるレンダリングが基準です。 ブラウザーで再生できない形式（一部の MKV／HEVC など）でも編集は問題なく行えます。レンダリング後のプレビューを確認してください。
• SDR／H.264 出力です。4K は Lanczos によるアップスケーリングであり、AI によるディテール補完ではありません。
• ベータ版のため、多数の外部ユーザーによる検証はまだ行われていません。バグ報告は GitHub の issue で歓迎します。

開発

node --test                                   # unit tests
node tools/verify-beta.mjs <new-dir-under-data-root>
node tools/verify-director.mjs <new-dir-under-data-root>
node tools/verify-director-ui.mjs <playwright/index.mjs> <chrome> <new-dir> <analysed-project-id>
node tools/verify-director06.mjs <new-dir-under-data-root> [port]
node tools/verify-director06-ui.mjs <playwright/index.mjs> <chrome> <new-dir> <analysed-project-id>
node tools/verify-director07.mjs <new-dir-under-data-root> [port]
node tools/verify-director07-ui.mjs <playwright/index.mjs> <chrome> <new-dir> <analysed-project-id>

ライセンス

MIT — LICENSE を参照してください。issue とプルリクエストを歓迎します。送信する前に node --test を実行してください。

変更履歴 · プライバシー · サードパーティに関する通知 · エージェントガイド（NL）