Command-Line Options - Revision history

DrSlony at 21:30, 9 December 2019

2019-12-09T21:30:25Z

← Older revision		Revision as of 21:30, 9 December 2019
Line 1:		Line 1:
			<div class="pagetitle">Command-Line Options</div>

	== Explanation ==		== Explanation ==
	: <code><</code>Chevrons<code>></code> indicate parameters you can change.		: <code><</code>Chevrons<code>></code> indicate parameters you can change.

Hombre: Updated -w and -R section

2017-08-22T21:20:20Z

Updated -w and -R section

← Older revision		Revision as of 21:20, 22 August 2017
Line 17:		Line 17:

	: <code>-w</code>		: <code>-w</code>
	:: Do not open the Windows console. This option is available in Windows only. If you pass parameters to the RawTherapee executable it spawns a console window so that you can see the verbose output of your processing. Normally Windows closes this console directly after RawTherapee is terminated. To let you see the output we added a prompt which waits for you to hit a key before closing the console. By specifying <code>-w</code> no console will be opened and therefore no key press is needed. Useful if you want to invoke <code>rawtherapee.exe</code> in batch, e.g. from a PowerShell script.		:: Do not open the Windows console. This option is available in Windows only. If you pass parameters to the RawTherapee executable it spawns a console window so that you can see the verbose output of your processing. Normally Windows closes this console directly after RawTherapee is terminated. To let you see the output we added a prompt which waits for you to hit a key before closing the console. By specifying <code>-w</code> no console will be opened and therefore no key press is needed. Useful if you want to invoke <code>rawtherapee.exe</code> in batch, e.g. from a PowerShell script. Please note that <code>-w</code> will have no effect for "Debug" builds where a console window will be opened unless you're starting RawTherapee from a console window already.

	: <code>-v</code>		: <code>-v</code>
Line 23:		Line 23:

	: <code>-R</code>		: <code>-R</code>
	:: "Remote" mode, available since RawTherapee 5.2. When opening an image using "Open with" or by passing its filename as an argument, without using the -R option RawTherapee will open in "no-File-Browser" mode - that is a mode which lacks the File Browser and Queue tabs as well as the Preferences button. Using the new -R mode, RawTherapee will open in a full-fledged instance. Using -R also allows you to open an image in an already-running instance of RawTherapee, if that instance was also started using -R. The no-File-Browser mode exists for historical reasons when RAM requirements were higher and stability was worse. Now that RawTherapee's memory usage is optimized and it can quickly and reliably open folders with thousands of images, users may prefer using the -R mode by default.		:: "Remote" mode, available since RawTherapee 5.2. When opening an image using "Open with" or by passing its filename as an argument, without using the <code>-R</code> option RawTherapee will open in "no-File-Browser" mode - that is a mode which lacks the File Browser and Queue tabs as well as the Preferences button. Using the new <code>-R</code> mode, RawTherapee will open in a full-fledged instance. Using <code>-R</code> also allows you to open an image in an already-running instance of RawTherapee, if that instance was also started using <code>-R</code>. The no-File-Browser mode exists for historical reasons when RAM requirements were higher and stability was worse. Now that RawTherapee's memory usage is optimized and it can quickly and reliably open folders with thousands of images, users may prefer using the <code>-R</code> mode by default.

	: <code>-h -?</code>		: <code>-h -?</code>

DrSlony at 14:04, 4 August 2017

2017-08-04T14:04:52Z

