UnRAWer

Small GUI utility to Batch process Camera RAW images with OpenColorIO 3D Lut support. A tool designed as a helper tool for photogrammetry (3D scanning) image batch processing tool where speed is more important than feature-rich raw image processors.

Core features

Support all camera raws supported in Libraw library, including ProRAW DNG
Headless (CLI) mode
Multithreaded and asynchronous batch processing
Drag and drop interface with recursive subfolders support
Half Resolution camera raws import
Export as raw sensor data (bw), Bayers pattern (RGB), and different demosaic methods (supported in libraw)
Smart (per folder_suffix/filename_suffix) 3D Lut grading presets (via OpenColorIO)
Smart per-camera (Make, Model) LUT
Export as 8/16/32bit int/float tiff/jpeg/jpeg2000/jpegxl/heic/PPM/PNG
Export Exif and XMP metatags (only subset)
tool configuration via TOML config file

Limitations

Cropping RAWs is not guaranteed to be identical to commercial raw processors' crops.

User Manual

Settings are available through *.toml config file and UI menu

Global

Global app settings

Console = true/false

Threads count for read and write

Choose these settings depending on your CPU, memory, and IO specs

Threads = 10

Threads multiplier for processing 1.0 equals all cores/threads

(TODO: check if still used)

ThredsMult = 1.0

Export into subfolders

If set to true, processed images will be stored in the lut_name folder. Otherwise, lut_name will be added as a suffix (aka. filename_lut_name.ext)

ExportSubf = true

Global subfolders prefix

relative path prefix. For example, "../Proc" will create a folder Proc in a parent folder to a camera raw images source folder.

PathPrefix = ""

log level is 0-5, 0 is most verbose

0 = trace, 1 = debug, 2 = info, 3 = warning, 4 = error, 5 = fatal

0 = only fatal errors,
1 = error,
2 = warning,
3 = info (default),
4 = debug,
5 = trace (most outputs)

Verbosity = 3

Range

Range conversion mode

(TODO: check if still needed; this part of code from Solidify)

0 - Unsigned 0.0 ~ 1.0
1 - Signed -1.0 ~ 1.0
2 - Signed to Unsigned -1.0~~1.0 -> 0.0~~1.0
3 - Unsigned to Signed 0.0~~1.0 -> -1.0~~1.0

RangeMode = 0

Export

Export settings

FileFormat:

-1 - Same as input. If the input format can't be used for export (for example, CameraRAWs) app will use the default
0 - TIFF
1 - OpenEXR
2 - PNG
3 - JPEG
4 - JPEG-2000
5 - JPEG XL
6 - HEIC
7 - PPM

DefaultFormat = 3 FileFormat = -1

Bit depth:

-1 - Original
0 - uint8 (8bit unsigned int)
1 - uint16 (16bit unsigned int)
2 - uint32 (64bit unsigned int) !! most file formats do not support 32bit unsigned int
3 - uint64 (64bit unsigned int) !! most file formats do not support double-precision
4 - half (16bit float)
5 - float (32bit float)
6 - double (64-bit float) !! Most file formats do not support double-precision

DefaultBit = 4 BitDepth = -1

Quality

100 - lossless or best quality
0 - worst quality

Quality = 95

CameraRaw

Raw rotation:

-1 - Auto EXIF
0 - Unrotated/Horizontal
3 - 180 Horizontal
5 - 90 CW Vertical
6 - 90 CCW Vertical

RawRotation = -1

Raw Color Space

(TODO: Check if this is an actual color conversion in LibRAW or just a tagging)

0 - raw
1 - sRGB
2 - sRGB-linear (sRGB primaries, but a linear transfer function)
3 - Adobe
4 - Wide
5 - ProPhoto
6 - ProPhoto-linear
7 - XYZ
8 - ACES (only supported by LibRaw >= 0.18)
9 - DCI-P3 (LibRaw >= 0.21)
10 - Rec2020 (LibRaw >= 0.2)

RawColorSpace = 1

Demosaic

-2 - raw data (Single channel)
-1 - no demosaic (RGB)
0 - linear
1 - VNG
2 - PPG
3 - AHD (default)
4 - DCB
5 ~ 10 is not used
11 - DHT
12 - AAHD (Modified AHD)

Demosaic = 3

