OpenCut は、ブラウザ、デスクトップ、モバイル デバイスを対象としたオープンソースのビデオ エディタです。これは、CapCut のオープン ソース バージョンと呼ばれることがよくあります。ただし、現在のメインリポジトリはゼロから書き直されています。 main を直接複製することで得られるものは、開発中の新しいアーキテクチャであり、安定して利用可能な公式バージョンと同等ではありません。
プロジェクトアドレス: OpenCut-app/OpenCut
簡単な答え
今すぐビデオをカットしたい場合は、まだ正式に実行されているクラシック バージョンを優先してください。新しいバージョンの Rust コア、プラグイン アーキテクチャ、MCP、ヘッドレス レンダリングを学習したい場合は、メインのリポジトリ開発環境を構築します。
新しいバージョンのプランには以下が含まれます。
- エディター API;
- サードパーティのプラグイン。
- Web、デスクトップ、モバイル端末は Rust コアを共有します。
- AI エージェント用の MCP サーバー;
- 自動バッチレンダリングのためのヘッドレスモード。
- エディタ内のスクリプト パネル。
これらは進歩の方向性であり、すべてが現在の安定した機能とみなされるべきではありません。
ローカル開発環境
公式には、moonrepo の proto は、修正バージョンの開発ツールを管理するために使用されます。 proto をインストールした後、リポジトリのルート ディレクトリで次を実行します。
|
|
Web 開発サービスはデフォルトで localhost:5173 を使用し、API 開発サービスはデフォルトで localhost:8787 を使用します。デスクトップでの使用:
|
|
デスクトップ ビルドでは、apps/desktop/README.md のプラットフォームの依存関係も参照する必要があります。特に Windows ユーザーは、Rust、システムコンパイルツール、WebView の実行環境が揃っているかどうかを最初に確認する必要があります。
新しいバージョンを運用ツールとして直接使用することが推奨されないのはなぜですか?
メイン リポジトリの README には、アーキテクチャがまだ設計中であり、外部からの貢献を受け入れる準備ができていないことが明確に記載されています。一般のユーザーの場合、次の 3 種類の問題が発生する可能性があります。
- 関数の入り口は存在しますが、保存、エクスポート、またはタイムラインの動作が変わります。
- ドキュメントとコマンドは書き換えにより迅速に調整されます。
- ブラウザのデモが実行できるからといって、デスクトップとモバイル端末が同じ安定性に達しているわけではありません。
したがって、唯一のビデオプロジェクトを開発バージョンに渡さないでください。テストする前に素材をバックアップし、エクスポートして再度再生して、オーディオとビデオの同期、解像度、フレーム レートを確認します。
OpenCut は誰に適していますか?
| 要件 | 提案 |
|---|---|
| 毎日使用する編集ソフトウェアを即座に置き換える | 最初にクラシックまたはその他の成熟したツールを試してください。 |
| オープンソースのビデオエディターアーキテクチャを学ぶ | 新しいモデレータ リポジトリを使用する |
| ビデオ プラグインまたは自動化の開発 | プラグイン API とヘッドレス パターンに焦点を当てる |
| AI エージェントが自動的に編集できるようにする | MCP とエディタ API が安定するまで待ってから評価してください。 |
クラシック バージョンとリライト バージョンのどちらを選択するか
現在、OpenCut に関する最も一般的な誤解は、公式 Web サイトで入手可能な Classic、メイン リポジトリの書き換えられたバージョン、および将来の計画を混同することです。ターゲット別に選択できます。
ビデオを切り取りたいだけです
まず、公式のクラシック バージョンを開き、公開されている短いクリップを使用して、インポート、トリミング、オーディオ、字幕、エクスポートをテストします。最初にメイン リポジトリを構築したり、プロジェクト ファイルのみを開発バージョンに渡したりしないでください。
ソースコードを勉強したい
apps/、Rust コア、Moon タスク構成の読み取りに重点を置いて、メイン リポジトリを使用します。開発サービスは個別に開始できるため、問題の特定に適していますが、各モジュールのインターフェイスは調整される可能性があります。
プラグインまたは自動化に参加したい
エディター API、プラグイン アーキテクチャ、ヘッドレス モード、MCP サーバーの実際の実装に引き続き注意してください。 README に記載されている指示は、インターフェイスがフリーズしていることを意味するものではありません。正式な開発の前に、対応するコード、発行、リリースを確認する必要があります。
開発環境の準備
proto use を実行する前に、次の基本条件を確認する必要があります。
- Git は通常どおりリポジトリをチェックアウトできます。
- オペレーティング システムには、Rust の依存関係をコンパイルするためのツール チェーンが備わっています。
protoコマンドがPATHに追加されました。- ポート
5173および8787は占有されていません。 - デスクトップに必要な WebView とシステム SDK がインストールされている。
- ディスクには、依存関係を保存し、キャッシュを構築するのに十分なスペースがあります。
proto use は、.prototools に従って修正バージョンのツールをリポジトリにインストールします。 Node.js または Rust がインストールされている場合はスキップしないでください。その目的は、開発者間のバージョンの違いを減らすことです。
サービスを個別に開始するメリットは何ですか?
OpenCut は、Web、API、デスクトップを異なるタスクに分割します。
|
|
トラブルシューティングを行う場合は、3 つの端末を開いてそれぞれログを保存することをお勧めします。ページを開けない場合は、まず Web サービスを確認してください。ページは開けるが、プロジェクトまたはマテリアルの操作が失敗する場合は、API を確認します。デスクトップウィンドウのみが異常である場合は、最後にデスクトップの実行環境を確認してください。
Webサービスのチェック
http://localhost:5173 にアクセスし、ブラウザの開発者ツールを開き、コンソール エラーと localhost:8787 へのリクエストを確認します。リクエストアドレスが間違っている場合は、まずローカル環境変数とリポジトリドキュメントを確認してください。 CORS を直接オフにしないでください。
APIサービスチェック
8787 がリッスンしていることを確認し、API エンドポイントで起動の失敗、データベースの初期化、または権限エラーがないか監視します。ポートの競合が発生した場合は、まず占有しているプロセスを見つけます。ポートを任意に変更して、サービスの 1 つだけを再起動しないでください。
デスクトップチェック
デスクトップ モードには通常、ブラウザーよりもネイティブ依存関係の層が 1 つ多くあります。 Web バージョンは機能するがデスクトップ バージョンが失敗する場合、問題はエディター インターフェイス自体ではなく、システム SDK、WebView、ファイル アクセス許可、またはパッケージ構成にある可能性が高くなります。
ビデオエディターをテストするときに確認すべき項目は何ですか?
インポート
少なくとも風景、ポートレート、可変フレーム レート、個別のオーディオを含む、さまざまなエンコードと解像度で短いクリップを準備します。どの形式がインポートできるか、またどの形式がサムネイルの表示のみ可能で再生できないかを記録します。
タイムライン
カット、ドラッグ、元に戻す、やり直し、マルチトラック同期をテストします。開発版で最もよくある問題は、ボタンが消えることではなく、操作後のタイムラインのステータスとプレビューが一致しないことです。
エクスポート
出力解像度、フレーム レート、継続時間、オーディオとビデオの同期、ファイル サイズを確認します。エクスポートが完了しても、結果が正しいとは限りません。プレーヤーを使用して完全に再生し、メディア情報ツールを使用してエンコード パラメーターを確認する必要があります。
プロジェクトの復旧
ページまたはデスクトップ プログラムを閉じて再度開き、プロジェクトが保存されているかどうか、マテリアル パスがまだ有効であるかどうか、および元に戻す履歴が期待どおりであるかどうかを確認します。リカバリーテストに合格しない限り、長いプロジェクトに取り組まないでください。
セルフホスト時の境界
ブラウザ側のビデオ編集は、CPU、GPU、メモリ、ローカル ストレージを消費します。独自のサーバーにデプロイされている場合でも、レンダリング作業がクライアント側で発生する可能性があります。セルフホスト型オプションを評価するときは、必ず次のことを行ってください。
- 素材はサーバーにアップロードされますか、それともブラウザ内に留まるだけですか?
- プロジェクト ファイルはどこに保存されますか?
- エクスポートはブラウザ、デスクトップ コア、またはサーバーによって完了しました。
- 一時ファイルのクリーニングメカニズムはありますか?
- 複数のユーザーが互いのプロジェクトまたはアセットを表示するかどうか。
データがデバイスから決して流出しないと推測するために「オープン ソース」だけに頼るのではなく、実際のネットワーク リクエストと展開構成を読み取る必要があります。
成熟した編集ソフトウェアと比較するときは、メニューだけを見てはいけません
| 寸法 | 実際に検証されている内容 |
|---|---|
| 安定性 | 長期編集、元に戻す、クラッシュ回復 |
| フォーマットのサポート | 実際のインポートおよびエクスポートのエンコーディング |
| パフォーマンス | プレビューの遅延、プロキシ メディア、レンダリング時間 |
| 字幕 | インポート、編集、スタイル設定、エクスポート |
| 自動化 | API、ヘッドレス、バッチタスクの成熟度 |
| エコロジー | プラグイン、テンプレート、チュートリアル、メンテナンスの速度 |
OpenCut の将来の道は興味深いものですが、移行の決定は現在の検証可能な機能に基づいて行う必要があります。
トラブルシューティングのクイックチェック
| 質問 | 優先順位のチェック |
|---|---|
proto が見つかりません |
インストールが完了したかどうか、端末が再起動されたかどうか、PATH |
moon run が失敗しました |
.prototools インストールが成功したかどうか、およびリポジトリのブランチが一致したかどうか |
| 5173 アクセスできません | Web タスクのログとポート占有 |
| ページは開けますが、操作エラーが発生します。 API サービス、8787 リクエストおよび環境変数 | |
| デスクトップで失敗しました | apps/desktop/README.md とシステムの依存関係 |
| 異常なエクスポート結果 | マテリアルのエンコード、レンダリング ログ、および出力パラメータ |
よくある質問
OpenCut は CapCut を完全に置き換えることができますか?
現時点では単純な結論を出すことはできません。基本的な編集シーンは試すことができますが、テンプレート、特殊効果、字幕、マテリアル エコロジー、クロスデバイス ワークフローなどは 1 つずつ比較する必要があります。
リポジトリは起動できるのに、正常にエクスポートできないのはなぜですか?
まず、クラシック バージョンを使用しているか書き直されたバージョンを使用しているかを確認し、対応するブランチとドキュメントを確認してください。メインリポジトリの開発サービスが正常に開始された場合、それはフロントエンドとバックエンドが実行できることを意味するだけで、すべての編集機能が完了したことを意味するわけではありません。
Docker を使用して、ワンクリックで新しいバージョンをデプロイできますか?
利用可能なイメージと Compose 構成があるかどうかは、現在のリポジトリのドキュメントに従う必要があります。開発サービスにはブラウザ、API、デスクトップが含まれるため、サードパーティのメンテナンスされていないイメージは、公式の安定した展開方法とみなされるべきではありません。
OpenCut の MCP をバッチ編集に使用できるようになりましたか?
README には、書き換えの指示の 1 つとして MCP がリストされています。実際にアクセスする前に、現在のコードとリリースで利用可能なサーバー、ツール リスト、および権限の説明が提供されていることを確認する必要があります。計画テキストのみに基づいて生産タスクを構成することはできません。
書き換えの進行状況を追跡する方法
OpenCut のメイン リポジトリは急速に変化します。ある機能が使用可能かどうかを判断するには、次の順序で確認してください。
- 現在のステータスの説明を読んでください。
- リリースに対応するバージョンがあるかどうか。
- コード内に実際の実装があるかどうか。
- 問題に制限または既知の障害が付いているかどうか。
- 新しいバージョンのデモ ステーションでも同じ操作を完了できるかどうか。
- ローカル チェックアウトのバージョンが提出された文書と一致しているかどうか。
スクリーンショット、ロードマップ、サードパーティのビデオだけを見るのはやめてください。特に MCP、ヘッドレス、およびプラグイン API は、安定したインターフェイス、権限の説明、再現可能なサンプルが利用可能になってからのみ、運用自動化の開発に適しています。
開発バージョンのアップグレードとロールバック
アップグレードする前に、現在の Git コミットと .prototools によって解析されたツールのバージョンを記録します。ローカルに変更がある場合は、まずブランチを作成して送信します。直接プルして、依存関係のアップグレードとビジネスの変更を混合しないでください。
推奨される手順:
|
|
次に、Web、API、デスクトップのタスクをそれぞれ開始し、インポート、タイムライン、エクスポート、およびリカバリのテストを再実行します。新しいバージョンを使用できない場合は、記録されたコミットに戻って比較できますが、保存されていないマテリアルやコードを破棄するために破壊的な Git コマンドを使用しないでください。
マテリアルとプライバシーのチェック
開発版のテスト時は、公開可能な短い素材を使用し、顧客動画、顔写真、未発表商品、位置情報付きオリジナル動画などは避けてください。ブラウザのネットワーク パネルを開いて、アップロード要求とサードパーティのドメイン名を確認します。デスクトップ上で、キャッシュ、一時ファイル、クラッシュ ログにマテリアル パスが含まれているかどうかも確認します。
今後 MCP またはスクリプト機能を有効にする場合は、エディタ プロジェクト、マテリアル ディレクトリ、およびエクスポート ディレクトリを個別に認証する必要があり、デフォルトでエージェントがユーザー ホーム ディレクトリ全体を読み取らないようにする必要があります。
概要
OpenCut は注目に値しますが、最も重要なメッセージは「現在書き換え中」です。一般のユーザーは現在のエントリ ポイントとして Classic を使用する必要がありますが、開発者は proto および moon を使用して新しいバージョンを検討できます。エディタ API、プラグイン、ヘッドレス レンダリングが安定したら、自動化された制作プロセスに入るのがより適切になります。