1RAWTHERAPEE(1) General Commands Manual RAWTHERAPEE(1)
2
6 RawTherapee - An advanced, cross-platform program for developing raw
7 photos.
8
10 RawTherapee is an advanced program for developing raw photos and for
11 processing non-raw photos. It is non-destructive, makes use of OpenMP,
12 supports all the cameras supported by dcraw and more, and carries out
13 its calculations in a high precision 32-bit floating point engine.
14
16 Website: http://www.rawtherapee.com/
17 Documentation: http://rawpedia.rawtherapee.com/
18 Forum: https://discuss.pixls.us/c/software/rawtherapee
19 Code and bug reports: https://github.com/Beep6581/RawTherapee
20
22 <Chevrons> indicate parameters you can change.
23 [Square brackets] mean the parameter is optional.
24 The pipe symbol | indicates a choice of one or the other.
25 The dash symbol - denotes a range of possible values from one to the
26 other.
27
29 RawTherapee GUI
30 rawtherapee <folder> Start File Browser inside folder.
31 rawtherapee <file> Start Image Editor with file.
32 RawTherapee CLI
34 rawtherapee-cli -c <dir>|<files> Convert files in batch using
35 default parameters.
36 rawtherapee-cli <other options> -c <dir>|<files> Convert files in
37 batch using your own settings.
38 rawtherapee-cli [-o <output>|-O <output>] [-q] [-a] [-s|-S] [-p
39 <one.pp3> [-p <two.pp3> ...] ] [-d] [ -j[1-100] [-js<1-3>] | [-b<8|16>]
40 [-t[z] | [-n]] ] [-Y] -c <input>
41
43 -c <files> Specify one or more input files.
44 -c must be the last option.
45 -o <file>|<dir> Set output file or folder.
46 Saves output file alongside input file if -o is not
47 specified.
48 -O <file>|<dir> Set output file or folder and copy pp3 file into it.
49 Saves output file alongside input file if -O is not
50 specified.
51 -q Quick-start mode. Does not load cached files to
52 speedup start time.
53 -a Process all supported image file types when specify‐
54 ing a folder, even those
55 not currently selected in Preferences > File Browser
56 > Parsed Extensions.
57 -s Use the existing sidecar file to build the process‐
58 ing parameters,
59 e.g. for photo.raw there should be a photo.raw.pp3
60 file in the same folder.
61 If the sidecar file does not exist, neutral values
62 will be used.
63 -S Like -s but skip if the sidecar file does not exist.
64 -p <file.pp3> Specify processing profile to be used for all con‐
65 versions.
66 You can specify as many sets of "-p <file.pp3>"
67 options as you like,
68 each will be built on top of the previous one, as
69 explained below.
70 -d Use the default raw or non-raw processing profile as
71 set in
72 Preferences > Image Processing > Default Processing
73 Profile
74 -j[1-100] Specify output to be JPEG (default, if -t and -n are
75 not set).
76 Optionally, specify compression 1-100 (default
77 value: 92).
78 -js<1-3> Specify the JPEG chroma subsampling parameter,
79 where:
80 1 = Best compression: 2x2, 1x1, 1x1 (4:2:0)
81 Chroma halved vertically and horizontally.
82 2 = Balanced (default): 2x1, 1x1, 1x1 (4:2:2)
83 Chroma halved horizontally.
84 3 = Best quality: 1x1, 1x1, 1x1 (4:4:4)
85 No chroma subsampling.
86 -b<8|16> Specify bit depth per channel (default value: 16 for
87 TIFF, 8 for PNG).
88 Only applies to TIFF and PNG output, JPEG is always
89 8.
90 -t[z] Specify output to be TIFF.
91 Uncompressed by default, or deflate compression with
92 'z'.
93 -n Specify output to be compressed PNG.
94 Compression is hard-coded to 6.
95 -Y Overwrite output if present.
96 Your pp3 files can be incomplete, RawTherapee will build the final val‐
98 ues as follows:
99 1- A new processing profile is created using neutral values,
100 2- If the "-d" option is set, the values are overridden by those
101 found in
102 the default raw or non-raw processing profile.
103 3- If one or more "-p" options are set, the values are overridden by
104 those
105 found in these processing profiles.
106 4- If the "-s" or "-S" options are set, the values are finally over‐
107 ridden by those
108 found in the sidecar files.
109 The processing profiles are processed in the order specified on the
110 command line.
111
113 RawTherapee was originally written by Gabor Horvath of Budapest, Hun‐
114 gary, before being re-licensed as free and open-source software in Jan‐
115 uary 2010.
116 The RawTherapee development team comprises of passionate people from
117 all around the world.
118 May 10, 2017 RAWTHERAPEE(1)