← Older revision		Revision as of 14:04, 4 August 2017
Line 23:		Line 23:

	: <code>-R</code>		: <code>-R</code>
	:: "Remote" mode, available since RawTherapee 5.2. When opening an image using "Open with" or by passing its filename as an argument, without using the -R option RawTherapee will open in "no-File-Browser" mode - that is a mode which lacks the File Browser and Queue tabs as well as the Preferences button. Using the new -R mode, RawTherapee will open in a full-fledged instance. Using -R also allows you to open an image in an already-running instance of RawTherapee, if that instance was also started using -R. The no-File-Browser mode exists for historical reasons when RAM requirements were higher and stability was worse. Now that RawTherapee's memory usage is optimized and it can open folders with thousands of images, users may prefer using the -R mode by default.		:: "Remote" mode, available since RawTherapee 5.2. When opening an image using "Open with" or by passing its filename as an argument, without using the -R option RawTherapee will open in "no-File-Browser" mode - that is a mode which lacks the File Browser and Queue tabs as well as the Preferences button. Using the new -R mode, RawTherapee will open in a full-fledged instance. Using -R also allows you to open an image in an already-running instance of RawTherapee, if that instance was also started using -R. The no-File-Browser mode exists for historical reasons when RAM requirements were higher and stability was worse. Now that RawTherapee's memory usage is optimized and it can quickly and reliably open folders with thousands of images, users may prefer using the -R mode by default.

	: <code>-h -?</code>		: <code>-h -?</code>

DrSlony: /* RawTherapee GUI */

2017-08-04T14:04:19Z

RawTherapee GUI

← Older revision		Revision as of 14:04, 4 August 2017
Line 23:		Line 23:

	: <code>-R</code>		: <code>-R</code>
	:: "Remote" mode, available since RawTherapee 5.2. When opening an image using "Open with" or by passing its filename as an argument, without using the -R option RawTherapee will open in "no-File-Browser" mode - that is a mode which lacks the File Browser and Queue tabs as well as the Preferences button. Using the new -R mode, RawTherapee will open in a full-fledged instance. Using -R also allows you to open an image in an already-running instance of RawTherapee, if that instance was also started using -R. The no-File-Browser mode exists for historical reasons when ~~stability and~~ RAM ~~usage~~ were higher. Now that RawTherapee's memory usage is optimized and it can open folders with thousands of images, users may prefer using the -R mode by default.		:: "Remote" mode, available since RawTherapee 5.2. When opening an image using "Open with" or by passing its filename as an argument, without using the -R option RawTherapee will open in "no-File-Browser" mode - that is a mode which lacks the File Browser and Queue tabs as well as the Preferences button. Using the new -R mode, RawTherapee will open in a full-fledged instance. Using -R also allows you to open an image in an already-running instance of RawTherapee, if that instance was also started using -R. The no-File-Browser mode exists for historical reasons when RAM requirements were higher and stability was worse. Now that RawTherapee's memory usage is optimized and it can open folders with thousands of images, users may prefer using the -R mode by default.

	: <code>-h -?</code>		: <code>-h -?</code>

DrSlony: Updated

2017-07-24T11:48:59Z

Updated

Show changes

DrSlony: /* Explanation */

2017-06-10T11:06:39Z

Explanation

← Older revision		Revision as of 11:06, 10 June 2017
Line 16:		Line 16:

	: <code>-w</code>		: <code>-w</code>
	:: Do not open the Windows console. This option is available in Windows only. If you pass parameters to the RawTherapee executable it spawns a console window so that you can see the verbose output of your processing. Normally Windows closes this console directly after RawTherapee is terminated. To let you see the output we added a prompt which waits for you to hit a key before closing the console. By specifying <code>-w</code> no console will be opened and therefore no key press is needed. Useful if you want to invoke rawtherapee.exe in batch, e.g. from a PowerShell script.		:: Do not open the Windows console. This option is available in Windows only. If you pass parameters to the RawTherapee executable it spawns a console window so that you can see the verbose output of your processing. Normally Windows closes this console directly after RawTherapee is terminated. To let you see the output we added a prompt which waits for you to hit a key before closing the console. By specifying <code>-w</code> no console will be opened and therefore no key press is needed. Useful if you want to invoke <code>rawtherapee.exe</code> in batch, e.g. from a PowerShell script.

	=== RawTherapee CLI ===		=== RawTherapee CLI ===

DrSlony: /* RawTherapee CLI */

2017-06-10T11:06:23Z

RawTherapee CLI

