トラブルシューティング

OpenShotでフリーズ、クラッシュ、エラーメッセージなどの問題が発生している場合、問題解決に役立つさまざまな手法があります。

問題のトラブルシューティングにログを使用する

ログは、OpenShotが行っている操作や警告、エラーを記録するテキストファイルです。これらのファイルは、画面にエラーメッセージが表示されなくても、サポートチームが問題を理解するのに役立ちます。

OpenShotはホームフォルダ内の.openshot_qtフォルダに2つのログファイルを保存します。LinuxやmacOSでは、この場所は~/.openshot_qt/と表記されます。このフォルダはファイルマネージャで隠しフォルダになっている場合があります。

2つのログファイル
ファイル	記録内容
`openshot-qt.log`	エディタの動作：OpenShotの起動、プロジェクトの読み込み、設定の変更、インターフェースの使用。問題を調査する際には通常ここから始めるのが最適です。
`libopenshot.log`	OpenShotのビデオおよびオーディオエンジンの動作。メディアを読み込み、プレビューや書き出し動画で使用される映像と音声を生成する部分です。詳細なエンジンログは再生や書き出しの問題調査に役立ちます。

これらのファイルは同じアプリケーションの異なる部分を記録しています。問題を報告する際は、両方のファイルを可能な限り添付してください。すべての行を自分で理解する必要はありません。

OpenShotのどの部分をログに記録するか選択する

編集 → 設定 → 詳細 を開くと、これら2つの設定が見つかります：

設定と対応するターミナルオプション
設定	対応する引数	ログファイル
ユーザーインターフェースデバッグログ	`--debug-ui`	`openshot-qt.log`
ビデオ＆オーディオエンジンデバッグログ	`--debug-engine`	`libopenshot.log`

両方の設定はデフォルトでオフになっており、通常の概要メッセージが保持されます。どちらかをオンにすると、そのログファイルに詳細が即座に追加されます。他のログやターミナルのメッセージには影響しません。設定はオフにするまで起動間で有効のままです。

ユーザーインターフェースデバッグログ は、起動、プロジェクトの読み込み、設定、インターフェースの問題の調査に適した出発点です。ビデオ＆オーディオエンジンデバッグログ は映像と音声処理の詳細を追加し、再生や書き出しの問題調査に役立ちます。エンジンログは非常に大きくなりやすく、OpenShotの動作を遅くする可能性があります。問題を再現する直前にこの設定をオンにし、終了後にオフにしてください。

エンジンの設定は以前は デバッグモード（詳細） と呼ばれていました。保存されたオン/オフの設定は新しい名前に引き継がれます。

1回の起動でターミナルを使用する

ターミナルはコマンドを入力するウィンドウです。対応する引数は設定と同じ詳細を有効にし、ターミナルにも表示します：

openshot-qt --debug-ui

これは1回の起動のインターフェースの詳細を記録します。よく知られている --debug と短縮形の -d は --debug-ui と全く同じ意味です。ビデオとオーディオエンジンの詳細には、以下を使用してください：

openshot-qt --debug-engine

両方の詳細をまとめて収集するには：

openshot-qt --debug-ui --debug-engine

問題を引き起こす操作を繰り返し、その後OpenShotを閉じてログを収集してください。これらの引数は保存された設定を変更しません。通常通りOpenShotを起動すると、通常のログ設定に戻ります。

openshot-qt.log は約25MBに達すると新しいファイルを開始し、古いファイルを3つ保持します。libopenshot.log はメッセージが追加され続けるためサイズが増え続けます。必要なログを保存した後、OpenShotを閉じている間に古いログファイルを削除できます。

その他のコマンドラインオプション

ほとんどのユーザーは上記の2つの設定だけで十分です。以下のオプションは、ファイルやターミナルにどれだけ詳細を出力するかを選択できます。ここで、console はターミナル出力を意味します。

ログオプション
オプション	機能
`--debug-ui`, `--debug`, または `-d`	ユーザーインターフェースのデバッグログをファイルとターミナルの両方で有効にします。
`--debug-engine`	ビデオ＆オーディオエンジンのデバッグログをファイルとターミナルの両方で有効にします。
`--debug-file`	ターミナルの詳細を追加せずに、`openshot-qt.log` にエディタの詳細を追加します。
`--debug-console`	ファイルの詳細を追加せずに、ターミナルにエディタの詳細を表示します。
`--log-level LEVEL`	両方のログファイルとターミナル出力の詳細レベルを設定します。
`--log-file-level LEVEL`	両方のログファイルの詳細レベルを設定し、ターミナルの設定は変更しません。
`--log-console-level LEVEL`	エディターとエンジンの両方の端末での詳細レベルを設定し、ファイル設定は変更しません。

