FableCut

FableCut は、Premiere 風のノンリニア動画エディターです。ブラウザー上で完全に動作し、 タイムライン全体を 1 つの JSON ドキュメントとして公開します。手動や UI から編集したり、 AI エージェント（Claude Code、Claude Desktop、または MCP/REST に対応するあらゆるもの）に 動画を編集させたりできます。タイムラインの更新をリアルタイムで確認できます。

npm 依存関係はゼロです。node server.js を実行するだけです。

スポンサー

Sidrune AI — GPT、Claude など主要な AI モデルを 1 つの API で利用できます。登録すると、API クレジットとして 3 ドル分を受け取れます。

興味深い点

多くの「AI 動画」ツールでは、編集内容が API の背後に隠されています。FableCut はその逆です。プロジェクトファイル自体がインターフェースです。project.json にはメディア、クリップ、トラック、エフェクト、キーフレーム、トランジションが記述されており、JSON を書き込めるプロセスならどれでも動画を編集できます。また、開いているブラウザー UI は、サーバー送信イベントを通じて約 150 ミリ秒以内にホットリロードされます。人間とエージェントが同じタイムラインを同時に操作できます。

エージェントの操作を取り消す。 エージェントによる編集は、それぞれ個別の取り消しステップになります。Ctrl+Z を押すと、まずエージェントの直近の変更が取り消され（その旨も表示されます）、続いて自分の変更が取り消されるため、両者の操作が混ざることはありません。大規模なロールバックにはバージョンを使えます。エージェントが編集を開始するとき（作業中も最大 10 分ごとに）、プロジェクト全体を書き換える前、各大きな操作（無音部分のカット、ビートへのスナップ、リフレーミング）の前、そして編集中は 10 分ごとにバージョンが保存されます。バージョンパネルから復元するか、エージェントに依頼して（fablecut_versions）、復元する前に任意のバージョンと現在の状態を比較できます。

機能

編集

• 映像＋音声トラック（デフォルトは3＋4本。トラックヘッダーの**+V**／+Aで追加できます。空のヘッダーを右クリック → トラックを削除）。ドラッグ／トリム／分割／スナップ、取り消し／やり直し

• 設定（トップバーの歯車）— 任意の設定をこのブラウザーのlocalStorageに保存します。タイムラインとプロジェクトビンの選択を連動を有効にすると、タイムラインのクリップを選ぶとプロジェクト内のメディアがハイライトされ、プロジェクトの項目をクリックすると、それを使用しているすべてのタイムラインクリップが選択されます（デフォルトではオフ）。

• 映像＋音声トラック（デフォルトは3＋4本）。ドラッグ／トリム／分割／スナップ、取り消し／やり直し

  • トラックヘッダーの**+V**／+Aで映像または音声レーンを追加できます（それぞれ最大16本）。
  • 空のトラックヘッダーを右クリック → トラックを削除（レーンにクリップがある場合、または映像／音声トラックが1本も残らなくなる場合は無効）
  • トラックヘッダーのSでそのレーンをソロにします（ほかのレーンはすべてミュート）。もう一度クリックすると、以前のミュート状態に戻ります。ソロ中にミュート切り替えを使うと、ソロが解除されます。
  • トラックターゲット — トラック名をクリックしてターゲットのオン／オフを切り替えます（点灯中はターゲット）。分割、挿入、リップル、ギャップを閉じる、カットへのジャンプはターゲットトラックのみを対象とします。目／スピーカーの切り替えは出力のみに影響し（プレビューと書き出しで非表示）、編集を妨げることはありません。選択したクリップは、どのトラック上にあっても編集されます。
  • トラックロック — トラックヘッダーの南京錠です。ロックされたトラック上のものは移動、トリム、分割、削除できません。リップル時もその位置に留まり、ほかのトラックだけが移動します。音楽トラックをロックして、映像を自由に再編集できます。

• クリップのロック、無効化、リンク解除 — クリップを右クリック（またはインスペクター上部の切り替えを使用）：ロックするとロックされたトラックと同様に固定されます。無効化（⇧E）すると、タイムラインには残したままプレビューと書き出しで非表示になります。リンク解除（Ctrl/Cmd+L）すると映像と音声が分離され、それぞれ移動できるようになります。位置を再び合わせるとリンクで再結合できます。エージェントにもロック状態が認識されます。fablecut_patch_projectは、opにforce: trueが指定されていない限り、ロックされたクリップの編集を拒否します。

  • Aトラックより多くの音声チャンネルを持つ映像をドロップすると、不足しているレーンが自動的に追加され（最大16本）、追加数がトーストで表示されます。各チャンネルは、それぞれ専用のAトラック上にリンクされたステムとして配置されます。

• モニター上での直接操作 — プレビュー上のクリップまたはタイトルをクリックして、直接移動、サイズ変更（コーナーハンドル）、回転（上部ハンドル、Shiftでスナップ）できます。

• タイムラインの複数選択 — ラバーバンドのマーキー（空のトラック領域をドラッグ）、Ctrl/Cmd/Shift+clickでクリップの追加／選択解除、Ctrl+Aですべて選択、Escで選択解除します。選択したクリップのいずれかをドラッグするとグループ全体を移動でき、Deleteですべて削除、Sで再生ヘッド位置にすべて分割できます。インスペクターには「N個のクリップを選択中」というバナーが表示されます。

• ビートマーカーとキューマーカー（再生中にビートに合わせてmを押します）— 名前と色を設定し、ルーラー上でドラッグできます。⇧m／Alt+⇧mまたはマーカーリストから移動できます。スナップ対象（クリップ端、再生ヘッド、マーカー、IN/OUT、キーフレーム、フレームグリッド）は、スナップの横にある**▾**から選択します。

• Alt+tを押すと、選択したクリップ上の再生ヘッド位置に基づいてイン／アウトトランジションを追加できます。最後に使ったトランジションがデフォルトとして記憶されます。オーバーレイの三角形をドラッグして長さを調整し、フォーカス中のトランジションをDeleteで解除します。

• クリップ上にデコード済みの実際の音声波形を表示

• ミキサー — インスペクターの横にあるミキサータブには、各音声トラック用のストリップ（フェーダー、パン、ミュート、ソロ、メーター）と、リアルタイムのLUFS表示付きマスターフェーダーがあります。プレビューと書き出しには同じミックスが適用されるため、聞こえる音がそのままレンダリングされます。

