File Paths - Revision history

Benitoite: Update Mac Paths

2024-09-16T02:45:43Z

Update Mac Paths

← Older revision		Revision as of 02:45, 16 September 2024
Line 30:		Line 30:
	: <code>~/.config/</code>		: <code>~/.config/</code>
	; macOS		; macOS
	: <code>~/Library/Application Support/RawTherapee/config/</code>		: <code>~/Library/Containers/RawTherapee/Data/Library/Application Support/RawTherapee/config/</code>
	: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.		: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.

Line 51:		Line 51:
	: <code>~/.cache/</code>		: <code>~/.cache/</code>
	; macOS		; macOS
	: <code>~/Library/Application Support/RawTherapee/cache/</code>		: <code>~/Library/Containers/RawTherapee/Data/Library/Application Support/RawTherapee/cache/</code>
	: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.		: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.

DrSlony: /* Temporary Folder */

2023-01-04T18:57:57Z

Temporary Folder

← Older revision		Revision as of 18:57, 4 January 2023
Line 74:		Line 74:
	== Temporary Folder ==		== Temporary Folder ==

	The "[[Edit Current Image in External Editor]]" tool stores intermediate image files in a ~~temporary folder:~~		The "[[Edit Current Image in External Editor]]" tool stores intermediate image files in the folder specified in [[Preferences#External_Editor\|Preferences > External Editor > Output Directory]]. By default this is the operating system's default temp folder. RawTherapee will use a subdirectory with the name format <code>rawtherapee-<username></code>, e.g. <code>rawtherapee-Lawrence37</code>, and permissions are set to user-only read/write access. If this subdirectory already exists but has the wrong permissions, a new directory will be created with the correct permissions and with the name format <code>rawtherapee-<username>-xxxxxx</code> where <code>xxxxxx</code> is a random sequence of 6 characters, e.g. <code>rawtherapee-Lawrence37-abc123</code>.

	; Windows		; Windows
	: The default ~~location~~ is the one stored in the <code>$TEMP</code> environment variable, which is usually <code>%LOCALAPPDATA%/Temp</code>		: The operating system's default temp folder is the one stored in the <code>$TEMP</code> environment variable, which is usually <code>%LOCALAPPDATA%/Temp</code>
	: If you do not have the <code>$TEMP</code> environment variable set, <code>C:\</code> is used.		: If you do not have the <code>$TEMP</code> environment variable set, <code>C:\</code> is used.
	; Linux and macOS		; Linux and macOS
	: The default ~~location~~ is the one stored in the <code>$TMPDIR</code> environment variable, which is usually <code>/tmp</code>		: The operating system's default temp folder is the one stored in the <code>$TMPDIR</code> environment variable, which is usually <code>/tmp</code>
	: If you do not have the <code>$TMPDIR</code> environment variable set, <code>/tmp</code> is used.		: If you do not have the <code>$TMPDIR</code> environment variable set, <code>/tmp</code> is used.

DrSlony at 21:27, 9 December 2019

2019-12-09T21:27:41Z

← Older revision		Revision as of 21:27, 9 December 2019
Line 1:		Line 1:
			<div class="pagetitle">File Paths</div>

	RawTherapee makes use of a "cache" folder to store temporary files which are safe to delete, and a "config" folder which stores your RawTherapee settings, custom processing profiles and other user-editable files. These folders reside in a special place, described below, and have a name that begins with the word "RawTherapee" optionally followed by a suffix. This suffix is set by the person who made the build of RawTherapee you're using. Some examples of what it can look like:		RawTherapee makes use of a "cache" folder to store temporary files which are safe to delete, and a "config" folder which stores your RawTherapee settings, custom processing profiles and other user-editable files. These folders reside in a special place, described below, and have a name that begins with the word "RawTherapee" optionally followed by a suffix. This suffix is set by the person who made the build of RawTherapee you're using. Some examples of what it can look like:
	* RawTherapee		* RawTherapee

DrSlony at 11:42, 5 August 2019

2019-08-05T11:42:02Z

← Older revision		Revision as of 11:42, 5 August 2019
Line 10:		Line 10:

	== Config ==		== Config ==

	The RawTherapee config folder contains:		The RawTherapee config folder contains:
	* the "options" file, which contains all of your settings from [[Preferences]],		* the "options" file, which contains all of your settings from [[Preferences]],
Line 31:		Line 32:

	== Cache ==		== Cache ==

	The RawTherapee cache folder contains sets of cached items, where each set consists of:		The RawTherapee cache folder contains sets of cached items, where each set consists of:
	* a thumbnail,		* a thumbnail,
Line 38:		Line 40:

	By default, RawTherapee keeps up to 20 000 cached sets. Keep an eye on the "cache" folder as over time it may grow considerably in size! This is mostly due to the cached thumbnails which are stored in the "images" sub-folder. Deleting the "images" sub-folder is safe, you will not lose any image settings, RawTherapee will just have to regenerate the thumbnails.		By default, RawTherapee keeps up to 20 000 cached sets. Keep an eye on the "cache" folder as over time it may grow considerably in size! This is mostly due to the cached thumbnails which are stored in the "images" sub-folder. Deleting the "images" sub-folder is safe, you will not lose any image settings, RawTherapee will just have to regenerate the thumbnails.

	~~A cached set used to include a 32kB histogram file, but as of RawTherapee 5.5 the need for storing the histogram was eliminated.~~

	Default locations for the RawTherapee cache folder (look for the "RawTherapee*" prefix as described above):		Default locations for the RawTherapee cache folder (look for the "RawTherapee*" prefix as described above):
Line 51:		Line 51:
	: <code>~/Library/Application Support/RawTherapee/cache/</code>		: <code>~/Library/Application Support/RawTherapee/cache/</code>
	: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.		: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.

			A cached set used to include a 32kB histogram file, but as of RawTherapee 5.5 the need for storing the histogram was eliminated.

	== Custom config and cache folders ==		== Custom config and cache folders ==
	~~Even though~~ the ~~path and name of the cache and config folders is hard-coded into RawTherapee, as of version 4.0.12.33 you can change them~~ to ~~any~~ '''absolute''' path by ~~using~~ the ~~<code>RT_SETTINGS</code> and~~ <code>RT_CACHE</code> environment ~~variables~~. How you do that depends on your operating system, so just search on the internet for "how to set environment variables in ''<your operating system>''".
			You can have RawTherapee use a custom config folder by setting the <code>RT_SETTINGS</code> environment variable to an '''absolute''' path which you have read and write access to, and likewise you can use a custom cache folder by setting the <code>RT_CACHE</code> environment variable. How you do that depends on your operating system, so just search on the internet for "how to set environment variables in ''<your operating system>''".

	Some examples:		Some examples:
	; Windows		; Windows
	: <code>RT_SETTINGS=%LOCALAPPDATA%\rawtherapee\4.2</code>		: Variable name: <code>RT_SETTINGS</code>, value: <code>%LOCALAPPDATA%\rawtherapee\5.7</code>
	: <code>RT_CACHE=C:\~~Users\Bob\AppData\Local~~\~~rtcache~~</code>		: Variable name: <code>RT_CACHE</code>, value: <code>Z:\rawtherapee\cache</code>
	; Linux and macOS		; Linux and macOS
	: <code>RT_SETTINGS=/home/bob/.config/rawtherapee/4.2</code>		: <code>RT_SETTINGS=/home/bob/.config/rawtherapee/5.7</code>
	: <code>RT_CACHE=/home/bob/junk/rtcache</code>		: <code>RT_CACHE=/home/bob/junk/rtcache</code>

	== Processing Profiles ==		== Processing Profiles ==

	If you create your own [[Sidecar Files - Processing Profiles \| processing profiles]], to have them appear in RawTherapee's "Processing Profiles" list you should save them to the "profiles" folder which you will find inside the "config" folder as described above.		If you create your own [[Sidecar Files - Processing Profiles \| processing profiles]], to have them appear in RawTherapee's "Processing Profiles" list you should save them to the "profiles" folder which you will find inside the "config" folder as described above.

	== Temporary Folder ==		== Temporary Folder ==

	The "[[Edit Current Image in External Editor]]" tool stores intermediate image files in a temporary folder:		The "[[Edit Current Image in External Editor]]" tool stores intermediate image files in a temporary folder:
	; Windows		; Windows

DrSlony: Histograms no longer stored in cache #4904

2018-10-31T17:56:21Z

Histograms no longer stored in cache #4904

← Older revision		Revision as of 17:56, 31 October 2018
Line 33:		Line 33:
	The RawTherapee cache folder contains sets of cached items, where each set consists of:		The RawTherapee cache folder contains sets of cached items, where each set consists of:
	* a thumbnail,		* a thumbnail,
	* a histogram,
	* metadata,		* metadata,
	* a sidecar file,		* a sidecar file,
Line 39:		Line 38:

	By default, RawTherapee keeps up to 20 000 cached sets. Keep an eye on the "cache" folder as over time it may grow considerably in size! This is mostly due to the cached thumbnails which are stored in the "images" sub-folder. Deleting the "images" sub-folder is safe, you will not lose any image settings, RawTherapee will just have to regenerate the thumbnails.		By default, RawTherapee keeps up to 20 000 cached sets. Keep an eye on the "cache" folder as over time it may grow considerably in size! This is mostly due to the cached thumbnails which are stored in the "images" sub-folder. Deleting the "images" sub-folder is safe, you will not lose any image settings, RawTherapee will just have to regenerate the thumbnails.

			A cached set used to include a 32kB histogram file, but as of RawTherapee 5.5 the need for storing the histogram was eliminated.

	Default locations for the RawTherapee cache folder (look for the "RawTherapee*" prefix as described above):		Default locations for the RawTherapee cache folder (look for the "RawTherapee*" prefix as described above):

DrSlony: Updated macOS config and cache paths, https://github.com/Beep6581/RawTherapee/issues/4022#issuecomment-323326472

2017-08-18T15:16:34Z

Updated macOS config and cache paths, https://github.com/Beep6581/RawTherapee/issues/4022#issuecomment-323326472

← Older revision		Revision as of 15:16, 18 August 2017
Line 27:		Line 27:
	: <code>~/.config/</code>		: <code>~/.config/</code>
	; macOS		; macOS
	: <code>~/.config/</code>		: <code>~/Library/Application Support/RawTherapee/config/</code>
	: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.		: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.

Line 48:		Line 48:
	: <code>~/.cache/</code>		: <code>~/.cache/</code>
	; macOS		; macOS
	: <code>~/.cache/</code>		: <code>~/Library/Application Support/RawTherapee/cache/</code>
	: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.		: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.

DrSlony: Updated

2017-08-01T15:13:37Z

Updated

← Older revision		Revision as of 15:13, 1 August 2017
Line 5:		Line 5:
	* RawTherapee'''5-dev'''		* RawTherapee'''5-dev'''
	* RawTherapee'''_test'''		* RawTherapee'''_test'''
	The first part, "RawTherapee", is hard-coded. The second part, the suffix, is up to the person who made the build. It might be specific, like "5.0-gtk2-123-g87654321", it could be general, like "5", it could be anything else, like "_test", or it could be not set. We recommend that RawTherapee stable releases not use ~~one~~ at all, while all development versions use "5-dev" - hopefully the person who made the build you're using took this into account.		* And other possibilities always beginning with "RawTherapee"

			The first part, "RawTherapee", is hard-coded. The second part, the suffix, is up to the person who made the build. It might be specific, like "5.0-gtk2-123-g87654321", it could be general, like "5", it could be anything else, like "_test", or it could be not set. We recommend that RawTherapee stable releases not use a suffix at all, while all development versions use "5-dev" - hopefully the person who made the build you're using took this into account.

	== Config ==		== Config ==
	The "config" folder contains:		The RawTherapee config folder contains:
	* the "options" file, which contains all of your settings from [[Preferences]],		* the "options" file, which contains all of your settings from [[Preferences]],
	* the "batch" folder, which stores temporary [[Sidecar Files - Processing Profiles\|processing profiles]] of the photos you sent to the [[The Batch Queue\|Queue]],		* the "batch" folder, which stores temporary [[Sidecar Files - Processing Profiles\|processing profiles]] of the photos you sent to the [[The Batch Queue\|Queue]],
Line 17:		Line 19:
	You could include this folder in your backups so that you can regain all of your settings and custom processing profiles if you install RawTherapee on a new system.		You could include this folder in your backups so that you can regain all of your settings and custom processing profiles if you install RawTherapee on a new system.

	Default locations for ~~this~~ folder (look for the "RawTherapee*" prefix as described above):		Default locations for the RawTherapee config folder (look for the "RawTherapee*" prefix as described above):
	; ~~"''Config''" in~~ Windows XP		; Windows XP
	: <code>%USERPROFILE%\Local Settings\Application Data\</code>		: <code>%USERPROFILE%\Local Settings\Application Data\</code>
	; ~~"''Config''" in~~ Windows 7, 8 and 10		; Windows 7, 8 and 10
	: <code>%LOCALAPPDATA%\</code>		: <code>%LOCALAPPDATA%</code>
	; ~~"''Config''" in~~ Linux		; Linux
	: <code>~/.config/</code>		: <code>~/.config/</code>
	; ~~"''Config''" in OS X~~		; macOS
	: <code>~/.config/</code>		: <code>~/.config/</code>
	: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.		: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.

	== Cache ==		== Cache ==
	The ~~"''~~cache~~''"~~ folder contains sets of cached items, where each set consists of:		The RawTherapee cache folder contains sets of cached items, where each set consists of:
	* a thumbnail,		* a thumbnail,
	* a histogram,		* a histogram,
Line 38:		Line 40:
	By default, RawTherapee keeps up to 20 000 cached sets. Keep an eye on the "cache" folder as over time it may grow considerably in size! This is mostly due to the cached thumbnails which are stored in the "images" sub-folder. Deleting the "images" sub-folder is safe, you will not lose any image settings, RawTherapee will just have to regenerate the thumbnails.		By default, RawTherapee keeps up to 20 000 cached sets. Keep an eye on the "cache" folder as over time it may grow considerably in size! This is mostly due to the cached thumbnails which are stored in the "images" sub-folder. Deleting the "images" sub-folder is safe, you will not lose any image settings, RawTherapee will just have to regenerate the thumbnails.

	Default locations for ~~this~~ folder (look for the "RawTherapee*" prefix as described above):		Default locations for the RawTherapee cache folder (look for the "RawTherapee*" prefix as described above):
	; ~~"''Cache''" in~~ Windows XP		; Windows XP
	: <code>%USERPROFILE%\Local Settings\Application Data\</code>		: <code>%USERPROFILE%\Local Settings\Application Data\</code>
	; ~~"''Cache''" in~~ Windows 7, 8 and 10		; Windows 7, 8 and 10
	: <code>%LOCALAPPDATA%\</code>		: <code>%LOCALAPPDATA%</code>
	; ~~"''Cache''" in~~ Linux		; Linux
	: <code>~/.cache/</code>		: <code>~/.cache/</code>
	; ~~"''Cache''" in OS X~~		; macOS
	: <code>~/.cache/</code>		: <code>~/.cache/</code>
	: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.		: Under the Finder's 'Go' menu click 'Go to Folder' (shortcut Command+Shift+g), you can then type/paste any path you want to navigate to, even if it's hidden.
Line 56:		Line 58:
	: <code>RT_SETTINGS=%LOCALAPPDATA%\rawtherapee\4.2</code>		: <code>RT_SETTINGS=%LOCALAPPDATA%\rawtherapee\4.2</code>
	: <code>RT_CACHE=C:\Users\Bob\AppData\Local\rtcache</code>		: <code>RT_CACHE=C:\Users\Bob\AppData\Local\rtcache</code>
	; Linux and ~~OS X~~		; Linux and macOS
	: <code>RT_SETTINGS=/home/bob/.config/rawtherapee/4.2</code>		: <code>RT_SETTINGS=/home/bob/.config/rawtherapee/4.2</code>
	: <code>RT_CACHE=/home/bob/junk/rtcache</code>		: <code>RT_CACHE=/home/bob/junk/rtcache</code>
Line 68:		Line 70:
	: The default location is the one stored in the <code>$TEMP</code> environment variable, which is usually <code>%LOCALAPPDATA%/Temp</code>		: The default location is the one stored in the <code>$TEMP</code> environment variable, which is usually <code>%LOCALAPPDATA%/Temp</code>
	: If you do not have the <code>$TEMP</code> environment variable set, <code>C:\</code> is used.		: If you do not have the <code>$TEMP</code> environment variable set, <code>C:\</code> is used.
	; Linux and ~~OS X~~		; Linux and macOS
	: The default location is the one stored in the <code>$TMPDIR</code> environment variable, which is usually <code>/tmp</code>		: The default location is the one stored in the <code>$TMPDIR</code> environment variable, which is usually <code>/tmp</code>
	: If you do not have the <code>$TMPDIR</code> environment variable set, <code>/tmp</code> is used.		: If you do not have the <code>$TMPDIR</code> environment variable set, <code>/tmp</code> is used.

DrSlony: Updated config section with camconst.json, dynamic profiles, etc

2017-05-14T10:05:52Z

Updated config section with camconst.json, dynamic profiles, etc

← Older revision		Revision as of 10:05, 14 May 2017
Line 1:		Line 1:
	RawTherapee makes use of a "cache" folder to store temporary files which are safe to delete, and a "config" folder which stores your RawTherapee settings ~~and saved~~ custom processing profiles. These folders reside in a special place, described below, and have a name that begins with the word "RawTherapee" optionally followed by a suffix. This suffix is set by the person who made the build of RawTherapee you're using. Some examples of what it can look like:		RawTherapee makes use of a "cache" folder to store temporary files which are safe to delete, and a "config" folder which stores your RawTherapee settings, custom processing profiles and other user-editable files. These folders reside in a special place, described below, and have a name that begins with the word "RawTherapee" optionally followed by a suffix. This suffix is set by the person who made the build of RawTherapee you're using. Some examples of what it can look like:
	* RawTherapee		* RawTherapee
	* RawTherapee'''4.2'''		* RawTherapee'''4.2'''
Line 8:		Line 8:

	== Config ==		== Config ==
	The "config" folder contains the "options" file which contains all of your settings from [[Preferences]], the "batch" folder which stores temporary [[Sidecar Files - Processing Profiles\|processing profiles]] of the photos you sent to the [[The Batch Queue\|Queue]], and the "profiles" folder where you can save your custom [[Sidecar Files - Processing Profiles\|processing profiles]] to if you want them to appear in RawTherapee's drop-down list. You could include this folder in your backups so that you can regain all of your settings and custom processing profiles if you install RawTherapee on a new system.		The "config" folder contains:
			* the "options" file, which contains all of your settings from [[Preferences]],
			* the "batch" folder, which stores temporary [[Sidecar Files - Processing Profiles\|processing profiles]] of the photos you sent to the [[The Batch Queue\|Queue]],
			* the user-editable [[Adding Support for New Raw Formats\|camconst.json]] file, where you can define details of how a specific raw format is to be treated (this overrides the values from the system camconst.json file),
			* the [[Dynamic processing profiles\|dynamic profile]] rules,
			* and the "profiles" folder where you can save your custom [[Sidecar Files - Processing Profiles\|processing profiles]] to if you want them to appear in RawTherapee's drop-down list.

			You could include this folder in your backups so that you can regain all of your settings and custom processing profiles if you install RawTherapee on a new system.

	Default locations for this folder (look for the "RawTherapee*" prefix as described above):		Default locations for this folder (look for the "RawTherapee*" prefix as described above):

DrSlony at 00:40, 28 January 2017

2017-01-28T00:40:45Z

← Older revision		Revision as of 00:40, 28 January 2017
Line 1:		Line 1:
	RawTherapee makes use of a "cache" folder to store temporary files which are safe to delete, and a "config" folder which stores your RawTherapee settings and saved custom processing profiles. These folders reside in a special place, described below, and have a name that begins with the word "RawTherapee" optionally followed by a suffix. This suffix is set by the person who made the build of RawTherapee you're using. Some examples of what it can look like:		RawTherapee makes use of a "cache" folder to store temporary files which are safe to delete, and a "config" folder which stores your RawTherapee settings and saved custom processing profiles. These folders reside in a special place, described below, and have a name that begins with the word "RawTherapee" optionally followed by a suffix. This suffix is set by the person who made the build of RawTherapee you're using. Some examples of what it can look like:
	* RawTherapee		* RawTherapee
	* RawTherapee'''4'''
	* RawTherapee'''4.0.12'''
	* RawTherapee'''4.2'''		* RawTherapee'''4.2'''
			* RawTherapee'''5'''
			* RawTherapee'''5-dev'''
	* RawTherapee'''_test'''		* RawTherapee'''_test'''
	The first part, "RawTherapee", is hard-coded. The second part, the suffix, is up to the person who made the build. It might be specific, like "4.0~~.12~~", it could be general, like "4", it could be anything else, like "_test", or it could be not set. ~~Take~~ this into account ~~when looking in the locations specified below~~.		The first part, "RawTherapee", is hard-coded. The second part, the suffix, is up to the person who made the build. It might be specific, like "5.0-gtk2-123-g87654321", it could be general, like "5", it could be anything else, like "_test", or it could be not set. We recommend that RawTherapee stable releases not use one at all, while all development versions use "5-dev" - hopefully the person who made the build you're using took this into account.

	== Config ==		== Config ==

DrSlony: Updated

2017-01-09T21:11:10Z

Updated

← Older revision		Revision as of 21:11, 9 January 2017
Line 22:		Line 22:

	== Cache ==		== Cache ==
	The "''cache''" folder contains cached ~~thumbnails~~, ~~processing profiles~~, metadata and ~~histograms~~.		The "''cache''" folder contains sets of cached items, where each set consists of:
			* a thumbnail,
			* a histogram,
			* metadata,
			* a sidecar file,
			* and optionally an embedded profile.

	Keep an eye on the "cache" folder as over time it may grow considerably in size! This is mostly due to the cached thumbnails which are stored in the "images" sub-folder. Deleting the "images" sub-folder is safe, you will not lose any image settings, RawTherapee will just have to regenerate the thumbnails.		By default, RawTherapee keeps up to 20 000 cached sets. Keep an eye on the "cache" folder as over time it may grow considerably in size! This is mostly due to the cached thumbnails which are stored in the "images" sub-folder. Deleting the "images" sub-folder is safe, you will not lose any image settings, RawTherapee will just have to regenerate the thumbnails.

	Default locations for this folder (look for the "RawTherapee*" prefix as described above):		Default locations for this folder (look for the "RawTherapee*" prefix as described above):