トラブルシューティング

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

起動・表示の問題

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

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

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

起動に時間がかかる / 起動中に固まる

• 初回起動時はプログラム本体や動画再生用のデータを展開するため、通常より時間がかかります。しばらく待っても進まない場合は一度終了し、もう一度起動してください（2 回目以降は速くなります）
• グラフィックドライバーを最新バージョンに更新してください。古いドライバーでは起動時の GPU 初期化で停止する場合があります
• ウイルス対策ソフトが展開直後のファイルをスキャンしていると、初回起動が遅くなることがあります

NAS・ネットワークドライブに置いて使う

画像を NAS やネットワークドライブに置いて開くことは、通常の使い方です。 ここで説明するのは、mImageViewer が使うデータ（サムネイルや検索用の索引など） まで同じ場所に置いた場合の話です。

複数の端末から同じ画像を見たいためにネットワーク上へ置いている場合は、 リモート閲覧のほうが向いています。画像のある PC で mImageViewer を動かし、ほかの PC やスマートフォンのブラウザから開く方法です。 データを共有しないので、上の問題は起きません。ただしブラウザから使えるのは 閲覧を中心とした機能に限られ、接続には Tailscale の設定が必要です。

本体をネットワーク上に置いたままにしたい場合は、mImageViewer が使うデータだけを PC 内へ移せます。この場合、データはその PC ごとに別々になります。 設定や既読の状態は PC 間で共有されませんが、複数の PC から使うなら、これが安全な唯一の方法です。

フォルダごとに設定を分けて使う

NAS 上のフォルダごとに別々の設定や履歴で使いたい場合は、本体を PC 内に 1 つだけ置き、 各フォルダには起動用のバッチファイルを置いて、データの保存先を --data-dir で分けます。画像は NAS 上のままで構いません。

たとえば本体を C:\Tools\mImageViewer\ に置いた場合、NAS の各フォルダに 次の内容で mIV.bat を作ります。

@echo off
start "" "C:\Tools\mImageViewer\mimageviewer.exe" --data-dir "C:\Tools\mImageViewer\data-manga" "%~dp0."

• data-manga の部分をフォルダごとに別の名前にすると、設定・履歴・サムネイルがフォルダごとに分かれます。名前は半角英数字にしてください
• 最後の "%~dp0." は、バッチファイルを置いたフォルダを開く指定です
• start の直後の "" は消さないでください。ないと mImageViewer が起動しません
• 保存先が違えば、複数を同時に起動できます

このバッチファイルを別の PC から使う場合も、データはその PC の中に作られます。 設定や履歴は PC ごとに別々になります。

また、遅さの原因が画像の読み込み自体にあることもあります。 どちらが効いているかは、次の方法で切り分けられます。

B では画像を NAS に置いたまま、mImageViewer が使うデータだけを PC 内へ変えます。

B のショートカットを作る

1. Windows+R を押し、%LOCALAPPDATA% と入力して Enter を押します。開いたフォルダのパスを確認します
2. デスクトップを右クリックし、新規作成 → ショートカットを選びます
3. 「項目の場所」に、mImageViewer 本体の場所と --data-dir、手順 1 で確認したパスを入力します。たとえば本体が \\NAS\photo\mImageViewer\mimageviewer.exe、PC 内のパスが C:\Users\hanako\AppData\Local の場合は、次のように入力します：
   "\\NAS\photo\mImageViewer\mimageviewer.exe" --data-dir "C:\Users\hanako\AppData\Local\mimageviewer-data"
4. ショートカットに「mImageViewer ローカルデータ比較」など、区別できる名前を付けて完了します
5. 作ったショートカットから B を起動し、A と同じ画像フォルダを開きます

次の 3 点を A と B で比べます：

1. 起動にかかる時間
2. 同じ書庫を開いたときの速さ（B は 2 回目を使う）
3. 終了してもう一度起動する操作を 3 回繰り返したときの安定性

特に、A で「固まって強制終了もできない」状態になり、B では起きなくなるかどうかが重要です。 B で起きなくなるなら、以後も同じショートカットを使うことで、画像は NAS のままデータだけを PC 内に置けます。

表示処理の失敗や、実行中の問題を知らせるメッセージが出て終了する

メッセージにグラフィックスドライバーの更新案内がある場合は、ドライバーを最新版に更新してください。 更新しても直らない場合や、更新案内のないメッセージが出た場合は、表示された詳細と、問題が起きるまでの操作をお知らせください。

メッセージに別の描画方式で起動する案内がある場合は、その起動オプションを付けて試せます。 たとえば --gpu-backend vulkan は Vulkan、--gpu-backend dx12 は DirectX 12 を指定します。 起動用ショートカットの「プロパティ」を開き、「リンク先」の末尾に半角スペースと案内された引数を追記してください。 例: "C:\Program Files\mImageViewer\mimageviewer.exe" --gpu-backend vulkan。 タスクトレイの常駐も終了してから、そのショートカットで起動します。 元に戻すには追加した引数を削除します。詳しくは起動オプションをご覧ください。