• クリップゲイン、チャンネル、ノーマライズ — 各音声クリップには、音量とキーフレームの前段に適用されるゲイン（dB）、チャンネルモード（ステレオ、モノラル、左、右、入れ替え）、ノーマライズがあります。選択したクリップのラウドネス（ITU-R BS.1770）またはサンプルピークを測定し、ゲインを調整して−14／−16／−23 LUFSまたは−1 dBFSに合わせます。リンクされたステムではゲインが共有されるため、ステレオペアのバランスが保たれます。

• 音量ライン、フェード、クロスフェード — すべての音声クリップに音量ラインが表示され、ドラッグして調整できます。Ctrl/Cmdクリックでキーフレームを追加し、Altクリックで削除します。コーナーグリップをドラッグするとフェードイン／アウトでき、実際のカーブ（コンスタントパワー、コンスタントゲイン、指数関数）で描画されます。Shift+Dで選択範囲の隣のカットにクロスフェードを適用します。両側の余分なメディアを使うため、ほかのものは移動しません。

• オートダッキング — 音楽を選択し、セリフのトラックと量を指定すると、話している箇所で音楽の音量が下がります（発話の直前から下がり、直後に戻ります）。音楽自体の音量に重ねて適用されるため、再実行や解除をしても音量レベルには影響しません。エージェントはfablecut_auto_duckを使用します。

• 音声エフェクトとプリセット — EQ、ハイパス／ローパス、コンプレッサー、リミッター、ノイズゲート、ディレイ、リバーブ、ディストーション、ステレオ幅、ピッチシフトを、クリップごと、トラックごと（ミキサー → FX）、バスごと、マスターに適用し、チェーン化できます。プリセットは、クリーンボイス、ポッドキャスト、ラジオ、低音ボイス、電話、シネマティック、ワイド、こもった音で、適用後も調整できます。プレビューと書き出しには同じエフェクトが適用されます。エージェントはsetFxパッチopを使用します。

• エフェクトのオートメーション — エフェクト設定の横にある◆で、クリップのキーフレームと同様に再生ヘッド位置にキーを設定できます。フィルターを徐々に強めてドロップにつなげたり、最後にリバーブを広げたりできます。エージェントはsetFxKeysを使用します。

• サブミックスバス — ミキサーの**+ バス**で、独自のエフェクト、フェーダー、パン、ミュート、メーターを備えたバスを追加できます。各トラック名の下にあるメニューから、トラックをバスにルーティングできます（すべてのセリフを1つのコンプレッサーと1つのフェーダーに通すなど）。

• ノイズ除去 — インスペクターのノイズコントロール（弱／中／強）でファイルのノイズフロアを測定し、ffmpegでノイズ除去済みのコピーを生成します。クリップの音声はそのコピーに切り替わり、オフにすると元に戻ります。エージェントはfablecut_denoiseを使用します。

• リフレーム — 被写体を追うショットで構成される編集のコピーを9:16、1:1、4:5で作成します。仮想カメラが各ショットで重要な被写体をパンして追いかけ、後から編集可能な通常の位置キーを書き込みます。新しいシーケンス…またはインスペクターのリフレームセクションから実行できます。エージェントはfablecut_reframeを使用します。

• ハイライト — 長い映像の見どころ（動き、音、鮮明な映像）を、カットをまたがず、ストーリー順に短い編集として新しいシーケンスにまとめます。シーケンスメニューの**ハイライト…**から実行できます。エージェントはfablecut_highlightsを使用します。

• 無音部分の除去 — インスペクターの無音セクション（または右クリック → 無音部分を検索）でテイクを解析し、すべての間をタイムライン上にマークします。カットすると、1回の取り消し操作でそのすべてが抽出され、各フレーズの前後には少し無音が残るため、言葉が途切れません。エージェントはfablecut_silenceを使用します。

• ビート — インスペクターのビートセクションで音楽クリップのテンポ、安定したビートグリッド、ドロップを検出し、タイムライン上にビートを表示します。ビートをマークしたり、すべてのカットを最も近いビートにスナップしたり、各ショットが1、2、4、8、16ビート続くようにトラックを再編集したりできます。エージェントはfablecut_beatsを使用します。

• 文字起こしとテキストベースの編集 — 文字起こしタブでは、ブラウザー上で音声を時刻付きの単語に変換します（Whisper。モデルは一度だけダウンロードされ、音声がマシンの外に送信されることはありません）。単語をクリックして該当箇所に移動し、単語を選択してDeleteを押すとカットできます。また、フレーズを検索して、それが話された箇所をすべてカットできます。エージェントはfablecut_transcribeを使用してインタビューを読み取り、セリフを探してカットします。

• 字幕 — クリック1回で文字起こしから単語ごとにタイミングを合わせた字幕を作成できます。字幕、カラオケ表示、単語のハイライト、大きく弾む単語表示に対応し、キャンバスに合わせたサイズで表示します。SRTとWebVTTをエクスポートまたはインポートできます。エージェントはfablecut_captionsを使用します。

• プロジェクトビンのフォルダー — 展開／折りたたみ可能なツリービュー。メディアやフォルダーをドラッグして入れ子にできます。プロジェクトタブを右クリック → 新しいフォルダー。ファイルをフォルダーにドロップして、その中にインポートできます。

• メディア管理 — 各ファイルのフレームレート、コーデック、音声チャンネル、サイズ（ffprobe）を表示。名前、コーデック、解像度、#tagで検索でき、お気に入り、使用済み／未使用、種類、タグ、コレクションで絞り込み、詳細項目または使用回数で並べ替えできます。メタデータ列付きのリスト表示、お気に入り、タグ、コレクション、タイムライン上のインスタンスを検索、プロジェクト内で表示に対応。オフラインファイルには「メディアオフライン」のスレートが表示され、再リンク…（名前とサイズから移動したファイルを検索）や**ファイルを置換…**が使えます。

• プロジェクト — 画像、メモ、タグ付きの全プロジェクトのダッシュボードです。プロジェクトを開く、新規作成する（キャンバスまたは保存済みのプロジェクトテンプレートから）、複製する、名前を変更する、アーカイブする、削除する、古いプロジェクトファイルをインポートすることができます。メディアは共有されるため、コピーしても映像は増えません。

