[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80012":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":22,"topics":24,"createdAt":10,"pushedAt":10,"updatedAt":28,"readmeContent":29,"aiSummary":30,"trendingCount":15,"starSnapshotCount":15,"syncStatus":31,"lastSyncTime":32,"discoverSource":33},80012,"RAIV","nalltama\u002FRAIV","nalltama","Realtime AI Image Viewer - AI upscaling image viewer for Windows","https:\u002F\u002Fnote.com\u002Fnalltama",null,"Python",84,6,69,0,1,5,13,4,2.54,"MIT License",false,"main",[25,26,27],"image-viewer","real-cugan","real-esrgan","2026-06-12 02:03:56","# Realtime AI Image Viewer (RAIV)\n\nRAIV は、Real-CUGAN \u002F Real-ESRGAN による画像の超解像・復元処理を自動で行いながら閲覧できる Windows 向け画像ビューアーです。画像を開くだけで処理済み画像を表示し、処理前後の比較、ページ送り、ズーム、パン、サムネイル移動などを行えます。高速なページ送りと先読みを重視しており、大量の画像を快適に閲覧することを目指しています。`RAIV` の開発は Codex を用いた完全AIコーディングで行われています。\n\nEnglish version is below the Japanese section.\n\n## 初回セットアップ\n\nPython をインストールしたあと、最初に次を実行してください。\n\n```powershell\ninstall_support.bat\n```\n\nこの bat は以下の Python パッケージを導入します。\n\n- `PySide6`: アプリ画面\n- `Pillow`: 高品質な表示サイズ変換\n- `opencv-python-headless`: Lanczos4 用の任意パッケージ\n- `py7zr`: 7z\u002FCB7 アーカイブ対応\n- `rarfile`: RAR\u002FCBR アーカイブ対応の補助\n\nRAR\u002FCBR は環境によって、別途 7-Zip、UnRAR、bsdtar のいずれかが必要です。\n\n## 起動\n\n通常は `run_raiv.pyw` を実行します。Python の関連付け環境によって `.pyw` のダブルクリック起動ができない場合は、`install_pyw_association.bat` を実行すると、現在のユーザーの `.pyw` 関連付けを `where pyw` で見つかる `pyw.exe` に設定できます。\n\nWindows のバージョンや既定アプリ設定によっては、バッチ実行後に `run_raiv.pyw` をダブルクリックした時、`アプリを選択して .pyw ファイルを開く` 画面が表示されることがあります。その場合は `pyw.exe` を選び、`常に使う` を押してください。以後は `run_raiv.pyw` をダブルクリックするだけで起動できます。\n\n関連付けを変更せずに起動したい場合は `run_raiv.bat`、または次のコマンドで起動できます。`run_raiv.vbs` は互換用に残しています。\n\n```powershell\npython .\\raiv.py\n```\n\nログは右ペインの全般タブにある `ログを表示` でオン\u002Fオフできます。\n\n## 画像を開く\n\n- 画像ファイル、フォルダ、ZIP\u002FCBZ、RAR\u002FCBR、7z\u002FCB7 をドラッグアンドドロップ\n- `O` キーで画像ファイルを選択\n- `F` キーでフォルダを選択\n\n画像ファイルを開いた場合は、まずその画像を表示し、同じフォルダ内の画像一覧はあとから取得します。\n\n## 画像処理エンジン\n\n右ペインのエンジン設定タブで、Real-CUGAN と Real-ESRGAN を切り替えられます。\n\nReal-CUGAN:\n\n```text\ntools\\realcugan-ncnn-vulkan\\realcugan-ncnn-vulkan.exe\n```\n\nReal-ESRGAN:\n\n```text\ntools\\realesrgan-ncnn-vulkan\\realesrgan-ncnn-vulkan.exe\n```\n\nReal-ESRGAN は x4 モデルのため、RAIV では Real-ESRGAN 選択中の倍率を 4 倍固定として扱います。倍率欄は無効化されますが、Real-CUGAN に戻した時の値は保持されます。\n\nReal-ESRGAN モデル:\n\n- `realesr-animevideov3`: アニメ\u002Fイラスト向けの軽量モデル\n- `realesrgan-x4plus`: 写真や一般画像向け\n- `realesrgan-x4plus-anime`: アニメ\u002Fイラスト向けの x4plus 系モデル\n\n## 主な設定\n\nエンジン設定:\n\n- 倍率、ノイズ、tile\n- エンジン先読み枚数\n- 指定縦解像度以上の画像を拡大処理しない設定\n- 拡大結果を倍率フォルダへ保存\n- 倍率フォルダがあれば表示に使う\n\n全般:\n\n- ビューアー先読み枚数\n- 背景色\n- 見開き表示による漫画の左右2枚表示\n- 横長画像を既に見開きのページとして扱う1枚表示\n- 比較モード、比較スライダー、境界線色、境界線太さ\n- 表示リセット、ページ送り間隔\n- 現在ページ位置の表示とスライダー移動\n- ページ位置スライダーとサムネイル列の左右入れ替え（右綴じ）\n- 画面下部サムネイルの表示と固定\u002F自動表示\n- 最後\u002F最初でページ送りした時のループ\n- ページ送り時にズーム、表示位置、回転\u002F反転状態を維持\n- マウス横スクロールのページ送り有効化と方向反転\n- 全画面時のマウスカーソル非表示\n- ログ表示\n- 内部プロファイリング表示\n\n画像調整:\n\n- GIMP `.cur` トーンカーブファイルを使った表示補正\n- モノクロ漫画を疑似4色刷り風に表示\n- トーンカーブを画面上で確認しながら調整し、`.cur` として保存\n\n`.cur` ファイルはアプリフォルダ内の `cur` フォルダから読み込みます。\n\nその他:\n\n- Language（日本語 \u002F English）\n- 拡大縮小時の高品質補完\n- 表示リサンプル方式: Lanczos3、Lanczos4、Bicubic、Area\n- アプリの二重起動禁止\n- 最後に開いていた画像を次回起動時に開く\n- フォルダごとに最後に開いていた画像を記録\n- 次回起動時の古い一時ファイル削除\n\nサムネイル列は下端に表示されます。固定表示では画像表示領域を少し使い、自動表示ではビューアー下端へマウスを近づけた時だけ重ねて表示します。サムネイルの大きさは列の高さ変更に合わせて自動調整されます。\n\nキーコンフィグ:\n\n- 各機能につき、キーボード1つ、マウスボタン1つを割り当て可能\n- 設定値をクリックしてからキーまたはマウスボタンを押すと割当を変更\n- `Ctrl`、`Shift`、`Alt` との組み合わせ指定に対応\n- 設定中に `Esc` を押すと未割当に戻る\n- `Space` の次ページ送り、`Backspace` の前ページ送りは固定\n\n拡大縮小時の高品質補完をオンにすると、原寸と異なる表示サイズの画像を高品質に作成して保持します。ズーム操作中は速度を優先し、操作が止まってから高品質表示へ切り替わります。オフにすると標準の高速表示になります。\n\n## 操作\n\nマウス:\n\n- ホイール: 前後ページ送り\n- 横スクロール: 設定で有効にした場合のみ前後ページ送り\n- `Ctrl` + ホイール: ズーム\n- `Ctrl` + 左ドラッグ上下: 上でズームイン、下でズームアウト\n- 左ドラッグ: パン\n- 比較モード中のドラッグ: 比較境界線の移動\n- 比較モード中の `Shift` + ドラッグ: 設定に応じてパン\u002F境界線移動を切り替え\n- ホイールクリック: ボーダーレス全画面の切り替え（キーコンフィグで変更可能）\n- 左ダブルクリック: 表示を中央へリセット（キーコンフィグで変更可能）\n- 右ダブルクリック: 等倍表示（キーコンフィグで変更可能）\n- 戻る\u002F進むボタン: フォルダ内の先頭\u002F末尾へ移動（キーコンフィグで変更可能）\n\nキーボード:\n\n- `O`: 画像を開く（キーコンフィグで変更可能）\n- `F`: フォルダを開く（キーコンフィグで変更可能）\n- 上カーソル: 親フォルダへ移動（キーコンフィグで変更可能）\n- 下カーソル: 次フォルダへ移動（キーコンフィグで変更可能）\n- `Ctrl` + 下カーソル: 子フォルダへ移動（キーコンフィグで変更可能）\n- 左カーソル: 次ページへ移動（キーコンフィグで変更可能）\n- 右カーソル: 前ページへ移動（キーコンフィグで変更可能）\n- `F3`: サムネイル列の固定\u002F自動表示を切り替え（キーコンフィグで変更可能）\n- `F4`: 右ペインの固定\u002F自動表示を切り替え（キーコンフィグで変更可能）\n- `W`: 見開き表示を切り替え（キーコンフィグで変更可能）\n- `Q`: 見開き表示中に1ページ送り（キーコンフィグで変更可能）\n- `E`: 見開き表示中に1ページ戻し（キーコンフィグで変更可能）\n- `T`: トーンカーブ補正を切り替え（キーコンフィグで変更可能）\n- `R`: 画像を右回転（キーコンフィグで変更可能）\n- `L`: 画像を左回転（キーコンフィグで変更可能）\n- `H`: 画像を左右反転（キーコンフィグで変更可能）\n- `V`: 画像を上下反転（キーコンフィグで変更可能）\n- `Space`: 次ページへ移動\n- `Backspace`: 前ページへ移動\n\nフォルダ移動では、RAIVが作成した倍率フォルダは移動先候補から除外されます。\n\n## 保存フォルダ\n\n拡大結果の保存を有効にすると、元画像と同じフォルダ配下にエンジン\u002F倍率に応じたサブフォルダを作成します。\n\n例:\n\n- `realcugan_x2`\n- `realesrgan_realesrgan-x4plus_x4`\n\nアーカイブ表示中は保存先フォルダがないため、倍率フォルダ保存と倍率フォルダ読み込みは無効になります。\n\n## 設定と一時ファイル\n\n設定はアプリと同じフォルダの `setting.json` に保存されます。設定ファイルがない場合は初期設定で起動します。フォルダごとの最後に開いていた画像の履歴は、設定ファイルが大きくなりすぎないよう `folder_history.json` に分けて保存されます。保存件数はその他タブで変更でき、`0` にすると無制限です。\n\n一時ファイルは OS の一時フォルダに RAIV 用の接頭辞付きで作成され、通常終了時に削除されます。クラッシュなどで残った場合に備えて、その他タブから次回起動時の古い一時ファイル削除を予約できます。\n\n## アーカイブ対応\n\nZIP\u002FCBZ は標準ライブラリで展開します。7z\u002FCB7 は `py7zr` または外部 7-Zip を使います。RAR\u002FCBR は `rarfile`、または外部の 7z\u002F7za\u002F7zr、UnRAR、bsdtar を使います。\n\n## ライセンスと同梱物\n\nRAIV 本体は MIT License です。詳細は `LICENSE` を参照してください。\n\n同梱している外部ツール:\n\n- Real-CUGAN ncnn Vulkan: MIT License  \n  付属ファイル: `tools\\realcugan-ncnn-vulkan\\LICENSE`, `tools\\realcugan-ncnn-vulkan\\README.md`\n- Real-ESRGAN ncnn Vulkan \u002F Real-ESRGAN: BSD 3-Clause License  \n  付属ファイル: `tools\\realesrgan-ncnn-vulkan\\LICENSE`, `tools\\realesrgan-ncnn-vulkan\\README_windows.md`\n\n配布時は `tools` 配下の exe、DLL、モデル、README、LICENSE を欠落させないようにしてください。\n\n---\n\n# Realtime AI Image Viewer (RAIV)\n\nRAIV is a Windows image viewer that automatically displays images processed with Real-CUGAN or Real-ESRGAN super-resolution\u002Frestoration. Open an image and RAIV can show the processed result, compare before\u002Fafter images, browse pages, zoom, pan, and navigate with thumbnails. RAIV focuses on fast page navigation and prefetching so large image folders can be browsed comfortably. Development of `RAIV` is done through fully AI-assisted coding with Codex.\n\n## First Setup\n\nAfter installing Python, run:\n\n```powershell\ninstall_support.bat\n```\n\nThis batch file installs the following Python packages:\n\n- `PySide6`: application UI\n- `Pillow`: high-quality display resizing\n- `opencv-python-headless`: optional package for Lanczos4\n- `py7zr`: 7z\u002FCB7 archive support\n- `rarfile`: helper package for RAR\u002FCBR archive support\n\nDepending on your environment, RAR\u002FCBR support may also require 7-Zip, UnRAR, or bsdtar.\n\n## Launch\n\nUsually, run `run_raiv.pyw`. If double-clicking `.pyw` files does not work because of Python file association settings, run `install_pyw_association.bat` to associate `.pyw` with the `pyw.exe` found by `where pyw` for the current Windows user.\n\nDepending on your Windows version and default app settings, double-clicking `run_raiv.pyw` after running the batch file may still show an `Open .pyw file with` app selection dialog. In that case, choose `pyw.exe` and click `Always`. After that, `run_raiv.pyw` should launch by double-clicking.\n\nIf you do not want to change file associations, run `run_raiv.bat`, or launch it manually. `run_raiv.vbs` is kept only for compatibility.\n\n```powershell\npython .\\raiv.py\n```\n\nLogs can be shown or hidden from `Show log` in the General tab.\n\n## Opening Images\n\n- Drag and drop an image file, folder, ZIP\u002FCBZ, RAR\u002FCBR, or 7z\u002FCB7 archive\n- Press `O` to select an image file\n- Press `F` to select a folder\n\nWhen an image file is opened, RAIV displays it first and then collects the rest of the images in the same folder.\n\n## Processing Engines\n\nUse the Engine Settings tab in the right panel to switch between Real-CUGAN and Real-ESRGAN.\n\nReal-CUGAN:\n\n```text\ntools\\realcugan-ncnn-vulkan\\realcugan-ncnn-vulkan.exe\n```\n\nReal-ESRGAN:\n\n```text\ntools\\realesrgan-ncnn-vulkan\\realesrgan-ncnn-vulkan.exe\n```\n\nReal-ESRGAN uses x4 models, so RAIV treats the scale as fixed to 4x while Real-ESRGAN is selected. The scale field is disabled in that mode, but the Real-CUGAN scale value is preserved.\n\nReal-ESRGAN models:\n\n- `realesr-animevideov3`: lightweight model for anime\u002Fillustration images\n- `realesrgan-x4plus`: model for photos and general images\n- `realesrgan-x4plus-anime`: x4plus-style model for anime\u002Fillustration images\n\n## Main Settings\n\nEngine settings:\n\n- Scale, denoise, tile\n- Engine prefetch count\n- Skip processing for images above a specified vertical resolution\n- Save processed images to a scale folder\n- Use an existing scale folder as display cache\n\nGeneral:\n\n- Viewer prefetch count\n- Background color\n- Spread view for manga pages\n- Show landscape images as a single page when they are already spread pages\n- Compare mode, compare slider, divider color, divider width\n- Reset view, page navigation interval\n- Current page slider and page count\n- Reverse page slider direction and thumbnail strip direction for right-to-left reading\n- Bottom thumbnail strip with pinned\u002Fauto display modes\n- Wrap around at first\u002Flast page\n- Preserve zoom, pan, rotation, and flip state during page navigation\n- Horizontal mouse wheel page navigation and direction reverse\n- Hide mouse cursor in fullscreen\n- Log display\n- Internal profiling display\n\nImage Adjustment:\n\n- Display adjustment using GIMP `.cur` tone curve files\n- Pseudo four-color printing style for monochrome manga\n- Edit tone curves while viewing the graph and save them as `.cur`\n\n`.cur` files are loaded from the `cur` folder inside the application folder.\n\nOther:\n\n- Language (Japanese \u002F English)\n- High-quality scaling for zoomed\u002Fresized display\n- Display resampling method: Lanczos3, Lanczos4, Bicubic, Area\n- Prevent multiple app instances\n- Open the last viewed image on startup\n- Remember the last viewed image for each folder\n- Cleanup old temporary files on next startup\n\nThe thumbnail strip appears at the bottom. In pinned mode it uses part of the image area; in auto mode it overlays the viewer only when the mouse approaches the bottom edge. Thumbnail size is adjusted automatically from the strip height.\n\nKey configuration:\n\n- One keyboard binding and one mouse binding can be assigned to each action\n- Click a binding value, then press a key or mouse button to change it\n- `Ctrl`, `Shift`, and `Alt` modifiers are supported\n- Press `Esc` while assigning to clear a binding\n- `Space` for next page and `Backspace` for previous page are fixed\n\nWhen high-quality scaling is enabled, RAIV creates and keeps high-quality display-size images. During zoom interaction it prioritizes speed, then switches to high-quality rendering after the operation stops. When disabled, RAIV uses the standard fast display path.\n\n## Controls\n\nMouse:\n\n- Wheel: previous\u002Fnext page\n- Horizontal wheel: previous\u002Fnext page only when enabled\n- `Ctrl` + wheel: zoom\n- `Ctrl` + left-drag up\u002Fdown: zoom in\u002Fout\n- Left-drag: pan\n- Drag in compare mode: move compare divider\n- `Shift` + drag in compare mode: switch pan\u002Fdivider behavior depending on the setting\n- Middle click: toggle borderless fullscreen, configurable\n- Left double click: reset view to center, configurable\n- Right double click: actual-size view, configurable\n- Back\u002FForward mouse buttons: jump to first\u002Flast image in the folder, configurable\n\nKeyboard:\n\n- `O`: open image, configurable\n- `F`: open folder, configurable\n- Up arrow: move to parent folder, configurable\n- Down arrow: move to next folder, configurable\n- `Ctrl` + Down arrow: move to child folder, configurable\n- Left arrow: next page, configurable\n- Right arrow: previous page, configurable\n- `F3`: toggle thumbnail strip pinned\u002Fauto mode, configurable\n- `F4`: toggle right panel pinned\u002Fauto mode, configurable\n- `W`: toggle spread view, configurable\n- `Q`: shift one page forward in spread view, configurable\n- `E`: shift one page backward in spread view, configurable\n- `T`: toggle tone curve adjustment, configurable\n- `R`: rotate image right, configurable\n- `L`: rotate image left, configurable\n- `H`: flip image horizontally, configurable\n- `V`: flip image vertically, configurable\n- `Space`: next page\n- `Backspace`: previous page\n\nFolder navigation ignores scale folders created by RAIV.\n\n## Save Folders\n\nWhen saving processed results is enabled, RAIV creates an engine\u002Fscale-specific subfolder next to the original image.\n\nExamples:\n\n- `realcugan_x2`\n- `realesrgan_realesrgan-x4plus_x4`\n\nWhile viewing archives, scale-folder saving and scale-folder cache loading are disabled because there is no normal output folder.\n\n## Settings and Temporary Files\n\nSettings are saved as `setting.json` in the application folder. If the file does not exist, RAIV starts with default settings. Per-folder last-viewed image history is saved separately as `folder_history.json` so the main settings file does not grow too large. The maximum number of history entries can be changed in the Other tab; set it to `0` for unlimited history.\n\nTemporary files are created under the OS temporary folder with RAIV-specific prefixes and are removed on normal exit. If files remain after a crash, you can reserve cleanup of old temporary files from the Other tab for the next startup.\n\n## Archive Support\n\nZIP\u002FCBZ is handled by the Python standard library. 7z\u002FCB7 uses `py7zr` or external 7-Zip. RAR\u002FCBR uses `rarfile`, or external 7z\u002F7za\u002F7zr, UnRAR, or bsdtar.\n\n## License and Bundled Components\n\nRAIV itself is released under the MIT License. See `LICENSE` for details.\n\nBundled external tools:\n\n- Real-CUGAN ncnn Vulkan: MIT License  \n  Included files: `tools\\realcugan-ncnn-vulkan\\LICENSE`, `tools\\realcugan-ncnn-vulkan\\README.md`\n- Real-ESRGAN ncnn Vulkan \u002F Real-ESRGAN: BSD 3-Clause License  \n  Included files: `tools\\realesrgan-ncnn-vulkan\\LICENSE`, `tools\\realesrgan-ncnn-vulkan\\README_windows.md`\n\nWhen redistributing RAIV, keep the exe, DLL, model, README, and LICENSE files under `tools` intact.\n\n\n\n\n","RAIV 是一款面向 Windows 的实时 AI 图像查看器，它能够自动使用 Real-CUGAN 和 Real-ESRGAN 技术对图像进行超分辨率和恢复处理。其核心功能包括实时处理、前后对比显示、流畅的页面翻阅以及多种格式支持（如 ZIP、RAR、7z 等）。技术上，RAIV 采用了 Python 编程语言，并利用了 PySide6 构建用户界面，Pillow 和 OpenCV 保证了高质量的图像处理能力。特别适合需要在浏览大量图片时保持高效且希望获得最佳视觉体验的场景，例如漫画阅读、照片整理或艺术作品展示等。",2,"2026-06-11 03:58:53","CREATED_QUERY"]