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).

There are 2 different settings files for PhotoStructure:

  1. a system settings file, which is for configuration that will be specific to your computer, and
  2. a library settings file, which is for configuration specific to your library.

The system settings will be found in your PhotoStructure application settings directory.

  • Linux: ~/.config/PhotoStructure/settings.toml
  • macOS: ~/Library/Application Support/PhotoStructure/settings.toml
  • Windows: %APPDATA%\PhotoStructure\settings.toml

The library settings will be found in <your library directory>/.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:

  1. Lines that start with a # are comments, and ignored
  2. Every OS has a text editor that can edit these files. TextEdit on macOS and Notepad on Windows work just fine.
  3. 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

to this:

# Write an access log for all web requests?
logWebRequests = true