• シーケンス — 1つのプロジェクトに複数のタイムライン（16:9と9:16のカット、短縮版、別案など）を作成し、メディアとコンポジションを共有できます。それぞれに独自のキャンバス、フレームレート、ミックス、納品設定があります。タイムラインツールバー左側のメニューから切り替えます。

• バージョン — 非破壊の履歴機能です。バージョンを保存（Ctrl/Cmd+S）でき、10分ごととエージェントの編集前に自動保存されます。現在の状態とバージョンを比較したり、復元したりできます（復元前に現在の状態がバージョンとして保存されます）。最終カットにマークを付けることもできます。バックアップにはすべてのバージョンが含まれ、読み取り不能なproject.jsonは起動時に復元されます。

• プロキシ — 4K／HEVC／ProRes映像をffmpegでバックグラウンド処理し、軽量でフレーム精度の高いH.264コピーを作成します。モニターのプロキシボタンでプロキシを使って編集できます。書き出しでは常にオリジナルがレンダリングされます。

• URLからインポート — + URLでHTTPSの映像／音声／画像を./media/にダウンロードします（インポート後は同一オリジン）。リモートSVGは拒否されます。エージェントはhttps://パスを指定してfablecut_import_mediaを使用します。URLはmedia.srcとして保持されません。保持するとキャンバスが汚染され、書き出しができなくなるためです。

• 音声ホールド — タイムラインツールバーの切り替え機能です。一時停止中、再生ヘッド位置の音声を1フレームループします（フレーム単位で移動するときに便利です）。スクラブまたはフレーム送りをすると、ホールドする範囲が更新されます。メーターはリアルタイムで動作します。再生／一時停止でオフになります。

• キャンバスのアスペクト比プリセット（16:9、9:16リール、4:5、1:1）、プロジェクトのFPS選択（24／25／30／50／60。プリセット以外のレートは「カスタム」と表示）、セーフエリアガイド

• 書き出しフレーム／リフレーム — コンポジションのキャンバスを納品用のクロップより大きくできます（project.jsonのexportFrame）。プレビューではオーバースキャン部分が暗く表示されます。書き出しフレームのハンドルをドラッグしてリフレームできます（例：16:9のキャンバスから9:16で書き出し）。高速書き出しではフレームに合わせてクロップされます。フレームを設定している間はWebCodecsとRealtime書き出しが無効になります。

• プログラムモニターのズーム — プレビュー上でマウスホイールを操作すると、カーソルに向かってコンポジションをズームします（フィット表示から、キャンバスの1ピクセルあたり画面上2ピクセルまで）。拡大表示ではネイティブのスクロールバーを使うため、画面外の部分にもアクセスできます。中クリックまたはAlt+ドラッグでパンします。ズーム中に表示されるフィットボタンで、ステージに合わせた表示に戻します。

• フル機能のJ／K／Lシャトル — Lで順方向、Jで逆方向に再生します。もう一度押すと1.5倍／2倍／4倍速になり、反対のキーで方向が切り替わり、Kで停止します。Kを押しながらJ／Lを押すと1フレーム移動し、両方を押すと1/4速で再生します。プレビューのみで使用でき、書き出しには適用されません。

• タイムコード入力 — 再生ヘッドの表示をクリックするか数字を入力して移動します：01:15:00、1500、+30、12.5。IN／OUT表示にも時刻を入力できます。

• ワークスペースのサイズ変更：モニターとタイムラインの間の仕切りをドラッグします（ダブルクリックでリセット）。タイムライントラック密度のプリセットはS／M／Lです（Sではトラックをコンパクトにするためサムネイルを非表示にします）。

• 選択範囲にズーム（⇧Z）すると、1つだけでなく、選択したすべてのクリップに表示範囲を合わせます。

• IN/OUT作業範囲 — iとoでマーカーを設定します（⇧I／⇧Oで解除）。プログラムモニターには再生ヘッド位置が現在位置 / シーケンスの長さとして表示されます。マーカーを設定すると、IN、マーク範囲の長さ、OUTが右側に並びます。書き出しには範囲のドロップダウン（全タイムライン／IN–OUT）があり、マーカーがある場合はデフォルトでIN–OUTになります。マーカーを分割／トリムに使いながら、シーケンス全体を書き出せます。制限を有効にすると再生がマーク範囲内に制限され、Home／Endはタイムライン全体ではなくIN／OUT位置に移動します。tでマーカー位置にクリップを分割し、⇧tでクリップを作業範囲（インマーカーとアウトマーカーの間）にトリムします。

• ギャップの検索と解消 — ギャップとは、ターゲットになっているすべてのトラックが空になる範囲（黒いフレーム）です。gで次の共通ギャップに再生ヘッドを移動します（末尾から先頭に戻り、両方のIN/OUTが設定されている場合はその範囲に従います）。⇧Gで再生ヘッド下のギャップを閉じ、ターゲットになっているすべてのトラック上で後続のクリップを左に移動します（ロックされたクリップはその場に残ります）。

• トリムツール — タイムラインツールバーのツール選択（またはV B R Y U）から選べます：選択、リップル編集（クリップ端をドラッグすると後続のすべてが追従するため、ギャップができません）、ローリング編集（2つのクリップ間のカットをドラッグします。ほかのものは移動しません）、スリップ（クリップを移動せずに、表示するソース部分を変更します）、スライド（隣接するクリップをトリムして空きを作りながらクリップを移動します）。すべてのツールはソースの長さ、ターゲット設定、ロック、リンクされた音声を考慮し、ドラッグ中はポインターの横にオフセットを表示します。エージェントも同じコードで、分割、リップル削除、リフト／抽出、挿入／上書き、リップル／ローリング／スリップ／スライド、クロスフェードを、fablecut_patch_projectのopとして実行します。

• リフト／抽出 — ;でターゲットトラック上のIN→OUT範囲を削除し、ギャップを残します。'では範囲を削除してギャップを閉じます。どちらもタイムラインツールバーから実行できます。