Import Camera RAW in half-resolution

half_size = false

use_auto_wb

Use automatic white balance obtained after averaging over the entire image.

use_auto_wb = false

use_camera_wb

If possible, use the white balance from the camera.

use_camera_wb = true

use_camera_matrix

0: do not use an embedded color profile
1 (default): use embedded color profile (if present) for DNG files (always); for other files only if use_camera_wb is set; -# 3: use embedded color data (if present) regardless of the white balance setting.

use_camera_matrix = 1

highlight

0-9: Highlight mode (0=clip, 1=unclip, 2=blend, 3+=rebuild).

highlights = 3

aberrations

Correction of chromatic aberrations (red multiplier, blue multiplier)

aberrations = 1.0, 1.0

Denoise before debayering.

It is not recommended to use both wavelet denoising and FBDD noise reduction!

0 - disabled
1 - wavelength
2 - fbdd
3 - both

denoise_mode = 1

threshold

Use wavelets to erase noise while preserving real detail. The best threshold should be somewhere between 100 and 1000.

dnz_threshold = 100.0

fbdd_noiserd

Controls FBDD noise reduction before demosaic.

0 - do not use FBDD noise reduction
1 - light FBDD reduction
2 (and more) - full FBDD reduction

fbdd_noiserd = 2

Exif crop

At this moment, both auto and force work the same. TODO: merge them into the one

-1 - disabled
0 - auto
1 - force

exif_crop = 0

OCIO settings

OCIO config file: If empty, the OpenColorIO library will use the $OCIO environment variable

If $OCIO is not set, app will give an error

OCIO_Config = "aces_1.2/config.ocio"

Transform image (color transform)

Luts folder, absolute or relative to a program folder. UnRAWer automatically loads the list of LUTs in this folder in load time. Use a console to check if LUTs are correctly recognized. No LUT checking load time!! (TODO: check if non-default handle correctly)

LutFolder = "LUTs"

LUT transform mode

LUT mode. If set to Smart check if path or image file name have included lut preset name. For example, several folders with raw files: diffuse, cross, parallel, and you have dedicated LUT presets for such images. UnRAWer should automatically recognize and use a dedicated LUT preset.

-1 - disabled
0 - Smart (file path/name)
1 - Force

LutTransform = 1

Force/Default preset

LutDefault = "hdr"

Per camera model presets

exif_lut = false

Unsharp

Unsharp mask

Unsharp mode:

-1 - disabled
0 - smart
1 - Force

sharp_mode = 1

Unsharp kernel

0 - gaussian (default)
1 - sharp-gaussian
2 - box
3- triangle
4 - blackman-harris
5 - mitchell
6 - b-spline
7 - catmull-rom
8 - lanczos3
9 - disk
10 - binomial
11 - laplacian
12 - median

sharp_kernel = 0

sharp window size sharp_width = 3.0 sharp strength sharp_contrast = 0.5 threshold sharp_treshold = 0.125

source + contrast * (source - blur) if (source - blur) < threshold => result == source (no sharp)

Headless (CLI)

Process single RAW file from CLI using default config file settings (less efficient way to use CLI)

UnRAWer.exe path_to_file.ext

Process a folder with raw files from CLI using default config file settings.

UnRAWer.exe path_to_folder

Process multiply folders with raw files from CLI using default config file settings and more silent verbosity

UnRAWer.exe -v=1 path_to_folder1 path_to_folder2

Process multiply inputs (folders and files) with raw files from CLI using default config file settings and more verbosity

UnRAWer.exe -v=4 path_to_folder1 path_to_folder2 path_to_file1.ext path_to_file2.ext path_to_file3.ext

Process multiply inputs (folders and lists) with raw files from CLI using custom config file settings and more verbosity

UnRAWer.exe -v=4 path_to_config.toml path_to_folder1 path_to_file_list.txt

Required dependencies

OpenImageIO
LibRAW
OpenImageIO
libTIFF
OpenJpeg (jpeg2000)
libJpeg-turbo (jpeg)
libjxl (jpeg xl)
zlib-ng
QT6
etc.

Support

Please consider supporting this project via https://www.patreon.com/MadProcessor

License

UnRAWer is licensed under the GNU General Public License, Version 3. Individual files may have a different but compatible license.

Files

README.md

Latest commit

History