詳細なメッセージには LEVEL を debug に、通常の概要には info に置き換えてください。warning は警告とエラーを表示し、error はエラーと重大な障害を表示します。critical は重大な障害のみを表示します。off は通常のログメッセージを停止しますが、既存のクラッシュ診断は引き続き書き込まれる場合があります。大文字の DEBUG なども使用可能です。

例えば、端末は通常のレベルのままにして、両方のファイルで詳細なメッセージを収集するには：

openshot-qt --log-file-level debug

これにより大きなエンジンログも有効になるため、短時間だけ使用してください。古い --debug-file と --debug-console オプションも --help に表示されなくても引き続き動作します。

環境変数

環境変数とは、プログラム起動時に渡される名前付き設定です。スクリプトからOpenShotを起動する場合や、サポート担当者から特定の設定を試すように指示された場合に便利です。通常の使用では設定する必要はありません。

オプションの環境設定
変数	制御内容
`OPENSHOT_LOG_LEVEL`	両方のファイルと端末の詳細。
`OPENSHOT_LOG_FILE_LEVEL`	両方のファイルのみの詳細。
`OPENSHOT_LOG_CONSOLE_LEVEL`	OpenShotの両方の部分の端末のみの詳細。
`LIBOPENSHOT_LOG_LEVEL`	ビデオおよびオーディオエンジンのファイルと端末の詳細。
`LIBOPENSHOT_LOG_FILE_LEVEL`	`libopenshot.log` のみの詳細。
`LIBOPENSHOT_LOG_CONSOLE_LEVEL`	端末のみのエンジン詳細。

例えば、このLinux/macOSの端末コマンドは、1回の起動でエンジンの詳細なログをファイルに要求します：

LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt

設定が重複する場合、コマンドラインオプションが優先され、次に環境変数、次に設定、最後に通常のデフォルトが適用されます。各設定は記述された出力にのみ影響します：--debug はエンジンの設定を上書きしません。一時的な上書きは保存された設定を変更しません。どちらかのチェックボックスにカーソルを合わせると、他の設定がそのログファイルを制御しているか確認できます。

環境設定内では、エンジンに関して LIBOPENSHOT_ の値が OPENSHOT_ の値より優先されます。どちらのグループでも、ファイル専用またはコンソール専用のレベルが一般レベルより優先されます。コマンドラインオプションも同じファイル/コンソールのルールに従います。同じ出力に対する矛盾するコマンドラインレベルは拒否され、無効な環境レベルは報告され無視されます。

古いスクリプトでは、LIBOPENSHOT_DEBUG が存在する限り、その値が 0 でも端末で詳細なエンジンメッセージを有効にします。新しいレベル設定がこれより優先されます。LIBOPENSHOT_LOG_FILE はエンジンを別個に使用するプログラム向けで、OpenShot自体は上記のログフォルダーを使用します。ログ設定の変更はエラー報告の設定を変更しません。

Windows 11が応答しない

Windows 11でフリーズが発生する場合、これはPyQt5とWindows 11の既知の問題で、Qtのアクセシビリティ機能に関連しています。これはOpenShotで Ctrl+C を押すことで発生します（Windows 11のみ ）。OpenShotが応答しなくなり、メモリリークも発生します（つまり、OpenShotが応答しない時間が長くなるほどメモリリークが大きくなり、最終的にOpenShotがクラッシュするか、ユーザーがプロセスを終了させるまで続きます）。

簡単な回避策として、Windows 11では Ctrl+C を避け、代わりに右クリックのコピー/貼り付けメニューを使用してください。別の回避策として、「コピー」のキー割り当てを Ctrl+C から別のキー（例： Alt+C ）に変更することもできます。キーボードの割り当てはOpenShotの設定で変更可能です。詳細はキーボードを参照してください。

WindowsでのGDBによるデバッグ

Windows 10/11でOpenShotがクラッシュまたはフリーズする場合、以下の手順に従うことでクラッシュの原因を特定できます。これらの手順は、クラッシュ箇所のOpenShotのソースコードのスタックトレースを表示します。この情報は開発チームにとって非常に有用であり、バグ報告に添付すると迅速な解決に役立ちます。