• カットへジャンプ — ↑／↓で再生ヘッドを前／次の編集点（クリップのインまたはアウト）に移動します。クリップが選択されている場合、最初のキー入力でそのクリップの開始点、次の入力で終了点に移動します（Premiere形式）。選択がない場合は、ターゲットトラック上のカットを順に移動します。ソースモニターでは、0、イン、アウト、長さの間を移動します。左右キーでは引き続きフレーム単位で移動でき、Home／Endではシーケンス位置（または制限中はIN／OUT）に移動します。

• リップル削除 — タイムラインのリップル削除ボタン（または⇧Del）で選択範囲を削除し、各ターゲットトラック上の後続クリップを左に移動してギャップを閉じます。通常のDelでは引き続きリフトされ（ギャップが残り）、リンクされた映像・音声の相方は、ターゲットになっていないトラック上でも常に一緒に移動します（同期ロック）。ロックされたクリップが削除または移動されることはありません。

• プロパティをリセット — インスペクターのラベルまたはスライダーをCtrl/Cmd+clickすると、エフェクト／プロパティをデフォルトに戻し、そのチャンネルのキーフレームをすべて削除します（スケール→1、不透明度→1、クロップL/Rのような対応フィールドは同時にリセットされます。トランジションのラベルではイン／アウトのトランジションが解除されます）。ラベルをShift+clickすると再生ヘッド位置にのみ適用されます。キーフレーム上にいる場合はそのキーフレームだけを削除し、それ以外では再生ヘッド位置の値をデフォルトに設定します（チャンネルがすでにアニメーション化されている場合は自動でキーが設定されます）。

• メディアを置換 — インスペクターのソースボタン（映像／音声／画像／SVGクリップ）で、位置、トリム、キーフレーム、トランジション、すべてのエフェクトを維持したまま、元のファイルを置き換えられます。ビンにある別の項目を選ぶか、**ファイルを参照…**でインポートと置換を一度に実行できます。映像にリンクされた左右の音声も一緒に置き換わります。置換後のメディアが短い場合は、トリムが収まるよう調整され、その旨がトーストで表示されます。

• マルチチャンネルの映像音声 — 音声チャンネルが2つを超える映像では、L/Rだけでなく、チャンネルごとにリンクされた音声クリップが作成されます（5.1、7.1など）。必要に応じて追加の音声トラック（A5、A6など。最大16本）が自動的に作成されます。クリップのメディアを置き換えると、リンクされたチャンネルクリップが新しいソースのチャンネル数に再同期され、必要に応じて追加チャンネルや新しいトラックが追加または削除されます。 Look

• ワンクリックで使える14種類のフィルタープリセット（シネマティック、ティール＆オレンジ、ノワール、ビンテージ、サイバーパンク、サンセット、ミッドナイトなど）

• 調整レイヤー — 1つのクリップで、その下にあるすべてのクリップをカラーグレーディングできます。Premiere風です

• カラー作業スペース（上部バー → カラー）：プログラムモニターの横に波形、RGBパレード、ベクトルスコープ、ヒストグラムをリアルタイム表示します。また、GPUで選択したクリップをカラーグレーディングするカラータブを備えています。リフト／ガンマ／ゲイン／オフセットホイール、露出、ピッカーを使ったホワイトバランス（白いものをクリック）、黒レベル／シャドウ／中間調／ハイライト／白レベル、ピボット、ソフトロールオフ、彩度を調整できるログスタイルのコントラストに加え、カーブ（輝度、R／G／B、色相対色相、色相対彩度、色相対輝度、彩度対輝度）も使えます。モニターから色を選択するピッカーもあります。また、HSL クオリファイアーや楕円、長方形、多角形、ベジェ、フリーハンドのマスク（ぼかし、反転、キーフレーム設定に対応し、モニター上でドラッグ可能）で範囲を限定する補正レイヤー（セカンダリー）と、マット表示にも対応しています。ショット間でカラーグレーディングをコピー／貼り付けできます。エージェントはsetGradeパッチ操作でカラーグレーディングし、fablecut_scopesで結果を数値（レベル、クリッピング、色かぶり）として読み取ります

• フィルターのクイックスライダー：明るさ／コントラスト／彩度／色相、色温度と色かぶり、ぼかし、グレースケール／セピア／反転、ビネット、アニメーション対応のフィルムグレイン

• 17種類のブレンドモード（スクリーン、乗算、オーバーレイ、カラー焼き込み、除外、色相、輝度など）、フィットモード（全体表示／画面いっぱい／引き伸ばし）、端ごとのクロップ、角の丸み、水平／垂直反転

• マスク — クリップ（動画、画像、SVG、テキスト、調整レイヤー）の任意の部分を切り分けます。長方形、楕円、ベジェペン、フリーハンドの形状を使えます。クリップごとに複数のマスクを作成し、加算／減算／交差／差分で組み合わせられます。それぞれにぼかし、拡張、反転、不透明度を設定でき、すべてキーフレームに対応します（輪郭も変形します）。モニター上で描画、編集でき、マット表示にも対応しています。エージェントはsetMaskパッチ操作を使い、fablecut_scopesで測定します

• シェイプとモーショングラフィックス — 長方形、楕円、多角形、星形、線、ペンで描画したベジェパスをグループ化したシェイプレイヤー。塗りつぶし、線、破線、描画アニメーション用のトリムパスに対応します。ヌルオブジェクト、親子関係、各クリップのアンカーポイントも利用できます。モニター上で直接編集でき、すべての値にキーフレームを設定できます。エージェントはsetShapeおよびsetParentパッチ操作を使います

• モーションパス、モーションブラー、パス上のテキスト — モニター上のハンドルでクリップの移動をカーブさせ、途中で向きを変えたり、シャッター角度を指定して速い動きにブラーをかけたりできます（プレビューと書き出しに対応）。直線、弧、円、描画したパスに沿ってタイトルを配置できます。エージェントはsetMotionPathおよびsetTextPathパッチ操作を使います

• コンポジション — ネストされたシーケンスです。ローワーサード、ロゴの短いアニメーション、シーンなどを一度作成し、動き、マスク、カラーグレーディング、ブレンドが可能な1つのクリップとして任意の場所に配置できます。動画と音声は通常どおり再生、書き出しできます。タイムラインで開いて編集することも、選択範囲をプリコンポーズすることもできます。エージェントはaddComp、inComp、precomposeパッチ操作を使います

