PhotoStructure’s settings page is pretty simple (by design), and only offers a handful of configuration options.
There are more than 60 configurable settings within PhotoStructure, though, including
- determining which sizes of preview images to generate during import
- 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 via this setting)
- enabling or disabling video transcoding (transcoding is enabled by default).
Note that there are 2 different files that store PhotoStructure settings.
- A system settings file, which is for configuration that will be specific to your computer, and
- A library settings file, which is for configuration specific to your library.
System settings #
The system settings will be found in your PhotoStructure application settings directory.
Library Settings #
The library settings will be found in
/.photostructure/settings.toml. Note that the
.photostructure directory will be hidden. If you don’t see this directory:
On macOS, hit command-shift-period
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 remember #
- PhotoStructure should be shut down before you edit settings to prevent PhotoStructure from erasing your changes on shutdown.
- The settings files will only exist on your system after you’ve installed PhotoStructure and clicked “Start” on the welcome page.
- PhotoStructure backs up your settings in the same directory, if you want to see what’s changed.
- New versions of PhotoStructure may add or remove settings. Your settings files are automatically upgraded to include all settings, including when defaults change.
- All settings are described in the file itself, including valid values. If you’re not sure what something does, please email [email protected].
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