RawTherapee as part of a workflow – Scripts and Command line

In the first two articles, picture management and processing I & II, I wrote about making a shorter workflow, a better efficiency in storage, and gaining speed and computer memory.
This gain could be made by using RawTherapee different,
First, like using RT directly as viewer and developer.
Simply said : dont develop 100 Jpegs from 100 RAW – but develop only the RAW pictures you want/need to TIFF, then edit, and only then convert to final Jpeg.
Also, keep only essential TIFF images, delete the “between steps” TIFFs.
Second, by using command line and scripts.

To use command line and/or write scripts, we need to know what commands are available.
Here is a list that you can generate by giving the command :
rawtherapee.exe -h
if you need a txt output that you can save :
rawtherapee.exe -h>help.txt
and here it is :

RawTherapee, version 4.2.312
WARNING: closing this window will close RawTherapee!

<Chevrons> indicate parameters you can change.
[Square brackets] mean the parameter is not mandatory.
The pipe symbol | indicates a choice of one or the other.
The dash symbol – denotes a range of possible values from one to the other.

Usage:
rawtherapee <selected dir> Start File Browser inside directory.
rawtherapee <file> Start Image Editor with file.
rawtherapee -c <dir>|<files> Convert files in batch with default parameters.

-w Do not open the Windows console
Other options used with -c (-c must be the last option):
rawtherapee [-o <output>|-O <output>] [-s|-S] [-p <files>] [-d] [-j[1-100] [-js<1-3>]|[-b<8|16>] <[-t[z] | [-n]]] [-Y] -c <input>
-o <file>|<dir> Select output file or directory.
-O <file>|<dir> Select output file or directory and copy pp3 file into it.
-s Include the pp3 file next to the input file (with the same
name) to build the image parameters,
e.g. for photo.raw there should be a photo.raw.pp3 file in
the same directory. If the file does not exist, internal
default (neutral) values (not those in Default.pp3) will be
used.
-S Like -s but skip if the pp3 file does not exist.
-p <file.pp3> Specify pp3 file to be used for all conversions.
You can specify as many -p options as you like (see
description below).
-d Use the default raw or non-raw pp3 file as set in
Preferences > Image Processing > Default Processing Profile
-j[1-100] Specify output to be JPEG (on by default). Optionally add
compression 1-100 (default value: 92).
-js<1-3> Specify the JPEG subsampling parameter, where:
1 = Best compression: 2×2, 1×1, 1×1 (4:1:1) – default of the JPEG library
2 = Widely used normal ratio: 2×1, 1×1, 1×1 (4:2:2)
3 = Best quality: 1×1, 1×1, 1×1 (4:4:4)
-b<8|16> Specify bit depth per channel (only applies to TIFF and PNG output).
-t[z] Specify output to be TIFF (16-bit if -b8 is not set).
Uncompressed by default, or ZIP compression with ‘z’
-n Specify output to be compressed PNG (16-bit if -b8 is not set).
-Y Overwrite output if present.

Your pp3 files can be incomplete, RawTherapee will set the values as follows:
1- A new profile is created using internal default (neutral) values
(hard-coded into RawTherapee),
2- then overridden by those found in the default raw or non-raw pp3 file
(if -d has been set),
3- then overridden by those found in the pp3 files provided by -p, each one
overriding the previous values,
4- then overridden by the sidecar file if -s is set and if the file exists;
the time where the sidecar file is used depends on the position of the -s
switch in the command line relative to the -p parameters,
e.g. -p first.pp3 -p second.pp3 -s -p fourth.pp3
Press any key to exit RawTherapee

If you examine this list, you will notice that its very basic, only commands for input/output-file/directory, file extension etc.
The only command for image editing like exposure or any other, runs on a profile
( pp3 ), so the next step is to examine a profile, and with that information creating our own profile.
To create a profile, open an image, alter the values of something you like to change, and save this profile by clicking the disk icon at the top of the RT menu.

saving-profile

 

Below you can find an example profile, it’s only a part of it, and with it I want to say that you only need the elements you like to change.
You could create a profile with only the following command :
[Exposure]
Auto=true

Sample profile  ( only a part of it ) :

[Version]
AppVersion=4.2.312
Version=326

[General]
Rank=0
ColorLabel=0
InTrash=false

[Exposure]
Auto=true
Clip=0.02
Compensation=0
Brightness=0
Contrast=0
Saturation=9
Black=0
HighlightCompr=0
HighlightComprThreshold=0
ShadowCompr=50
CurveMode=FilmLike
CurveMode2=SatAndValueBlending
Curve=0;
Curve2=0;

[Sharpening]
Enabled=true
Method=usm
Radius=1.28
Amount=200
Threshold=20;80;2000;1200;
OnlyEdges=true
EdgedetectionRadius=1.8999999999999999
EdgeTolerance=1800
HalocontrolEnabled=false
HalocontrolAmount=85
DeconvRadius=0.75
DeconvAmount=75
DeconvDamping=20
DeconvIterations=30

[White Balance]
Setting=Camera
Temperature=5054
Green=1.121
Equal=1

[Directional Pyramid Denoising]
Enabled=true
Enhance=false
Median=false
Auto=false
Luma=5.3399999999999999
Ldetail=0
Chroma=39.409999999999997
Method=Lab
LMethod=SLI
CMethod=MAN
C2Method=AUTO
SMethod=shalbi
MedMethod=soft
RGBMethod=soft
MethodMed=Lonly
Redchro=0
Bluechro=0
Gamma=1.7
Passes=1
LCurve=1;0.050000000000000003;0.14999999999999999;0.34999999999999998;0.34999999999999998;0.55000000000000004;0.040000000000000001;0.34999999999999998;0.34999999999999998;
CCCurve=1;0.050000000000000003;0.5;0.34999999999999998;0.34999999999999998;0.34999999999999998;0.050000000000000003;0.34999999999999998;0.34999999999999998;

Next step : basic RT commands followed by a simple custom profile development.

Leave a Reply

Your email address will not be published. Required fields are marked *