• アニメーションプリセットとテンプレート — クリップの配置場所に合わせて使える、33種類の既製の開始、終了、強調、ループアニメーションに対応しています。また、テキスト、色、ロゴを入力できるテンプレート（ローワーサード、ロゴアニメーション、9:16／1:1／16:9のソーシャル向けレイアウト）も用意されており、それぞれ独立したコンポジションとして配置されます。独自のアニメーションやコンポジションをライブラリに保存すれば、すべてのプロジェクトで使えます。エージェントはapplyPreset、addTemplate、setTemplateパッチ操作を使います

• モーショントラッキング — 動画クリップを通じてポイントや領域（スケールと回転を含む）を追跡し、マスクを追従させたり、タイトル、ステッカー、任意のクリップをその位置に固定したりできます。結果は通常の編集可能なキーフレームになります。エージェントはfablecut_trackを使います

• トラックマット — 上のトラックの映像を使い、アルファまたは輝度（反転の有無を指定）でクリップを切り抜きます。動画を塗りに使ったテキスト、シェイプによるリビール、テクスチャの切り抜きなどを作れます。マットトラックは非表示になります。エージェントはsetMatteを使います

• 許容範囲／ソフトネスとスピル抑制機能を備えたクロマキー（グリーンスクリーン）

• AI 背景除去（人物の切り抜き、MediaPipeを使ったブラウザー内処理） モーション

• 約25個のプロパティでイージング付きキーフレームアニメーションに対応

• クリップ上のキーフレームマーカー — 各キーフレームの異なる時刻に、クリップ本体上にダイヤモンドを表示します（ツールチップにはチャンネルが一覧表示され、同じ時刻に複数ある場合は個数バッジが表示されます）。Ctrl/Cmd+← / Ctrl/Cmd+→ で再生ヘッドを前後のキーフレームに移動できます（選択中のクリップを優先し、選択中でなければ再生ヘッド下のクリップを対象にします）。インスペクターのフィールドには再生ヘッド位置で補間された値が表示されます。値を変更すると、現在位置のキーフレームが更新されます。そのチャンネルにキーフレームが設定されていれば、キーフレームが追加されます。プログラムモニター上でクリップをドラッグ（移動／拡大縮小／回転）しても同様に記録されます。◆ボタンを押すと再生ヘッド位置にキーフレームが追加されるか、現在位置のキーフレームが削除されます。✕を押すとチャンネル全体がクリアされます。再生ヘッドが選択中のクリップの外にある場合、キーフレームが設定されたフィールドと◆ボタンは無効になり（最も近い端の値が表示されます）、キーフレームを編集できるのは再生ヘッドが実際にある位置のみです。アニメーションのないプロパティはどの位置でも編集できます

• キーフレームグラフ — インスペクターでプロパティのカーブを切り替えると、プログラムモニターの横に補間値のグラフが表示されます。グラフをクリックするとその位置に移動します

• 速度ランプ — speed にキーフレームを設定すると、エンジンが映像と書き出し時のオーディオミックスの両方をタイムリマップします（高速からスローモーションへ切り替わるリール向けの効果）

• カメラシェイクとRGB分離／色収差に対応。どちらもアニメーション可能です

• トランジションは17種類：フェード、スライド、ワイプ（4方向）、ズーム、アイリス、回転、ぼかし、ウィップパン、グリッチ、ポップ

テキスト

• タイトルスタイル — 統一感のあるスタイルをワンタップで適用できます（インパクト、エレガント、キネティックカット、ネオン、手書き、ラグジュアリーなど）。新しいタイトルでは、ひとつの定型スタイルに固定されず、フォント、配置、アニメーションが自動的に変化します
• キネティック字幕：タイプライター、ワードポップ、ワードスライド、カラオケ、レターポップ、ウェーブ、バウンス、シェイク、クリップリビール、ズームイン、フォントカット（リズムに合わせた書体の切り替え）、ライズマスク
• TikTok風の字幕に使えるネオングロー
• フォントエディター：システムフォント、追加したカスタムフォント（library/fonts/）、名前を指定したあらゆるGoogle Fontに対応し、自動的に読み込まれます
• グラデーション塗りつぶし、アウトライン、背景ピル、文字間隔、行の高さ、ウェイト、イタリック、大文字化、ソフトシャドウ
• テキストレイアウト — 水平方向の配置：左／中央／右／両端揃え（単語間に余分なスペースを入れます）。タイトルの角のハンドルをドラッグしてテキストボックス（boxW / boxH）を作成できます。さらに角をドラッグするとサイズを変更できます（反対側の角は固定されます。Ctrl/Cmd を押しながらドラッグすると中央からサイズ変更し、Shift を押しながらドラッグすると縦横比を固定します）。ボックス内のテキストは、デフォルトではフォントサイズを固定したまま折り返されます。サイズを合わせるを有効にすると、ブロック全体が収まるようフォントが縮小されます。垂直方向の配置（上／中央／下）で、ボックス内のテキストブロックの位置を調整できます。コンテンツに合わせたサイズに戻すには、ボックスの W/H を 0 に設定します。

アニメーションSVGクリップ

• ファーストクラスの svg クリップ種別に対応：CSSの@keyframesでアニメーションするSVGは、プレビューと書き出しでフレーム単位の精度でレンダリングされます（コンポジターは任意の時刻でアニメーションを静止させます）。エージェントはローワーサード、紙吹雪、きらめきなどのベクターオーバーレイを、通常の .svg ファイルとして作成できます。スターターも含まれています。

参照動画をリメイク

• 参考にしたい編集動画（気に入ったリールなど）を渡すと、編集用ブループリントが返されます。ショットの境界、音楽のビートとBPM、ラウドネスカーブ、ショットごとのエネルギー、ドロップに加え、参照動画の音楽トラックを抽出してメディアに追加します。自分の映像を使って同じアイデアを再現できます。追加の依存関係は不要です（デコードにはffmpegを使用し、オンセット／テンポ検出はNodeだけで行います）。 node analyze.js ref.mp4、POST /api/analyze、または fablecut_analyze_reference MCP ツールを使用できます。

映像を確認

