CalibRaw README

项目的 README,来自 github.com/Duecki1/CalibRaw。合并为一个 markdown 文件:README.md。

CalibRaw

A free, open-source RAW photo editor for Linux, Android, Windows and macOS, with a complete photo-development workflow and AI tools that run locally.

Latest release License: GPL-3.0-or-later Language: Rust Graphics: wgpu Platform

Download • Why CalibRaw • Features • FAQ • Supported Formats • Building

Website • Discord • Instagram

CalibRaw desktop editor with light and color controls
Library
Desktop library with folders, photo thumbnails and ratings
AI Masks
Animated demo of AI subject masking and separate subject and background adjustments
Effects
Animated demo of fog amount, density and scene depth controls
Android
Android library, color controls and AI subject mask

Edit RAW files with sliders, curves, color grading and masks. AI tools can select a subject or the sky, remove objects and denoise high-ISO photos. Everything runs on your device, without an account or subscription.


Download

Platform Get it
Linux (x86_64 / ARM64) Flathub, or .AppImage or .deb (Debian 13+, Ubuntu 24.04+) from the latest release
Android (ARM64) Google Play, F-Droid, or .apk from the latest release
Windows (x86_64 / ARM64) Installer or portable .zip from the latest release
macOS (Apple Silicon / Intel) .zip from the latest release

AI models are downloaded once, on first use and only after you agree; they are verified by SHA-256 and then run offline.

Graphics requirements

CalibRaw processes photos on the GPU through Vulkan, Direct3D 12 or Metal. OpenGL is not supported: a GPU whose only driver is OpenGL cannot be used, and CalibRaw shows an "Unsupported graphics driver" notice instead of the editor.

Platform Needs
Linux A Vulkan driver. GPUs without one (for example Intel Haswell, whose Mesa Vulkan driver hasvk is not conformant and hidden) can run on the CPU with Mesa's software driver lavapipe (mesa-vulkan-drivers or vulkan-swrast), which is slow.
Android A Vulkan-capable GPU and driver.
Windows Direct3D 12 or Vulkan. Without either, Windows' software renderer (WARP) is used.
macOS Metal.

Where more than one graphics API works, such as Direct3D 12 and Vulkan on Windows, Settings > Interface > Graphics backend chooses one; it applies from the next start. WGPU_BACKEND (for example vulkan) limits which APIs CalibRaw may use and takes precedence.


Why CalibRaw


Key Features


Tooling & Workflow

Color & Tone

Demosaicing & Corrections

Masking & AI

Creative Effects

Apply effects to the whole photo or stack them on a local mask. The Effects card adds Glow, Halation, Grain and Vignette in one click; every effect is in the Add menu. Each card keeps its main controls visible, with optional details collapsed. Hide a card to compare, reset its settings, or remove it independently. While their card is open, Relight, Light Rays, Radial Blur, Tilt-Shift and Vignette also show controls on the photo: drag a light or center into place, and rotate or widen the Tilt-Shift focus band directly.


FAQ

How is CalibRaw different from darktable or RapidRAW? All three are free. darktable offers detailed module-level control and a mature color pipeline. RapidRAW's editing workflow inspired CalibRaw. CalibRaw uses a native interface and GPU processing, with the same engine on desktop and Android. It includes offline AI, creative effects such as depth-aware fog and light rays, and Edit Replay videos.

Does any of my data leave my device? No. Editing, AI masks, AI Remove and AI Denoise all run locally. CalibRaw only goes online to download AI models or the ONNX Runtime, and only after you agree.

Where does CalibRaw get the DCP profiles? On start, CalibRaw tries to automatically detect DCP files on your machine (windows, macOS only).

Which cameras and files are supported? Anything LibRaw or Rawler supports, as well as JPEG, PNG, HEIC and TIFF; see Supported Formats.


Supported Formats

RAW

CalibRaw uses LibRaw (master at a9a14b1) for broad camera compatibility, paired with Rawler (0.8.0) for DNG and JPEG-XL DNG streams. When LibRaw cannot open a camera RAW (for example a camera newer than its colour tables), CalibRaw retries it with Rawler. Together, they support RAW files from a wide range of camera models; check their maintained lists for specific compatibility.

Supported cameras: LibRaw and Rawler (maintained by the dnglab project). Supported file extensions:

.3fr   .ari   .arw   .bay   .bmq   .cap   .cine  .cr2   .cr3   .crw
.cs1   .dc2   .dcr   .dcs   .dng   .drf   .eip   .erf   .fff   .gpr
.iiq   .k25   .kc2   .kdc   .mdc   .mef   .mos   .mrw   .nef   .nefx
.nrw   .obm   .orf   .pef   .ptx   .pxn   .qtk   .raf   .raw   .rdc
.rw2   .rwl   .rwz   .sr2   .srf   .srw   .sti

