OmniRaw Documentation

OmniRaw 將相同照片的 RAW、JPG 與輸出檔整理成群組，協助你安全又快速地整理拍攝檔案。OmniRaw groups the RAW, JPG, and exports of the same shot, so you can organize a shoot quickly and safely.

快速開始Quick start

在 Browse 開啟拍攝資料夾。OmniRaw 會遞迴掃描並將關聯檔案分組。Open a shoot folder in Browse. OmniRaw scans it recursively and groups related files.
按 Enter 或點選照片進入 Cull 全螢幕選片。Press Enter or open a photo to enter the full-screen Cull view.
標記要處理的檔案，按 Enter 進入 Review。Mark files to handle, then press Enter for Review.
逐檔確認後送出；檔案只會移至系統回收桶。Confirm each file and commit. Files only move to the operating system’s recycle bin or Trash.

選片快捷鍵Culling shortcuts

← / →	上一張／下一張Previous / next photo
Delete X	標記整個群組（再按取消）Mark the whole group (press again to unmark)
J / R	只標記 JPG／只標記 RAWMark JPGs only / RAW only
Space	只切換目前檔案的標記Toggle only the current file
P ↑ / ↓	在同組檔案間切換Cycle files in the current group
F5	重新掃描目前資料夾Refresh the current folder

配對規則Pairing rules

預設下，只有同一資料夾、同一 basename（不分大小寫）的檔案會被視為同一組。By default, only files in the same folder with the same basename (case-insensitive) are one group.

IMG_0001.CR3
IMG_0001.JPG
IMG_0001_edit.jpg
IMG_0001-1.jpg

匯出檔可用 RAW basename 加上非英數分隔符與後綴加入群組；最長的 RAW basename 優先。因此 IMG_00010.jpg 不會誤配至 IMG_0001.CR3。An export can join a RAW basename with a non-alphanumeric separator and suffix; the longest RAW basename wins. So IMG_00010.jpg does not incorrectly pair with IMG_0001.CR3.

孤兒清理Orphan cleanup

Orphan Cleanup 會列出 RAW-only 與 JPG-only 檔案，供你批次檢查和清理。RAW 沒有 JPG 時，可以將它的內嵌預覽匯出為同檔名 JPG；既有檔不會被覆寫。Orphan Cleanup lists RAW-only and JPG-only files for batch review. For a RAW without a JPG, export its embedded preview as a sibling JPG; existing files are never overwritten.

設定Settings

RAW / non-RAW extensions — 調整要辨識的副檔名。adjust the extensions OmniRaw recognizes.
Delete key mode — 設定 Delete 預設標記整組、只 JPG 或只 RAW。choose whether Delete marks a group, JPGs only, or RAW only.
Auto-group exported files — 控制匯出檔的 prefix 配對。control prefix matching for exported variants.
Sibling-folder pairing — 可選擇配對指定的同層 RAW／JPEG 資料夾；預設關閉。optionally pair configured sibling RAW/JPEG folders; off by default.

平台與安全Platform & safety

OmniRaw 支援 Windows 與 macOS。所有刪除一律移至 Windows Recycle Bin 或 macOS Trash，沒有永久刪除功能。應用程式也保留追加式 JSONL 操作紀錄與目前的清理 manifest，方便追溯。OmniRaw supports Windows and macOS. All deletions move to Windows Recycle Bin or macOS Trash; there is no permanent-delete feature. An append-only JSONL log and current cleanup manifest provide an audit trail.