• エージェント（または REST 経由のユーザー）は、任意の時点の実際の画像を取得できます。 GET /api/frame?src=/media/x.mp4&t=3.2 はそのフレームの JPEG を返し、&frames=12 はクリップ全体の 4×3 のコンタクトシートを返します。3 分間のテイクに収められた内容を手軽に確認できます。取得した画像は analysis/frames/ にキャッシュされます。
• fablecut_frame MCP ツールはこれをラップし、画像をインラインで返すため、マルチモーダルモデルが実際に見て確認できます。path の代わりに time を渡すと、エディター独自のコンポジターで合成済みのタイムラインをレンダリングします。カラーグレーディング済みで、全トラックを含み、書き出し結果と同じです。そのため、「このカラーグレーディングでいいか」「実際に何を作ったのか」といった疑問を視覚的に確認できます。
• 上記のアナライザーと組み合わせることで、エージェントはエネルギー値から推測するのではなく、映像を見て素材を選べます。

アセットライブラリ

• library/ フォルダーは UI のタブとして表示されます。Elements（オーバーレイアート）、Sound FX、SVG があり、ファイルを追加すると、開いているエディターにリアルタイムで反映されます。

書き出し

• 納品プリセット：YouTube、YouTube Shorts、Instagram Reels、TikTok、X、LinkedIn、Master、Broadcast（ProRes 422 HQ）、Web、Archive（ロスレス FFV1）、Custom。すべての設定を調整できます。解像度とリフレーミング（クロップ、フィット、または別のアスペクト比へのストレッチ）、フレームレート、コーデック（H.264、HEVC、AV1、VP9、ProRes、DNxHR、XDCAM HD422、FFV1）とハードウェアエンコーダー、CRF／VBR／CBR、最大レート、キーフレーム間隔、ピクセル形式、カラー、コンテナ、オーディオコーデック、ビットレートとレート、ラウドネス正規化（真のピーク上限付きの −14／−16／−23／−24 LUFS）、ファイル名テンプレート、メタデータ。独自のプリセットを保存できます。レンダリング前にダイアログでアップスケーリング、クロップ、プラットフォームの制限について警告し、書き出し後はすべてのファイルを読み戻して、サイズ、フレームレート、フレーム数、コーデック、長さ、ラウドネス、真のピーク、ファイルサイズをチェックします。
• 一括書き出し：1 つのプロジェクトから、マスター、YouTube 1080p、9:16 のリール、正方形、720p のプレビューなど、複数のファイルを作成します。フレームレートと範囲ごとに1 回のレンダリングで最大 8 つの出力を作成でき、各フレームを 1 回だけ描画し、それぞれの出力を ffmpeg でエンコードします。一括出力はプロジェクトと一緒に保存されます。書き出しキューで順番に実行でき、進捗確認、停止、再試行、ファイルを開く操作が可能です。
• 高速書き出し：ブラウザーですべてのフレームをレンダリングし、オフラインでオーディオをミックスします。ffmpeg が納品プリセット、または encoding-profiles.json の生のエンコードプロファイルを使ってエンコードします（タブを切り替えてもレンダリングは続行されます）。エンコードとアップロードはコンポジターより先に進むため、タイムラインの処理が速くても toBlob で停止しません。
• WebCodecs 書き出し：ブラウザーが Annex-B H.264 をハードウェアエンコードし、サーバーがオーディオをストリームコピーして多重化します。アップロードが高速化されます。ビットレート／VBR-CBR は「Export」ダイアログで設定します。書き出しフレームが設定されている間は利用できません（Fast を使用してください）。
• ffmpeg または WebCodecs が利用できない場合は、リアルタイムの MediaRecorder にフォールバックします。
• エージェントからも書き出せます：fablecut_export は開いているエディターで Fast 書き出しを実行するか、ヘッドレス Chrome／Edge ではサーバーを起動し、ファイルパスを返します。preset と delivery で納品プリセットを選択・調整でき、outputs で複数のファイルを一度に作成できます。
• 書き出しの範囲ドロップダウン：タイムライン全体、または IN–OUT（マーカーが設定されている場合は IN–OUT がデフォルト）を選択できます。実際に書き出す IN／OUT の範囲は projDur() によって制限されます。

クイックスタート

npx -y fablecut       # → http://localhost:7777

プロジェクト、メディア、書き出しファイルは ~/FableCut に保存されます。または、クローンから実行できます。

git clone https://github.com/ronak-create/FableCut.git
cd FableCut
node server.js        # → http://localhost:7777

必要要件：Node 18+ と Chromium ベースのブラウザー。PATH 上の ffmpeg は任意ですが、推奨です（高速な書き出しとアップロード時のリマックスに役立ちます）。AI による背景除去では、初回使用時に CDN からモデルを取得します。

サーバーは 127.0.0.1 のみにバインドします（v1.3.1+）。LAN 上の別のデバイスから使用するには、明示的に有効にしてください：HOST=0.0.0.0 FABLECUT_ALLOWED_HOSTS=<your-ip> node server.js。

メディアをウィンドウ（または ./media/）にドロップし、+ URL から HTTPS URL を貼り付け、クリップをタイムラインにドラッグして、編集・書き出しを行います。

チェックアウトの外に作業内容を保存するには、FABLECUT_DATA_DIR を設定してください。これにより、project.json、media/、exports/、analysis/、library/ が指定したディレクトリに移動します。設定しない場合は、これまでと同様にすべてリポジトリ内に保存されます。

Claude Code プラグインとしてインストールする場合

/plugin marketplace add ronak-create/FableCut
/plugin install fablecut@fablecut

これにより MCP サーバーが登録され、3 つのスキル（edit-video、remake-reel、motion-graphics）が追加されます。タイムラインと映像素材はプラグイン専用のデータディレクトリに保存されるため、アップデートで変更されることはありません。Node 18+ と（任意の）ffmpeg は引き続きマシンにインストールしておく必要があります。

AI エージェントで操作する

エージェントが必要とする情報はすべて CLAUDE.md にあります。完全なスキーマ、仕様、レシピが記載されています。このファイルを対応可能なモデルに渡せば、エディターを最初から最後まで操作できます。

📖 閲覧可能なドキュメント： 同じマニュアルをトピックごとに1ページのウェブページで閲覧できます （MCP ツール、project.json スキーマ、クリップのプロパティ、レシピ、REST API、 書き出し）：fablecut.space/docs。

