davinci-resolve-troubleshooting について
DaVinci Resolve のよくある 5 種類の不具合を診断するスキルです。編集者向けに、原因を特定してから症状に応じた対処を進めます。
主な機能
- 01再生のボトルネック診断
- 02オフラインメディアの再リンク
- 03音声同期ずれの調査
- 04レンダリングクラッシュの分析
- 05停止したレンダーキューの対処
活用シーン
- 01再生表示が赤いときにドライブや GPU の制約を特定
- 02プロジェクト移行後にオフラインクリップを復旧
- 03長いタイムラインの音声ずれを修正
- 04レンダリングのクラッシュや出力ファイル欠落を調査
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ chaiwithjai/ davinci-resolve-claude-skills --skill davinci-resolve-troubleshootingインストール後、Claude Code で/davinci-resolve-troubleshootingを入力して読み込まれたか確認します。
詳細
DaVinci Resolve — よくある 5 つの破損モードのトラブルシューティング
概要
DaVinci Resolve のサポート質問の約 90% を占める 5 つの問題に対する診断プロトコルです。ドロップフレームの再生、メディアの欠落、音声の同期ずれ、レンダリングのクラッシュ、レンダーキューの停止。原則は次のとおりです。修正する前に診断する。赤いインジケーターを判定ではなくデータとして扱ってください。
使用する場面
症状:
- 再生中に赤い GPU / 再生インジケーターが表示される
- クリップに赤い斜線が表示される (オフラインメディア)
- 時間の経過とともに音声が同期からずれる
- Resolve がレンダリング中、またはレンダリング開始から数分後にクラッシュする
- レンダーキューが「完了」と表示するのに、出力ファイルが存在しない、または 0 バイトである
- 「Resolve で X が壊れているのはなぜか」 — これらのいずれか。
使用しない場面:
- Resolve がまったく起動しない — これはインストールの問題です (
davinci-resolve-setupを参照してください)。 - ライセンスエラーが発生している — Blackmagic サポートに連絡してください。
- 問題がクリエイティブなもの (「自分の編集の見た目が気に入らない」) — トラブルシューティングの問題ではありません。
クイックリファレンス — 5 つの診断フロー
| 症状 | 最初の確認 | 次に |
|---|---|---|
| 赤い再生インジケーター | メディアドライブで Blackmagic Disk Speed Test を実行する | ドライブが十分に高速なら、プロキシを生成する |
| クリップがオフライン (赤い斜線) | クリップを右クリック > メディアの再リンク | またはビンのソースフォルダーを変更する |
| 音声が同期していない | タイムラインのフレームレートがソースのフレームレートと一致しているか確認する | 自動同期 (波形またはタイムコード) を使用する |
| レンダリング中にクラッシュする | レンダリングの並列処理を減らし、ハードウェアアクセラレーションを無効にする | コンソールで正確なエラーを確認する |
| レンダーキューが 0% で停止している | 出力ドライブのディスク容量を確認する | カスタムエクスポートのファイル名に無効な文字がないか確認する |
手順 — 問題ごとの診断フロー
問題 1: 赤い再生インジケーター (ドロップフレーム)
Resolve がリアルタイム再生を維持できないとき、ソース / タイムラインビューア上部のインジケーターが赤く変わります。
ステップ 1.1 — ボトルネックを特定します。それは ドライブ でしょうか、それとも GPU でしょうか?
- DaVinci Resolve > 環境設定 > システム > メモリと GPU を開きます。再生中の GPU 使用率を確認します。
- 再生中の GPU が 80% 未満なら、ボトルネックは ドライブ (読み取り速度) です。
- GPU が 100% で張り付いているなら、ボトルネックは GPU です (トーキングヘッドのコンテンツではまれで、4K + 重いカラーグレーディングではよくあります)。
ステップ 1.2 — ドライブがボトルネックなら、Blackmagic Disk Speed Test を実行します:
- 無料アプリで、Mac App Store (macOS) または Desktop Video インストーラー (Windows) からインストールします。
- メディアドライブを指定します。「Will It Work?」の表を見ます。お使いのコーデックが、その解像度とフレームレートで緑のチェックマークになっていることを確認します。
- ドライブが必要な読み取り速度を維持できない場合、2 つの選択肢があります:
- メディアをより高速なドライブ (NVMe SSD、Thunderbolt) に移動する。
- プロキシを生成する (ステップ 1.3 を参照してください)。
Editor's Guide の 326 ページに Blackmagic Disk Speed Test の使用法が詳しく説明されています。
ステップ 1.3 — ドライブをアップグレードできない場合は、プロキシを生成します。
- メディアプールでクリップを右クリック > プロキシメディアを生成。
- プロキシ形式を選択します: H.264 ハーフレゾリューション 1080p が編集の既定値として適しています。
- プロキシの生成を待ちます。
- ビューア上部の プロキシ処理 メニューを プロキシを優先 に切り替えます。
- これで再生が緑になるはずです。
ステップ 1.4 — 納品前に、カメラオリジナルに戻します:
- プロキシ処理 > カメラオリジナルを優先。Resolve はプロキシではなく高品質のソースからレンダリングします。
Editor's Guide の 324〜337 ページに、別アプリである Blackmagic Proxy Generator を含むプロキシワークフロー全体が説明されています。
これが扱う誤解: 「赤いインジケーターはコンピューターが遅すぎるという意味だ」。多くの場合、遅いのは GPU ではなくドライブです。まず診断してください。
問題 2: クリップがオフラインになる (赤い斜線)
メディアプールまたはタイムライン上のクリップサムネイルに赤い斜線が表示される場合、Resolve がそのクリップがインデックスされたパスでソースファイルを見つけられないことを意味します。
ステップ 2.1 — 1 つのクリップだけなのか、すべてのクリップなのかを判断します。
- ビン内のすべてのクリップがオフラインの場合、ソースフォルダーが移動したか、ドライブがマウント解除されています。
- 1 つまたは 2 つのクリップがオフラインの場合、それらの特定のファイルが移動または名前変更されています。
ステップ 2.2 — すべてのクリップがオフラインの場合 (典型的なケース: プロジェクトを新しいマシンに移動した場合):
- 影響を受けているビンを右クリック > Change Source Folder。
- このマシン上の実際の現在のメディアの場所を参照します。
- Change をクリックします。ビン内のすべてのクリップが 1 回の操作で再リンクされます。
Editor's Guide p. 336 には Clip Operations > Change Source Folder が記載されています。
ステップ 2.3 — 個別のオフラインクリップの場合:
- クリップを右クリック > Relink Selected Clips。
- ファイルを参照します。Resolve はそのクリップだけを再リンクします。
ステップ 2.4 — ファイルが本当にもう存在しない場合:
- バックアップフォルダーを確認します (
davinci-resolve-setupはバックアップフォルダーの場所をカバーしています)。 - または、削除した可能性がある場合は
~/.Trash/ ゴミ箱を確認します。 - ファイルが本当に失われている場合は、再撮影するか、ソースから再エクスポートする必要があるかもしれません。
問題 3: オーディオが同期からずれる
オーディオは最初は同期していますが、時間の経過とともにずれていきます (例: 10 分後に 1 秒ずれる)。
ステップ 3.1 — ソースクリップのフレームレートがタイムラインのフレームレートと一致していることを確認します。
- メディアプール内のソースクリップを右クリック > Clip Attributes。
- クリップの Frame Rate を確認します。
- File > Project Settings > Master Settings > Timeline frame rate。一致していることを確認します。
- それらが異なる場合 (例: クリップが 29.97 fps だがタイムラインが 24 fps)、Resolve はオーディオを異なる方法で解釈します。これがずれの最も一般的な原因です。
ステップ 3.2 — オーディオのサンプルレートを確認します。
- Clip Attributes > Sample Rate (通常は 48000 Hz)。
- Project Settings > Master Settings > Sample Rate。それらを一致させます。
ステップ 3.3 — 映像とオーディオが別々に録音されている場合 (デュアルシステムオーディオ)、それらを再同期します。
- メディアプールで、映像クリップとオーディオクリップを一緒に選択します。
- 右クリック > Auto Sync Audio。
- Based on Waveform (タイムコードなしで機能します) または Based on Timecode (両方に一致するタイムコードがある場合はより高速です) を選択します。
- Resolve は 2 つのクリップを 1 つの同期されたクリップに整列します。
Editor's Guide pp. 267-277 にはオーディオ同期のワークフローが記載されています。
ステップ 3.4 — ハードウェアクロックのずれ (例: 外部オーディオレコーダーとカメラ) によって引き起こされるずれの場合:
- インスペクターでオーディオクリップの Stretch パラメーターを使用して、ごくわずかな量 (0.5% 以下) だけ遅く/速くします。
- または、オーディオを複数のセクションに分割し、各セクションを再同期します。
問題 4: レンダリング中に Resolve がクラッシュする
ステップ 4.1 — 実際のエラーについてコンソールを確認します。
- Workspace > Console でコンソールパネルが開きます。
- クラッシュ前の最後のメッセージを確認します。よくある原因:
- 「Out of memory」 — レンダリングフレームレートを下げるか、他のアプリを閉じます
- 「GPU error」 — ハードウェアデコードを無効にします (4.2 を参照)
- 「File system error」 — ディスクがいっぱいか、ドライブが切断されています
ステップ 4.2 — GPU エラーが表示される場合は、ハードウェアアクセラレーションを無効にします。
- Preferences > Decode Options > Decode H.264/H.265 using hardware acceleration のチェックを外します。
- これは遅くなりますが、特に古いシステムや混在 GPU システムではより安定します。
ステップ 4.3 — レンダリングの並行処理を減らします。
- レンダリング中の一部の Resolve クラッシュは、(デュアル GPU マシンで) 両方の GPU を使用しようとすることで発生します。
- Preferences > System > Memory and GPU > GPU 処理モードを CUDA または Metal に明示的に設定します (Auto ではなく)。
- Resolve を再起動します。
ステップ 4.4 — ディスクの空き容量を確保します。
- レンダリングでは、処理中にソースファイルサイズの 2〜3 倍のスクラッチ領域が必要です。
- メディアドライブと出力ドライブの両方に少なくとも 50 GB の空き容量があることを確認します。
問題 5: レンダーキューが 0% で止まる
レンダーは「Render in Progress」と表示されているのに、ディスク上のファイルサイズが増加しない。
ステップ 5.1 — 出力ファイル名に無効な文字がないか確認します。
- macOS のファイルシステムでは、ファイル名に
:を使用できません。Windows では< > : " / \ | ? *を使用できません。 - レンダープリセットに
%timeline_nameが含まれていて、タイムライン名にコロンやスラッシュが含まれている場合、レンダーは通知なしに失敗します。 - まずタイムラインの名前を変更するか、カスタムエクスポートのファイル名を通常の文字を使うように変更してください。
ステップ 5.2 — 出力フォルダーが存在し、書き込み可能であることを確認します。
- レンダー設定の Location フィールドを確認します。Finder/エクスプローラーで手動でその場所を開いてください。
- 存在しない場合は、作成してください。
- 存在するものの別のユーザーが所有している場合は、権限を変更するか、別の場所を選択してください。
ステップ 5.3 — レンダーのフレーム範囲を縮小します。
- 特定のクリップが破損している場合、レンダーはそのフレームで停止します。
- レンダー設定で、Render を「Entire Timeline」から「In/Out Range」に変更し、問題が疑われるフレームの前に Out ポイントを設定します。
- これで完了する場合は、数秒ずつ進めながら問題のあるフレームを探します。
ステップ 5.4 — Resolve を再起動します。
- 上記すべてが失敗した場合は、Resolve を強制終了し (macOS では Force Quit、Windows ではタスクマネージャー)、プロジェクトを再度開きます。レンダーキューは長時間のセッションの後に止まることが多く、再起動で解消されます。
よくある間違い
- 赤いインジケーター = 古いコンピューターだと思い込む -> 多くの場合、原因は GPU ではなくドライブです。まず Blackmagic Disk Speed Test で診断してください。(これは、このスキルが真正面から扱う誤解です。)
- オフラインクリップを再リンクではなく再インポートする -> 再インポートするとすべての編集が失われます。常に再リンクしてください。
- デュアル GPU システムで Resolve に GPU を自動選択させる -> 手動で CUDA または Metal を明示的に設定してください。自動ではクラッシュすることがあります。
- タイムライン名にコロンやスラッシュを使う -> レンダーは通知なしに失敗します。英数字、アンダースコア、ハイフンを使用してください。
検証
以下のすべてが当てはまる場合、成功です:
- タイムラインを 30 秒間再生している間、再生インジケーターが緑である。
- メディアプール内のすべてのクリップにサムネイルがある (赤い斜線ではない)。
- タイムライン全体を通して、オーディオ波形が映像の動作と一致している (スレートの拍手がスレートの映像と一致し、口の動きが発話と一致する)。
- レンダーが完了し、出力ファイルが想定されたサイズと長さである。
- 5 つの問題のうちどれが当てはまったか (またはどれも当てはまらなかったか) を名前で特定できる。
転用
次に、新しい 破損モードに遭遇したときにこれを試してください — たとえば、正しくレンダーされない Fusion コンポジションなどです。同じ診断プロトコルを適用します: (1) 症状を正確に特定する、(2) 実際のエラーメッセージがないか Console を確認する、(3) 範囲を縮小して (その Fusion コンポジションのセグメントだけをレンダーする) 原因を切り分ける、(4) プロジェクトに適用する前にコピーで修正をテストする。この問題解決の規律は、上記の 5 つのケースを超えて応用できます。
実用的なリファレンス
docs/wiki/editors-guide.md#lesson-6--ai-workflows-pp-323-387(Disk Speed Test、プロキシ、再リンクのワークフロー — 主要)docs/wiki/editors-guide.md#lesson-5--project-organization-pp-245-321(オーディオ同期、フレームレートの一致)docs/wiki/colorist-guide.md#lesson-8--adjusting-image-properties-pp-343-379(Color ページの再生のための Render Cache)docs/wiki/master.md#reset-matrix--when-the-user-pushes-back-read-this(すべてのトラブルシューティングの症状行はここに対応します)
エージェントの動作が期待どおりにならない場合(コンテキスト・ロットのリセット)
ユーザーが、診断フローで症状が解決しなかったと報告した場合(赤い再生が戻る、クリップが依然としてオフライン、レンダリングが依然として失敗する)、以下に示す PDF のページ範囲を読んでリセットしてください:
DaVinci-Resolve-20-Editors-Guide.pdfp. 326(ドライブは十分な速度ですか? — Blackmagic Disk Speed Test)DaVinci-Resolve-20-Editors-Guide.pdfpp. 324-340(プロキシファイルの生成 — Blackmagic Proxy Generator を含む完全なワークフロー)DaVinci-Resolve-20-Editors-Guide.pdfp. 336(一括再リンクのためのソースフォルダーの変更)DaVinci-Resolve-20-Editors-Guide.pdfpp. 267-277(音声のビデオへの同期とチャンネル設定)DaVinci-Resolve-20-Editors-Guide.pdfpp. 597-617(デリバープリセットのカスタマイズ、レンダリング失敗の原因)DaVinci-Resolve-20_Beginners-Guide.pdfpp. 6-8(メディアファイルの再リンク)DaVinci-Resolve-20_Beginners-Guide.pdfpp. 350-364(音声のビデオへの同期)DaVinci-Resolve-20-Colorist-Guide.pdfpp. 369-377(レンダーキャッシュによるパフォーマンスの最適化 — カラーページの再生用)