トラブルシューティング

よくある問題と解決方法をまとめています。

起動・表示の問題

起動しない / すぐに終了する

以下の点を確認してください：

• Windows 10 / 11（64ビット）以外の OS では動作しません
• DirectX 12 対応 GPU が必要です。グラフィックドライバーを最新に更新してください
• %APPDATA%\mimageviewer\settings.db が破損している場合、通常はアプリが起動時に自動でバックアップから復旧します。アプリが起動できる場合は 設定メニュー →「設定の復元…」から過去 10 世代のバックアップを選んで戻したり、設定を完全リセットできます（操作前の状態は別名でバックアップされます）
• アプリが起動すらしない場合は、いったんアプリを終了してから、%APPDATA%\mimageviewer\ フォルダ内で 「settings.db」で始まるファイルすべて（settings.db / settings.db.bak1〜bak10 / その他関連ファイル）をまとめて削除するか別フォルダへ退避してください。settings.db 単体だけを削除すると関連ファイルが残って復旧経路に入らないことがあります。すべて削除すると設定が初期状態に戻ります
• ウイルス対策ソフトによってブロックされていないか確認してください

画面が真っ黒 / 何も表示されない

• GPU ドライバーを最新バージョンに更新してください
• ウィンドウを移動したり、最小化して元に戻したりすると改善する場合があります
• 他のアプリを同時にたくさん起動している場合は、GPU メモリ不足の可能性があります

文字化けする

日本語フォントが正しくインストールされているか確認してください。 Windows 11 では「游ゴシック」が標準搭載されています。 Windows 10 の場合、フォントが欠落している場合があります。

画像表示の問題

HEIC / AVIF / RAW ファイルが表示されない

WIC コーデックが必要です。Microsoft Store から対応するコーデックをインストールしてください。

1. Microsoft Store を開きます（スタートメニューから「Microsoft Store」を検索）
2. 「HEIF 画像拡張機能」（HEIC/HEIF 用）または「Microsoft Raw 画像拡張機能」（RAW 用）を検索します
3. インストールします（無料）
4. mImageViewer でフォルダを再度開きます（再起動不要）

画像が回転して表示される

スマートフォンで縦向きに撮影した JPEG は EXIF に向き情報が含まれています。 また、mImageViewer で非破壊回転を適用した画像は回転情報データベースに保存されます。 意図しない回転がある場合は、設定メニュー →「回転情報をリセット…」で すべての回転情報をクリアできます。

GIF アニメーションが再生されない

• グリッド表示ではアニメーションは再生されません。ダブルクリックでフルスクリーン表示に切り替えてください

AI 生成メタデータが表示されない

• 対応形式は PNG のみです（JPEG などには対応していません）
• 一部の AI ツールは独自形式でメタデータを埋め込むため、表示できない場合があります
• メタデータが含まれているか確認するには、ファイルのプロパティ → 詳細 タブを参照してください

パフォーマンスの問題

サムネイルの読み込みが遅い

• 初回読み込み時は画像をデコードするため時間がかかります。2 回目以降はキャッシュから高速に読み込まれます
• キャッシュが無効になっている場合は、設定 →「環境設定…」→ キャッシュ でキャッシュを有効にしてください
• RAW ファイルや大容量の TIFF ファイルはデコードに時間がかかります
• ネットワークドライブ上のファイルはローカルより遅くなります

スクロールがカクカクする

• 大量の画像（1000 枚以上）が含まれるフォルダでは描画負荷が高くなります
• サムネイルサイズを小さくすると 1 画面に表示される枚数が増えますが、描画負荷も上がります。適度なサイズに調整してください
• GPU ドライバーを最新に更新してください

メモリ使用量が多い

mImageViewer はフルスクリーン表示時、前後数ページ分の画像を GPU メモリにキャッシュします。 GPU メモリが不足する場合は、表示解像度を下げるか他の GPU を使用するアプリを終了してください。

ファイル操作の問題

削除できない / アクセス拒否される

• 他のアプリがファイルを開いている場合は削除できません
• 読み取り専用属性が設定されているファイルは削除できません。エクスプローラーでプロパティを確認してください
• ネットワーク共有やシステムフォルダ内のファイルはアクセス権限が必要です

PDF が表示されない / ページが真っ白

• PDF ファイルが破損している可能性があります。Adobe Acrobat Reader など他のアプリで開けるか確認してください
• 暗号化された PDF の場合、パスワード入力ダイアログが表示されます。正しいパスワードを入力してください
• 保存済みパスワードが無効になっている場合は、%APPDATA%\mimageviewer\pdf_passwords.json を削除してリセットできます

ZIP 内の画像が表示されない

• パスワード付き ZIP には対応していません
• ZIP ファイルが破損している可能性があります。別の解凍ツールで確認してください
• 非常に古い形式（ZIP 1.0 以前）には対応していない場合があります

設定・キャッシュのリセット

設定をリセットしたい

アプリが起動できる場合は、設定メニュー →「設定の復元…」 を使うのが最も簡単です。

• 過去 10 世代までのバックアップ（bak1〜bak10）が一覧表示され、選んだ世代に巻き戻せます
• 同じダイアログの下部にある 「設定を完全リセット…」 ボタンで、設定を初期状態に戻せます
• どちらの操作も実行前の状態は別名で自動バックアップされるため、間違った場合でも手動で復元できます

アプリが起動しないなど上記のダイアログが使えない場合は、以下のファイル・フォルダを手動で削除してリセットします：

NVIDIA GeForce オーバーレイが表示される

mImageViewer は GPU（wgpu / DirectX 12）を利用して描画を行います。 NVIDIA GeForce Experience または NVIDIA App がインストールされている環境では、 フルスクリーン表示時にゲームオーバーレイが表示されることがあります。

これは NVIDIA がグラフィックス API を使用するアプリケーションをゲームとして検出するためで、 mImageViewer 側で回避することはできません。以下の手順でオーバーレイを無効化してください：

• NVIDIA App の場合：設定 → 全般 →「ゲーム内オーバーレイ」をオフ
• GeForce Experience の場合：設定 → 全般 →「ゲーム内のオーバーレイ」をオフ

それでも解決しない場合

上記の方法で解決しない場合は、設定のリセットをお試しください。 それでも改善しない場合は、開発者までお問い合わせください。

不具合を報告するとき

「動画が再生できない」「特定の操作でおかしくなる」といった不具合を報告するときは、 動作ログを添えていただけると原因の特定が早くなります。

1. 環境設定 →「開発者」を開きます。
2. 「ログを zip にする」ボタンを押します。デスクトップに mImageViewer_diag_(日時).zip が作成されます。
3. その zip を不具合の内容と一緒に開発者へ送ってください。

動作ログとエラーログは常に記録されているため、不具合が起きた直後にこの操作をすれば その記録がそのまま zip に含まれます。「動作が重い・カクつく」系の不具合では、先に同じ 「開発者」画面で「性能ログを記録する」を ON にしてアプリを再起動し、 症状を再現してから zip を作成してください。