PhotoStructure’s settings page is simple and only offers a handful of configuration options.
There are many configurable settings within PhotoStructure, though, including:
how “nice” PhotoStructure is with your system’s CPU: should it auto-pause imports if CPU exceeds 75% (which is the default), or is it running on a server, and can use 100% of the CPU?
is it OK to send error reports? (this defaults to true, but you can opt-out of sending error reports via this setting)
what sizes of preview images should be generated during import?
should we transcode videos on import?
Note that PhotoStructure uses two settings files: “system settings,” and “library settings,” which is a requirement for PhotoStructure libraries to be portable across computers.
System settings #
System settings are specific to a computer. Examples include what paths to scan, where to save logfiles, and what percent of the CPU can be used during imports.
The system settings will be found in your PhotoStructure application settings directory.
Library settings #
Library settings are specific to your library. Most settings are library settings. Examples include what preview image sizes to create, what pattern to use for automatic organization, and what taggers should be enabled during imports.
The library settings will be found in
(your library directory)
/.photostructure/settings.toml. Note that the
.photostructure directory in your library will be hidden. If you don’t see
On macOS, hold down
⌘and shiftthen touch .(the period key).
On Windows, click File > “Change folder and search options”. Select the View tab. In Advanced Settings > Hidden files and folders, select “Show hidden files, folders, and drives”. Click OK.
On Ubuntu, click the hamburger menu in the titlebar and select “Show Hidden Files”.
A couple things to note #
PhotoStructure should be shut down before you edit settings.
The settings files will only exist on your system after you’ve installed PhotoStructure and clicked “Start” on the welcome page.
If you’d like to see a comprehensive list of settings, see
Automatic upgrades #
New versions of PhotoStructure frequently add new system or library settings.
PhotoStructure upgrades your
Prior settings files are archived in a backup directory.
Custom values are retained, but any comments you may have added will not be preserved.
Editing TOML #
The settings files are formatted as TOML, but you only need to know a couple things:
Lines that start with a
#are comments, and ignored
Every OS has a text editor that can edit these files. TextEdit on macOS and Notepad on Windows work just fine.
Most settings have reasonable defaults, which are provided after the description. Remove the
#from the beginning of the line with the default to override.
So, for example, to change the
logWebRequests system setting to
# Write an access log for all web requests? # # logWebRequests = false
to this (note the “# " has been deleted, and “false” was changed to “true”):
# Write an access log for all web requests? # logWebRequests = true