同等の操作方法は3種類あります。

1. MCP（Claude Code / Claude Desktop に最適）— 同梱の依存関係不要な MCP サーバーを一度登録します。

   claude mcp add -s user fablecut -- npx -y fablecut mcp
   

   クローンやパスの指定は不要です。作業内容は ~/FableCut に保存されます。クローンから使う場合は、代わりにファイルを指定してください。

   claude mcp add -s user fablecut -- node "<path-to>/fablecut/mcp-server.js"
   

   OpenCode では、プロジェクトまたはグローバルの opencode.json 設定から、同じ stdio サーバーを使用できます。

   {
     "$schema": "https://opencode.ai/config.json",
     "mcp": {
       "fablecut": {
         "type": "local",
         "command": ["node", "/absolute/path/to/FableCut/mcp-server.js"],
         "enabled": true
       }
     }
   }
   

   別の MCP クライアントを使う場合は、同等のコマンドを指定してローカルの stdio サーバーを登録してください。キー名はクライアントによって異なりますが、コマンドと引数は同じです。

   {
     "name": "fablecut",
     "transport": "stdio",
     "command": "npx",
     "args": ["-y", "fablecut", "mcp"]
   }
   

   （クローンから使う場合："command": "node"、"args": ["/absolute/path/to/FableCut/mcp-server.js"]。）

   このサーバーは特定のクライアントに依存しない設計です。stdio 経由で MCP を使用し、Claude 固有の環境変数は必要ありません。クローンを使う場合は、絶対パスを指定してください。どちらの場合も Node 18 以降が必要です。

   ツール：fablecut_status（エディターを自動起動）、fablecut_docs、fablecut_get_project、fablecut_set_project、fablecut_patch_project、fablecut_import_media、fablecut_analyze_reference、fablecut_frame、fablecut_encode_profiles、fablecut_normalize_audio、fablecut_auto_duck、fablecut_denoise、fablecut_silence、fablecut_beats、fablecut_reframe、fablecut_highlights、fablecut_transcribe、fablecut_captions、fablecut_export、fablecut_scopes、fablecut_track。

   FableCut は 公式 MCP レジストリにも io.github.ronak-create/fablecut として公開されています。各リリースには MCPB バンドル（fablecut.mcpb）が含まれており、MCPB 対応クライアントに直接インストールできます。

   このインターフェースはトークン効率を考慮した設計です。エージェントはドキュメント全体を往復させる代わりに小さな操作（fablecut_patch_project）でタイムラインを変更し、クリップごとに1行の簡潔な要約（fablecut_get_project {compact:true}）を読み取り、必要なマニュアルのセクションのみを取得します（fablecut_docs {section:"props"}）。

2. ファイル — project.json を読み取り、変更して、revision を増やしてから書き込みます。UI は自動で再読み込みされます。

3. REST — GET/PUT /api/project、POST /api/upload、POST /api/import-url、 GET /api/library、GET /api/export/profiles、/api/events の SSE。完全な一覧は CLAUDE.md を参照してください。 例：Claude Code に 「この6つのクリップをビートマーカーに合わせてカットし、ティールとオレンジのカラーグレーディングを追加して、上にワードポップ字幕を載せ、カットのたびにウーシュ音を入れて」 と頼めば、タイムラインが自動で組み直されるのを確認できます。

または、参考動画を渡してみましょう。「気に入っているリールがこれです。分析して、同じ音楽を使い、私のクリップで再現してください」。エージェントは fablecut_analyze_reference を呼び出して、設計図（カット、ビート、BPM、エネルギー、ドロップ、抽出した音楽）を取得し、あなたの映像素材を使って、ショットごとに同じ構成を組み直します。

エージェントは測定するだけでなく、見ることもできます。 fablecut_analyze_reference は、カットの位置や、どのショットが強く印象に残るかを知るための 耳 を提供します。fablecut_frame は 目 を提供します。任意のクリップの任意の場面（{path, t:3.2}）を指定すると、モデルが実際に確認できる画像が返されます。または、12フレームのコンタクトシートをリクエストして、1回の呼び出しでクリップ全体を確認できます（{path, frames:12}）。path を指定せずに time を渡すと、書き出し時とまったく同じように、カラーグレーディング済みで全トラックを含む合成タイムラインがレンダリングされます。そのため、数値から推測するのではなく映像を見て素材を選べるほか、実際の映像でカラーグレーディングを確認できます。

競合を防止する安全な同時編集：UI、MCP ツール、project.json への直接書き込みは、すべて revision カウンターに基づいて同期します。エージェントが作業中に UI でクリップを編集すると、エージェントの次の書き込みは拒否されます（REST API では 409、fablecut_set_project では競合エラー）。変更が黙って上書きされることはありません。同様に UI は、エージェントによる書き込みが、まだ保存されていないローカルの変更に取って代わる場合、それを検出し、黙って破棄するのではなくトースト通知で知らせます。

プロジェクトの構成

server.js        zero-dependency HTTP server: static hosting, REST API, SSE,
                 ffmpeg export pipeline
app.js           the editor: timeline UI, compositor, keyframes, text engine,
                 SVG rasterizer, chroma key, exporters
index.html       single-page UI
style.css        dark editor theme
mcp-server.js    stdio MCP server exposing the editor to AI agents
analyze.js       reference-video analyzer: shots, beats/BPM, energy, drop,
                 music extraction (module + CLI)
CLAUDE.md        the agent manual (schema + recipes) — also served by fablecut_docs
encoding-profiles.json
                 Fast-export ffmpeg presets (hot-reloaded)
project.json     your timeline (created on first run; gitignored)
media/           project footage (gitignored)
analysis/        cached edit blueprints from /api/analyze (gitignored)
library/         default assets: elements/ sfx/ svg/ fonts/
exports/         finished renders (gitignored)

アーキテクチャの概要

flowchart TD

subgraph group_interaction["Editing Experience"]
  node_browser_ui["Browser Editor<br/>[app.js]"]
  node_timeline_model["Timeline Model<br/>[app.js]"]
  node_ruler_worker["Ruler Worker<br/>[ruler-worker.js]"]
end