自動選択では、起動時に DirectX 12 で GPU を使い始める処理が失敗した場合だけ、Vulkan を一度試します。 すべての表示エラーで切り替わるわけではありません。指定した方式が使えるかどうかは GPU とドライバーによります。 メッセージに出る GPU 名・描画方式・ドライバー・段階・GPU 診断・試した方式は、調査の手掛かりです。 エラー文だけで原因が確定するわけではありません。

アプリを開けない場合も、メッセージに表示されたフォルダーのログをエクスプローラーから取り出せます。 通常版の既定の場所は %APPDATA%\mimageviewer\logs、ポータブル版は展開先の data\logs です。 保存先を指定して起動している場合は、指定したフォルダー内の logs にあります。 mimageviewer.log と、同じ名前で始まる過去のログがあれば一緒に添えて、 GitHub の不具合報告へお送りください。

起動の経過を残す記録は別の場所にあります。通常版は %LOCALAPPDATA%\mimageviewer\startup-logs、 ポータブル版は展開先の data\logs\startup です。保存先を指定して起動している場合は、 指定したフォルダー内の logs\startup にあります。

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

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

文字化けする

日本語フォントが正しくインストールされているか確認してください。 Windows 11 では「游ゴシック」が標準搭載されています。フォントが破損・削除されている場合は再インストールしてください。

画像表示の問題

RAW ファイルが表示されない・現像されない

RAW の表示・現像は内蔵しているため、追加の拡張機能は不要です。カメラや圧縮方式によって現像できない場合があります。Nikon HE / HE* と JPEG XL 圧縮 DNG は現像に対応していません。使える埋め込みプレビューがある場合は、その画像を表示します。プレビューも使えない場合は表示できません。対応形式と制限を確認してください。

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

AVIF は追加インストール不要です。ファイルが破損していないか、別の AVIF 画像は表示できるかを確認してください。

HEIC / JPEG XL ファイルが表示されない

Windows の表示機能に対応するコーデックが必要です。Microsoft Store から対応するコーデックをインストールしてください。

1. Microsoft Store を開きます（スタートメニューから「Microsoft Store」を検索）
2. HEIF 画像表示オプション（HEIC / HEIF 用）、または JPEG XL 画像表示オプション（JPEG XL 用）を選びます
3. HEIC は、HEVC に対応していない PC では HEVC ビデオ拡張機能 も追加します。有料の場合があります
4. Microsoft Store の案内に従ってインストールします
5. mImageViewer でフォルダを再度開きます（再起動不要）

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

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

ZIP 内の画像も、撮影時の向き情報に従って表示されます。 以前に作成されたサムネイルだけ向きが古い場合は、設定 → サムネイルキャッシュ管理から 対象フォルダまたはすべてのサムネイルキャッシュを削除すると作り直されます。

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

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

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

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

動画再生の問題

内蔵プレイヤーで動画が再生できない

• グラフィックドライバーを最新バージョンに更新してください
• 動画は既定で GPU によるハードウェアデコードを使用します。お使いの GPU やドライバーが対応していない場合、再生できないことがあります。 設定 →「環境設定…」→ 動画再生 の「ハードウェアデコードを有効にする」をオフにすると CPU デコードに切り替わり、再生できる場合があります（切り替え後、次に開く動画から反映されます）
• 上記でも再生できない場合は、Shift+Enter で関連付けされた外部プレイヤーで開くこともできます

パフォーマンスの問題

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

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

メモリ使用量が多い

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

ファイル操作の問題

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

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

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

• PDF ファイルが破損している可能性があります。Adobe Acrobat Reader など他のアプリで開けるか確認してください
• 暗号化された PDF の場合、パスワード入力ダイアログが表示されます。正しいパスワードを入力してください
• 保存済みパスワードを全件リセットする場合は、mImageViewer を終了してから %APPDATA%\mimageviewer\pdf_passwords.json を削除します。ポータブル版は展開先の data\pdf_passwords.json が対象です

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

• パスワード付き ZIP には対応していません
• RAR / CBR の場合、パスワード入力ダイアログが表示されます。入力したパスワードは保存されず、変換後の ZIP キャッシュはパスワードなしで保存されます
• ZIP ファイルが破損している可能性があります。別の解凍ツールで確認してください
• 非常に古い形式（ZIP 1.0 以前）には対応していない場合があります

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

設定をリセットしたい

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

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

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

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

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

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

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

それでも解決しない場合

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

不具合を報告するとき

報告の前に既知の問題をご確認ください。すでに把握している 症状であれば、そちらに回避方法を記載しています。

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

1. 環境設定 →「開発者」を開きます。
2. 「ログを zip にする」ボタンを押します。「保存中…」の間も閲覧でき、環境設定を閉じても保存は続きます。「保存しました」が出たら、表示されたデスクトップの zip を使ってください。
3. その zip を不具合の内容と一緒に開発者へ送ってください。「証拠不完全」と出た場合も、残っているログは保存されています。保存完了を確認できなかった場合は、失敗と表示されます。

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