← Older revision		Revision as of 11:06, 10 June 2017
Line 26:		Line 26:

	: <code>-w</code>		: <code>-w</code>
	:: Do not open the Windows console. This option is available in Windows only. If you pass parameters to the RawTherapee executable it spawns a console window so that you can see the verbose output of your processing. Normally Windows closes this console directly after RawTherapee is terminated. To let you see the output we added a prompt which waits for you to hit a key before closing the console. By specifying <code>-w</code> no console will be opened and therefore no key press is needed. Useful if you want to invoke rawtherapee.exe in batch, e.g. from a PowerShell script.		:: Do not open the Windows console. This option is available in Windows only. If you pass parameters to the RawTherapee executable it spawns a console window so that you can see the verbose output of your processing. Normally Windows closes this console directly after RawTherapee is terminated. To let you see the output we added a prompt which waits for you to hit a key before closing the console. By specifying <code>-w</code> no console will be opened and therefore no key press is needed. Useful if you want to invoke <code>rawtherapee-cli.exe</code> in batch, e.g. from a PowerShell script.

	Other options used with <code>-c</code> (<code>-c</code> must be the last option):		Other options used with <code>-c</code> (<code>-c</code> must be the last option):

Hombre: /* rename rawtherapee to rawtherapee-cli */

2017-05-12T23:26:34Z

rename rawtherapee to rawtherapee-cli

← Older revision		Revision as of 23:26, 12 May 2017
Line 104:		Line 104:
	<code><nowiki>time {		<code><nowiki>time {
	for f in /home/user/photos/2011-11-11/*.raw; do		for f in /home/user/photos/2011-11-11/*.raw; do
	rawtherapee -o /dev/null -S -t -Y -c "$f";		rawtherapee-cli -o /dev/null -S -t -Y -c "$f";
	done		done
	}</nowiki></code>		}</nowiki></code>

Hombre: /* rename rawtherapee to rawtherapee-cli */

2017-05-12T23:25:32Z

rename rawtherapee to rawtherapee-cli

← Older revision		Revision as of 23:25, 12 May 2017
Line 88:		Line 88:
	=== Example 2 ===		=== Example 2 ===
	In the next example, we'll assume that you want to quickly process all your raw photos from the /tmp/jane01 directory to a web sub-directory by using the default profile as a basis, using the sidecar profile if it exist, but with removing some Exif tags (e.g. the camera's serial number) and adding some IPTC tags (e.g. your usual copyright parameters), plus resize and sharpen the image for the web (spread over multiple lines for clarity):		In the next example, we'll assume that you want to quickly process all your raw photos from the /tmp/jane01 directory to a web sub-directory by using the default profile as a basis, using the sidecar profile if it exist, but with removing some Exif tags (e.g. the camera's serial number) and adding some IPTC tags (e.g. your usual copyright parameters), plus resize and sharpen the image for the web (spread over multiple lines for clarity):
	<code>rawtherapee -o /tmp/Jane01/web -p ~/profiles/iptc.pp3 -s -p ~/profiles/exif.pp3 -p ~/profiles/web.pp3 -t -Y -d -c /tmp/Jane01/</code>		<code>rawtherapee-cli -o /tmp/Jane01/web -p ~/profiles/iptc.pp3 -s -p ~/profiles/exif.pp3 -p ~/profiles/web.pp3 -t -Y -d -c /tmp/Jane01/</code>

	The processing profile will be built as follows:		The processing profile will be built as follows:

Hombre: /* rename rawtherapee to rawtherapee-cli */

2017-05-12T23:24:45Z

rename rawtherapee to rawtherapee-cli

← Older revision		Revision as of 23:24, 12 May 2017
Line 84:		Line 84:
	=== Example 1 ===		=== Example 1 ===
	In Linux, process a single raw which resides in /tmp and is called "photo.raw", use its sidecar file "photo.raw.pp3" during conversion, save it in the same directory as "foo.tif", and overwrite the file "foo.tif" if it exists:		In Linux, process a single raw which resides in /tmp and is called "photo.raw", use its sidecar file "photo.raw.pp3" during conversion, save it in the same directory as "foo.tif", and overwrite the file "foo.tif" if it exists:
	<code>rawtherapee -o /tmp/foo.tif -s -t -Y -c /tmp/photo.raw</code>		<code>rawtherapee-cli -o /tmp/foo.tif -s -t -Y -c /tmp/photo.raw</code>

	=== Example 2 ===		=== Example 2 ===