1RAWTHERAPEE(1)              General Commands Manual             RAWTHERAPEE(1)
2
3
4

NAME

6       RawTherapee  -  An  advanced, cross-platform program for developing raw
7       photos.
8

DESCRIPTION

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

SYMBOLS

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

SYNOPSIS

29         RawTherapee GUI
30         rawtherapee <folder>           Start File Browser inside folder.
31         rawtherapee <file>             Start Image Editor with file.
32
33         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

OPTIONS

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
97       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

AUTHOR

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
119
120
121                                 May 10, 2017                   RAWTHERAPEE(1)
Impressum