MSYS2をインストールする

Windows版OpenShotはMSYS2という環境を使ってコンパイルされています。GDBデバッガを実行ファイル openshot-qt.exe に接続するには、まずMSYS2をインストールする必要があります。この手順は一度だけ行えば十分です。

MSYS2をダウンロード＆インストール: http://www.msys2.org/
MSYS2 MinGW x64 コマンドプロンプトを起動します（例：C:\msys64\msys2_shell.cmd -mingw64 ）
すべてのパッケージを更新する（以下のコマンドをコピー＆ペースト ）:
```
pacman -Syu
```
GDBデバッガをインストールする（以下のコマンドをコピー＆ペースト ）:
```
pacman -S --needed --disable-download-timeout mingw-w64-x86_64-toolchain
```

GDBデバッガでOpenShotを起動する

MSYS2 MinGW x64 コマンドプロンプトを起動します（例：C:\msys64\msys2_shell.cmd -mingw64 ）

PATHを更新する（以下のコマンドをコピー＆ペースト ）:

export PATH="/c/Program Files/OpenShot Video Editor/lib:$PATH"
export PATH="/c/Program Files/OpenShot Video Editor/lib/PyQt5:$PATH"

GDBデバッガにOpenShotを読み込む（以下のコマンドをコピー＆ペースト ）:

cd "/c/Program Files/OpenShot Video Editor"/
gdb openshot-qt.exe

GDBプロンプトからOpenShotを起動する（以下のコマンドをコピー＆ペースト ）:

run --debug

デバッグ情報を表示する

GDBを接続してOpenShotが正常に起動したら、OpenShotでクラッシュやフリーズを発生させてください。クラッシュが発生したら、MSYS2 MinGW64のターミナルに戻り、以下のコマンドのいずれかを入力してENTERを押します。通常、最初に入力するコマンドは bt （バックトレースの意味）です。その他のコマンドも以下に記載されています。

(gdb) run            (launch openshot-qt.exe)
(gdb) CTRL + C       (to manually break out   OR   wait for a crash / segmentation fault)
(gdb) bt             (Print stack trace for the current thread #)
(gdb) info threads   (to view all threads, and what they are doing. Look for `__lll_lock_wait` for Mutex/deadlocks)
(gdb) thread 35      (Switch to thread number, for example thread 35)

高DPI / 4Kモニター

OpenShot Video Editor は高DPI（ドット毎インチ）モニターを強力にサポートしており、さまざまなDPI設定のディスプレイでもインターフェースが鮮明で読みやすく表示されます。このサポートは特に4Kモニターやその他の高解像度ディスプレイで役立ちます。

モニターごとのDPI認識

OpenShotはモニターごとにDPIを認識しており、接続されている各モニターのDPI設定に応じてスケーリングを動的に調整できます。これにより、異なるディスプレイ間で一貫した操作感が得られます。

WindowsでのDPIスケーリング

Windowsでは、OpenShotは視覚的な整合性を保つためにスケーリング係数を最も近い整数値に丸めます。これによりUIの視覚的な乱れを防ぎ、インターフェース要素を鮮明かつ整然と保ちます。この丸め処理のため、一部のスケーリング設定では予想より大きなフォントやUI要素になることがあります。

125% のスケーリング は 100% に丸められます
150% のスケーリング は 200% に丸められます

細かい調整のための回避策

丸め処理はクリーンなインターフェースを維持するのに役立ちますが、より正確なスケーリング制御を必要とするユーザー向けの回避策もあります。これらの方法は視覚的な乱れが生じる可能性があるため、推奨されません：

QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough
- この環境変数を設定すると丸め処理が無効になり、より正確なスケーリングが可能になります。
- 注意： これにより特にタイムラインで視覚的な乱れが生じる可能性があり、推奨されません。
QT_SCALE_FACTOR=1.25 （または類似の値）
- スケールファクターを手動で設定することで、フォントやUIのスケーリングをより細かく調整できます。
- これは設定の「ユーザーインターフェースのスケール」からも設定可能ですが、Windowsで小数のスケールを使うと境界線やラインの問題が発生することがあります。
- 注意： この方法も視覚的な乱れを引き起こし、OpenShotの操作が難しくなる可能性があります。

これらの環境変数の調整に関する詳細は、https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large をご覧ください。