subgraph group_project_media["Project And Media"]
  node_project_store[("Project Store<br/>[paths.js]")]
  node_media_store[("Media Store<br/>[paths.js]")]
  node_asset_library[("Asset Library<br/>[server.js]")]
  node_url_importer["URL Importer<br/>[import-url.js]"]
end

subgraph group_agent_api["Agent Control"]
  node_rest_api["REST Server<br/>[server.js]"]
  node_mcp_server["MCP Server<br/>[mcp-server.js]"]
  node_sse_hub["Change Notifications<br/>[server.js]"]
end

subgraph group_playback_export["Playback And Export"]
  node_compositor["Canvas Compositor<br/>[app.js]"]
  node_audio_engine["Audio Engine<br/>[app.js]"]
  node_audio_meter["Audio Meter<br/>[meter-worklet.js]"]
  node_export_engine["Export Engine<br/>[server.js]"]
  node_encoding_profiles["Encoding Profiles<br/>[encode-profiles.js]"]
end

subgraph group_analysis["Analysis Tools"]
  node_reference_analyzer["Reference Analyzer<br/>[analyze.js]"]
end

node_human(("Human Editor"))
node_ai_agent(("AI Agent"))
node_ffmpeg["FFmpeg"]

node_human -->|"edits timeline"| node_browser_ui
node_ai_agent -->|"sends tools"| node_mcp_server
node_browser_ui -->|"updates project"| node_timeline_model
node_timeline_model -->|"persists JSON"| node_project_store
node_browser_ui -->|"calls REST"| node_rest_api
node_rest_api -->|"reads writes"| node_project_store
node_rest_api -->|"serves media"| node_media_store
node_rest_api -->|"lists assets"| node_asset_library
node_mcp_server -->|"checks server"| node_rest_api
node_mcp_server -->|"patches project"| node_project_store
node_mcp_server -->|"imports media"| node_url_importer
node_url_importer -->|"stores downloads"| node_media_store
node_rest_api -->|"downloads URLs"| node_url_importer
node_rest_api -->|"broadcasts changes"| node_sse_hub
node_sse_hub -->|"pushes changes"| node_browser_ui
node_timeline_model -->|"renders timeline"| node_compositor
node_timeline_model -->|"routes clips"| node_audio_engine
node_audio_engine -->|"measures audio"| node_audio_meter
node_browser_ui -->|"uploads frames"| node_rest_api
node_rest_api -->|"streams export"| node_export_engine
node_export_engine -->|"loads profile"| node_encoding_profiles
node_export_engine -->|"encodes video"| node_ffmpeg
node_reference_analyzer -->|"analyzes media"| node_ffmpeg
node_reference_analyzer -->|"writes music"| node_media_store
node_ai_agent -.->|"requests analysis"| node_reference_analyzer
node_browser_ui -.->|"draws ruler"| node_ruler_worker

click node_browser_ui "https://github.com/ronak-create/fablecut/blob/main/app.js"
click node_timeline_model "https://github.com/ronak-create/fablecut/blob/main/app.js"
click node_compositor "https://github.com/ronak-create/fablecut/blob/main/app.js"
click node_audio_engine "https://github.com/ronak-create/fablecut/blob/main/app.js"
click node_audio_meter "https://github.com/ronak-create/fablecut/blob/main/meter-worklet.js"
click node_rest_api "https://github.com/ronak-create/fablecut/blob/main/server.js"
click node_mcp_server "https://github.com/ronak-create/fablecut/blob/main/mcp-server.js"
click node_sse_hub "https://github.com/ronak-create/fablecut/blob/main/server.js"
click node_project_store "https://github.com/ronak-create/fablecut/blob/main/paths.js"
click node_media_store "https://github.com/ronak-create/fablecut/blob/main/paths.js"
click node_asset_library "https://github.com/ronak-create/fablecut/blob/main/server.js"
click node_url_importer "https://github.com/ronak-create/fablecut/blob/main/import-url.js"
click node_export_engine "https://github.com/ronak-create/fablecut/blob/main/server.js"
click node_encoding_profiles "https://github.com/ronak-create/fablecut/blob/main/encode-profiles.js"
click node_reference_analyzer "https://github.com/ronak-create/fablecut/blob/main/analyze.js"
click node_ruler_worker "https://github.com/ronak-create/fablecut/blob/main/ruler-worker.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_browser_ui,node_timeline_model,node_ruler_worker toneBlue
class node_project_store,node_media_store,node_asset_library,node_url_importer toneAmber
class node_rest_api,node_mcp_server,node_sse_hub toneMint
class node_compositor,node_audio_engine,node_audio_meter,node_export_engine,node_encoding_profiles toneRose
class node_reference_analyzer,node_human,node_ai_agent,node_ffmpeg toneIndigo

アニメーション SVG オーバーレイの作成

SVG は通常の CSS @keyframes でアニメーションします。規則はひとつです。animation-delay を直接指定せず、代わりに --d: 0.4s を設定してください。コンポジターは、すべてのアニメーションを一時停止して遅延を再設定することで、時間を制御します。詳しい規則とひな形はCLAUDE.mdに、動作する例は library/svg/ にあります。

注意事項

• リポジトリには Google Fonts が20種類（library/fonts/、OFL — 詳細はそこにある LICENSES.md を参照）と、自作の SVG オーバーレイおよびアニメーション要素（library/elements/、library/svg/、リポジトリの他の部分と同じ MIT ライセンス）が含まれています。
• library/sfx/ は自由に追加できます（gitignore 対象）。効果音のサイトでは通常、ファイルを公開リポジトリで再配布することが許可されていないため、FableCut では再配布していません。無料で利用できるおすすめの音源は library/sfx/README.md に記載されています。
• コンポジター自体がブラウザーであるため、書き出しはブラウザー上で実行されます。エージェントから Export のクリックを求められるか、media/ から ffmpeg を使って直接レンダリングします。

コミュニティ

質問やアイデアの共有、編集の披露、今後の方向性づくりへの参加をご希望ですか？FableCut Discord に参加してください。バグ報告や機能リクエストは、引き続き GitHub の issue に投稿するのがおすすめです。メールでのお問い合わせをご希望の場合は、[email protected] までご連絡ください。サポートが必要な場合は、[email protected] までお問い合わせください。

ライセンス

MIT