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.
A couple things to remember #
- PhotoStructure should be shut down before you edit settings to prevent PhotoStructure from erasing your changes.
- 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 send us an email.
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
true, change this:
# Write an access log for all web requests? # # logWebRequests = false
# Write an access log for all web requests? # logWebRequests = true