トラブルシューティング
よくある問題と解決方法をまとめています。
起動・表示の問題
起動しない / すぐに終了する
以下の点を確認してください:
- 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 が二重起動を防ぐ仕組みは 1 台の PC の中でしか働かないため、別の PC から開かれても検出できません。
複数の端末から同じ画像を見たいためにネットワーク上へ置いている場合は、 リモート閲覧のほうが向いています。画像のある PC で mImageViewer を動かし、ほかの PC やスマートフォンのブラウザから開く方法です。 データを共有しないので、上の問題は起きません。ただしブラウザから使えるのは 閲覧を中心とした機能に限られ、接続には Tailscale の設定が必要です。
本体をネットワーク上に置いたままにしたい場合は、mImageViewer が使うデータだけを PC 内へ移せます。この場合、データはその PC ごとに別々になります。 設定や既読の状態は PC 間で共有されませんが、複数の PC から使うなら、これが安全な唯一の方法です。
mimageviewer.exe などは、終了した後も Windows 側で
開いたままになることがあり、新しい版で上書きしようとするとアクセス拒否になります。
その場合は 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 ごとに別々になります。
また、遅さの原因が画像の読み込み自体にあることもあります。 どちらが効いているかは、次の方法で切り分けられます。
| 比較 | 本体 | mImageViewer が使うデータ | 画像 |
|---|---|---|---|
| A(現在の使い方) | NAS | NAS | NAS |
| B(比較用) | NAS | PC 内 | NAS |
B では画像を NAS に置いたまま、mImageViewer が使うデータだけを PC 内へ変えます。
B のショートカットを作る
- Windows+R を押し、
%LOCALAPPDATA%と入力して Enter を押します。開いたフォルダのパスを確認します - デスクトップを右クリックし、新規作成 → ショートカットを選びます
- 「項目の場所」に、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" - ショートカットに「mImageViewer ローカルデータ比較」など、区別できる名前を付けて完了します
- 作ったショートカットから B を起動し、A と同じ画像フォルダを開きます
次の 3 点を A と B で比べます:
- 起動にかかる時間
- 同じ書庫を開いたときの速さ(B は 2 回目を使う)
- 終了してもう一度起動する操作を 3 回繰り返したときの安定性
| 結果 | 意味 |
|---|---|
| B が明らかに速い、または固まらなくなる | mImageViewer が使うデータの保存先が原因です。データを PC 内に置けば解決できます |
| B も同じ | 画像の読み込み自体が重くなっています。ネットワーク接続や NAS 側を確認してください |
| 起動だけ速くなる | データの保存先と画像の読み込みの両方が影響しています |
特に、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)が使えなくなっていました。 記録だけでは、終了の原因は断定できません。
日時はこの PC のローカル日時と時差で表示します。たとえば
2026-10-30 19:23:45 (UTC+09:00) は、日本標準時なら午後7時23分45秒の記録です。
コピーする文にも同じ日時と時差が入ります。日時を変換できない場合は「時刻不明」と表示します。
AI 処理や結果の表示準備などの活動中は、約1秒を目標に状況を記録します。表示ページ、AI のモデル・処理段階、 画像やタイルの寸法、待ち件数、CPU のメモリ使用量、描画用 GPU のメモリ使用量と予算など、決められた項目だけを保存します。 活動が終わると最後の状態を記録し、定期記録を止めます。記録のために閲覧や AI 処理の完了を待たせることはありません。
各項目には採取時刻があります。処理や保存が遅れたり、状態が更新されなかったりすると、記録は古くなります。 約1秒前の状態を保証するものではなく、終了時刻の観測がない場合は「終了との間隔不明」と表示します。 取得できなかった項目は不明とし、以前の成功値を現在の値として補いません。
保存できた場合は、終了前に観測したエラーの分類や例外の番号、描画用 GPU を使えなくなった記録も表示します。 エラーの原文やファイルの場所は、この案内やコピーする文に含めません。従来の詳細なエラーログには元の本文が残ります。 処理が続いたエラーも記録されるため、観測だけで終了原因は確定できません。 エラーの観測時刻がある場合の時間差は、その観測との間隔であり、終了までの時間ではありません。
GPU の数値は照合できた描画用 GPU の値で、AI が使う GPU との一致は未確認です。 メモリを共有する種類の GPU でも採取対象ですが、その種類を判定できない場合は不明になります。 使用量と予算の比較だけでは終了原因を確定できず、予算内でも処理の失敗は起こり得ます。 この案内は原因の参考資料であり、自動回復や再試行を行う機能ではありません。既存の詳細ログは別に残ります。
閲覧中に「AI処理に失敗」と表示される
表示中のページの AI 処理が失敗したときに通知します。通知にポインターを重ねると、 エラーの分類・観測したローカル日時・取得できたエラー番号・ページ番号などの報告用の文を確認できます。 通知が表示されている間にクリックすると、同じ本文をコピーします。自動送信は行いません。
報告用の文の例です。画面番号・更新番号・処理番号は、記録を照合するための番号です。 エラー番号を取得できなかった場合は「不明」と表示します。そのままコピーして報告できます。
AI処理に失敗しました(推論エラー)。 観測時刻: 2026-10-30 19:23:45 (UTC+09:00) エラー番号: 6 画面番号 3 / 更新番号 17 / 処理番号 655 ページ 12/40 / 入力画像の寸法 2400x3600 この記録は処理の失敗です。異常終了やGPUの喪失を示すものではありません。 エラーの原文は既存の詳細ログに残ります。
通知は通常の通知時間設定に従って消え、同じ処理要求の失敗を繰り返し通知しません。 先読みや取消済みの古い処理の失敗を、現在ページの失敗として通知することはありません。 本文にはファイル名・パス・検索語・エラーの原文を含めず、従来の詳細なエラーログには元本文が残ります。 この通知だけでメモリ不足や GPU の故障、異常終了の原因は判断できません。AI の設定変更や自動再試行も行いません。
画面が真っ黒 / 何も表示されない
- GPU ドライバーを最新バージョンに更新してください
- ウィンドウを移動したり、最小化して元に戻したりすると改善する場合があります
- 他のアプリを同時にたくさん起動している場合は、GPU メモリ不足の可能性があります
文字化けする
日本語フォントが正しくインストールされているか確認してください。 Windows 11 では「游ゴシック」が標準搭載されています。フォントが破損・削除されている場合は再インストールしてください。
画像表示の問題
RAW ファイルが表示されない・現像されない
RAW の表示・現像は内蔵しているため、追加の拡張機能は不要です。カメラや圧縮方式によって現像できない場合があります。Nikon HE / HE* と JPEG XL 圧縮 DNG は現像に対応していません。使える埋め込みプレビューがある場合は、その画像を表示します。プレビューも使えない場合は表示できません。対応形式と制限を確認してください。
AVIF ファイルが表示されない
AVIF は追加インストール不要です。ファイルが破損していないか、別の AVIF 画像は表示できるかを確認してください。
HEIC / JPEG XL ファイルが表示されない
Windows の表示機能に対応するコーデックが必要です。Microsoft Store から対応するコーデックをインストールしてください。
- Microsoft Store を開きます(スタートメニューから「Microsoft Store」を検索)
- HEIF 画像表示オプション(HEIC / HEIF 用)、または JPEG XL 画像表示オプション(JPEG XL 用)を選びます
- HEIC は、HEVC に対応していない PC では HEVC ビデオ拡張機能 も追加します。有料の場合があります
- Microsoft Store の案内に従ってインストールします
- mImageViewer でフォルダを再度開きます(再起動不要)
画像が回転して表示される
スマートフォンで縦向きに撮影した JPEG は EXIF に向き情報が含まれています。 また、mImageViewer で非破壊回転を適用した画像は回転情報データベースに保存されます。 意図しない回転がある場合は、設定メニュー →「回転情報をリセット…」で すべての回転情報をクリアできます。
ZIP 内の画像も、撮影時の向き情報に従って表示されます。 以前に作成されたサムネイルだけ向きが古い場合は、設定 → サムネイルキャッシュ管理から 対象フォルダまたはすべてのサムネイルキャッシュを削除すると作り直されます。
GIF アニメーションが再生されない
- グリッド表示ではアニメーションは再生されません。ダブルクリックでフルスクリーン表示に切り替えてください
AI 生成メタデータが表示されない
- 対応形式は PNG のテキストチャンクと JPEG の EXIF UserComment です
- 一部の AI ツールは独自形式でメタデータを埋め込むため、表示できない場合があります
- メタデータが含まれているか確認するには、ファイルのプロパティ → 詳細 タブを参照してください
3D 写真の問題
3D 写真が始まらない
メインウィンドウまたはフルスクリーンで静止画を 1 ページ表示し、D または上部の 3D を押してください。 初回は追加モデルの取得が必要です。取得完了後は、もう一度同じ操作で始めます。 別ウィンドウ・動画・アニメーション画像・2 ページの見開き・連結読み・編集中などは対象外です。 使える場面・使えない場面と、画面に表示される理由を確認してください。
奥行きの計算に時間がかかる
初回はモデルの準備があり、GPU を使う場合でも数秒以上かかることがあります。内蔵 GPU や CPU での計算では、さらに待つ場合があります。 「モデルを準備中」「奥行きを計算中」の間は通常の画像を表示します。D で 3D 写真を取り消せます。 処理時間は PC によって異なります。
動画再生の問題
内蔵プレイヤーで動画が再生できない
- グラフィックドライバーを最新バージョンに更新してください
- 動画は既定で 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)が一覧表示され、選んだ世代に巻き戻せます
- 同じダイアログの下部にある 「設定を完全リセット…」 ボタンで、設定を初期状態に戻せます
- どちらの操作も実行前の状態は別名で自動バックアップされるため、間違った場合でも手動で復元できます
アプリが起動しないなど上記のダイアログが使えない場合は、以下のファイル・フォルダを手動で削除してリセットします:
| 対象 | パス |
|---|---|
| 設定ファイル一式 | %APPDATA%\mimageviewer\ フォルダ内で settings.db で始まるすべてのファイル |
| 回転情報 DB | %APPDATA%\mimageviewer\rotation.db |
| サムネイルキャッシュ | %APPDATA%\mimageviewer\cache\ |
| すべての設定 | %APPDATA%\mimageviewer\ フォルダ全体 |
rotation.db を削除すると、mImageViewer で設定したすべての回転情報が失われます。
元のファイル自体は変更されていないため、ファイルへの影響はありません。
NVIDIA GeForce オーバーレイが表示される
mImageViewer は GPU(DirectX 12 / Vulkan)を利用して描画を行います。 NVIDIA GeForce Experience または NVIDIA App がインストールされている環境では、 フルスクリーン表示時にゲームオーバーレイが表示されることがあります。
これは NVIDIA がグラフィックス API を使用するアプリケーションをゲームとして検出するためで、 mImageViewer 側で回避することはできません。以下の手順でオーバーレイを無効化してください:
- NVIDIA App の場合:設定 → 全般 →「ゲーム内オーバーレイ」をオフ
- GeForce Experience の場合:設定 → 全般 →「ゲーム内のオーバーレイ」をオフ
それでも解決しない場合
上記の方法で解決しない場合は、設定のリセットをお試しください。 それでも改善しない場合は、開発者までお問い合わせください。
不具合を報告するとき
報告の前に既知の問題をご確認ください。すでに把握している 症状であれば、そちらに回避方法を記載しています。
「動画が再生できない」「特定の操作でおかしくなる」といった不具合を報告するときは、 動作ログを添えていただけると原因の特定が早くなります。
- 環境設定 →「開発者」を開きます。
- 「ログを zip にする」ボタンを押します。「保存中…」の間も閲覧でき、環境設定を閉じても保存は続きます。「保存しました」が出たら、表示されたデスクトップの zip を使ってください。
- その zip を不具合の内容と一緒に開発者へ送ってください。「証拠不完全」と出た場合も、残っているログは保存されています。保存完了を確認できなかった場合は、失敗と表示されます。
動作ログとエラーログは常に記録されているため、不具合が起きた直後にこの操作をすれば その記録がそのまま zip に含まれます。「動作が重い・カクつく」系の不具合では、先に同じ 「開発者」画面で「性能ログを記録する」を ON にしてアプリを再起動し、 症状を再現してから zip を作成してください。