Rendered images

JPEG, PNG, HEIC/HEIF and rendered TIFF files are edited with the same tools. They open looking exactly as captured, with embedded ICC profiles, Display P3, HLG/PQ HDR HEIF and EXIF orientation honored:

.jpg   .jpeg  .jpe   .png   .heic  .heif  .hif   .tif   .tiff

When a camera saves RAW+JPEG (or RAW+HEIC), the Library shows each pair once, as the RAW. Turn this off under Sort & filter → RAW + JPEG.


Architecture

CalibRaw is structured as a modular Rust workspace:

CalibRaw/
├── crates/
│   ├── calibraw-core/  # Color transforms, decoders (LibRaw/Rawler), metadata, sidecars
│   ├── calibraw-gpu/   # wgpu pipelines, WGSL compute shaders, tiled renderer
│   ├── calibraw-ai/    # ONNX Runtime models (BiRefNet, SAM 2.1, LaMa, RawNIND)
│   ├── calibraw-ui/    # egui/eframe interface for desktop and touch
│   ├── calibraw-cli/   # Headless batch export CLI tool
│   └── calibraw-ffi/   # Android JNI and NativeActivity bridge
└── android/            # Android Gradle packaging

The reusable UI design library, Moduwu Design, is fetched automatically by Cargo from a pinned GitHub commit. See Development for design-library development.

Headless CLI Export

Batch rendering can be run directly from the terminal:

calibraw-develop-export --input photo.ARW --output photo.jxl

Building from Source

Prerequisites

Desktop (Linux / Windows / macOS)

Cargo automatically downloads Moduwu Design from GitHub; no separate checkout is required.

git clone https://github.com/Duecki1/CalibRaw.git
cd CalibRaw
cargo run -p calibraw-ui --bin calibraw --release

For Linux sandbox builds, see the local Flatpak workflow for setup, debugging, installation, validation, and unpublished release staging.

Android (APK)

rustup target add aarch64-linux-android
cargo install cargo-ndk --version 4.1.2 --locked
./gradlew assembleDebug

Acknowledgments

CalibRaw's shaders and tools draw on work from these projects:

See Third-Party Notices for complete licensing, attributions, and model sources.


License

CalibRaw is free software licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later).

CalibRaw (Duecki1/CalibRaw)

正在搜索数据库…

这是什么?一款免费开源的 RAW 照片编辑器,支持 Linux、Android、Windows 和 macOS,提供滑块、曲线、调色、蒙版,以及可在设备本地运行的 AI 工具。
这是桌面应用、代码库还是别的东西?它是独立的编辑器应用,不是代码库。它使用 Rust 和 wgpu 构建,界面基于 egui,Android 版本与桌面版使用同一套引擎。
我该怎么运行它?从最新版本下载:Linux 上可选 Flathub 或 AppImage/.deb,Android 上可选 F-Droid 或 .apk,Windows 上可选安装程序或便携版 .zip,macOS 上为 .zip。
运行前需要先安装额外的东西吗?没有列出单独的运行环境。AI 模型会在首次使用时下载一次,但只有在你同意之后才会下载;运行前会通过 SHA-256 校验,之后可离线使用。
有什么需要注意的地方吗?景深 AI 蒙版目前标注为实验性功能。在 Linux 上,没有 Vulkan 驱动的显卡只能使用较慢的 CPU 备用方案,因此较老的 Intel 硬件上渲染可能要等很久。
它能在哪些系统上运行?Linux、Android、Windows 和 macOS。Linux 和 Windows 提供 x86-64 或 ARM64 版本,Android 提供 ARM64 版本,macOS 提供 Apple Silicon 或 Intel 版本。
我的数据会离开设备吗?不会。编辑、AI 蒙版、AI Remove 和 AI Denoise 都在本地运行。应用只在下载 AI 模型或 ONNX Runtime 时联网,且只有在你同意之后才会。
AI 工具到底能做什么?它们可以把主体、天空、景深或点选的对象生成为蒙版,用 AI Remove(Big-LaMa)移除不需要的物体,并对高 ISO 的 RAW 照片降噪,全部在设备上完成。
编辑是非破坏性的吗?是的。所有滑块、曲线和蒙版都保存在轻量的 .calibraw JSON 附属文件中,因此你的原始 RAW 文件不会被改动。
支持哪些 RAW 相机?LibRaw 或 Rawler 能打开的所有格式,以及 JPEG、PNG、HEIC 和 TIFF。完整支持列表见 README。
什么是 Edit Replay?它可以导出 30 FPS 的 MP4 视频,逐步展示你的编辑过程,适合用于 Reels、Shorts 或前后对比类帖子。
作者
Duecki1
大小
70.8 MB
星标
343
时长
4个月
提交 · 90 天