PhotoStructure settings

<%= planSection.title %>

<% if (locals.subNetworkAccessDisabled && locals.subRenewalStatus !== "current") { %>

PhotoStructure is configured not to use the network, so your license can’t renew or activate.

<% } %> <% if (locals.subRenewalStatus === "pending" && locals.subRenewalPaymentRequired) { %>

PhotoStructure couldn’t renew because your account needs billing attention. <% if (!locals.subNetworkAccessDisabled) { %> <% if (locals.subAutomaticRenewalEnabled) { %> The next automatic attempt is scheduled after <%= locals.subRenewalRetryAt %>. <% } else { %> You can retry after <%= locals.subRenewalRetryAt %>. <% } %> <% } %>

Update billing. <% if (!locals.subNetworkAccessDisabled && locals.subAutomaticRenewalEnabled) { %> PhotoStructure will retry automatically afterward. <% } else { %> <% if (locals.subRenewalRetryUrl) { %> Retry renewal, or re-enable automatic renewal. <% } else if (!locals.subNetworkAccessDisabled) { %> Return after <%= locals.subRenewalRetryAt %> to retry, or re-enable automatic renewal. <% } %> <% } %>

<% } else { %> <% if (!locals.subNetworkAccessDisabled && locals.subRenewalStatus === "reactivation_required") { %>

Your saved license doesn’t match this installation.

Reactivate this installation

<% } else if (!locals.subNetworkAccessDisabled && locals.subRenewalStatus === "pending" && !locals.subAutomaticRenewalEnabled) { %>

License renewal is pending, but automatic renewal is disabled.

<% if (locals.subRenewalRetryUrl) { %> Retry renewal, or re-enable automatic renewal. <% } else if (locals.subRenewalRetryAt) { %> Return after <%= locals.subRenewalRetryAt %> to retry, or re-enable automatic renewal. <% } else { %> Re-enable automatic renewal. <% } %>

<% } %> <% if (!locals.subNetworkAccessDisabled && locals.subNeedsActivation) { %>

Activate this installation so your plus license can renew automatically.

<% } %> <% if (locals.subTier === "lite") { %>

You're using PhotoStructure <%= locals.subTier %>.

<% if (locals.subRenewalStatus) { %>

Your plus license isn’t currently active.

<% } else if (!locals.subNetworkAccessDisabled) { %>

PhotoStructure plus keeps your photos safe by validating and organizing them automatically, and helps fund future development.

Start your 15 day free trial of plus today

No credit card required.

Already a subscriber? Log in to re-activate your license

<% } %> <% } else if (locals.subLifetime) { %>

Your PhotoStructure Lifetime plan keeps this installation on plus.

<% } else if (locals.subTrial) { %>

plus trial<% if (locals.subExpiresAt) { %> — expires <%= locals.subExpiresAt %><% } %>.

Manage subscription

<% } else { %>

Your plus subscription keeps PhotoStructure going!

<% if (locals.subExpiresAt) { %>

Your subscription renews or expires <%= locals.subExpiresAt %>.

<% } %>

Manage subscription

<% } %> <% } %>

<% if (locals.isDocker) { %> <% if (locals.currentLibraryDir) { %>

Your library is <%= locals.currentLibraryDir %>.<% if (locals.currentLibraryLastOpened) { %> <%= locals.currentLibraryLastOpened %><% } %>

On Docker, your library's location is part of your container's configuration, so it can't be changed from this page. To use a different folder, update the container's /ps/library bind mount (or its PS_LIBRARY_DIR environment variable) and restart the container.

How to change your library's location on Docker

<% } else { %>

PhotoStructure can't find your library. On Docker, your library's location comes from your container's configuration: bind-mount your library folder to /ps/library, or set PS_LIBRARY_DIR to a folder that exists inside the container, and restart it.

How to change your library's location on Docker

<% } %> <% } else if (locals.welcome) { %>

Your PhotoStructure Library holds

a metadata database of your photos and videos,
web-safe previews of your images and videos,
and, if you enable automatic organization, a copy of all your original photos and videos.

A couple more things to note:

This folder must have lots of free space.
This can be an existing directory, with existing photos and videos.
PhotoStructure always scans your library folder for photos and videos.

<% } else { %>

Your PhotoStructure Library is currently <%= locals.currentLibraryDir %><% if (locals.currentLibraryLastOpened) { %>. <%= locals.currentLibraryLastOpened %><% } %>

Changing your library location closes your current library and either creates or opens a library in your new folder.

Prior library contents will not be copied over unless you import your prior library folder.

<% } %> <% if (!locals.isDocker) { %> <%- include('_setting-override', { settingName: 'libraryDir', override: locals.settingOverrides.libraryDir }) %> <% } %> <% if (!locals.isDocker && locals.settingOverrides.libraryDir == null) { %> <% if (locals.suggestedLibraryDirs) { %> <% locals.suggestedLibraryDirs.forEach((ea, index) => { %>

/>

<%- ea.wbrPath %>

<% if (ea.isCurrentLibrary) { %>

This is your current PhotoStructure library.

<% } else if (ea.isLibrary) { %>

This is a PhotoStructure library.

<% } %> <% if (ea.lastOpenedLabel) { %>

<%= ea.lastOpenedLabel %>

<% } %>

(<%= ea.free %> available<% if (ea.label) { %> on <%= ea.label %><% } %><% if (ea.remote) { %> on <%= ea.remoteShare %>@<%= ea.remoteHost %><% } %>)

<% }) %> <% } else { %>

No library folders were suggested automatically. Enter a writable custom library directory on a volume with at least <%= locals.minFreeAvailable %> free disk space.

<% } %>

Back Next

<%= scanSection.title %>

<% if (locals.isDocker) { %>

Checking all volumes is recommended for most Docker setups. This looks for photos and videos in all directories mounted into the container (via -v or volumes: in your compose file)—no need to list them individually!

<% } %>

PhotoStructure looks for photos and videos in this order:

Your library folder (always included)
Any paths you've added below
If enabled, all remaining volumes

PhotoStructure automatically ignores hidden, system, application, and NoMedia directories.

Changing these settings won't remove photos already in your library.

Learn more about scan paths.

Your library folder is always included. You can check all volumes, add specific paths, or both.

<%- include('_setting-override', { settingName: 'scanAllDrives', override: locals.settingOverrides.scanAllDrives }) %> <%= locals.settingOverrides.scanAllDrives != null ? 'disabled' : '' %> /> Look in all volumes for photos and videos <% if (locals.isDocker) { %> (recommended — why?) <% } %> <% if (locals.welcome && locals.isElectron && locals.isMac) { %>

Choose specific folders below to avoid broad macOS permission requests. If you enable all volumes, PhotoStructure will request access before synchronization starts.

<% } %> <%- include('_setting-override', { settingName: 'scanPaths', override: locals.settingOverrides.scanPaths }) %>

> Additional places to look:

<% if (!locals.isDocker) { %> <% if (!(locals.isElectron && locals.isMac)) { %> <% } %> <% } %>

Back Next

<%= organizationSection.title %>

PhotoStructure can copy the photos and videos it finds into your PhotoStructure Library. This is ideal if your photos are scattered across several drives, you might have duplicates, and you'd really like everything to be organized into one, tidy place.

PhotoStructure will de-duplicate photos and videos automatically. Learn more.
Photos and videos already found in your library will remain in their current location
New photos and videos will be copied into date-stamped folders

If you don't have an active PhotoStructure plus subscription:

this setting is ignored: PhotoStructure won't copy new files into your library.
Existing files in your library will remain in their current location.

Copy my photos and videos into my PhotoStructure library when I have an active plus subscription.

<%- include('_setting-override', { settingName: 'originalsDir', override: locals.settingOverrides.originalsDir, beforeValue: originalsDirCopyLead, afterValue: originalsDirCopyAfterValue, afterSource: '.' }) %> <%- include('_setting-override', { settingName: 'copyAssetsToLibrary', override: locals.settingOverrides.copyAssetsToLibrary }) %>

<%= locals.settingOverrides.copyAssetsToLibrary != null ? 'disabled' : '' %> /> Yes, please

<%= locals.settingOverrides.copyAssetsToLibrary != null ? 'disabled' : '' %> /> No thanks, I like my photos and videos where they already are.

Back Next

<%= privacySection.title %>

Installation information

When PhotoStructure checks for updates, is it OK to share basic information about your installation?

If enabled, your library will send a User-Agent that includes basic information about your installation. This includes your current PhotoStructure edition, version, operating system, and your subscription state. Yours looks like this:

<%= locals.userAgent %>

If disabled, the User-Agent will just be PhotoStructure.

This information in aggregate is used to help prioritize platform and feature support. It is not sold or shared for marketing or advertising.

Learn more about PhotoStructure updates.

<%- include('_setting-override', { settingName: 'allowUserAgent', override: locals.settingOverrides.allowUserAgent }) %>

<%= locals.settingOverrides.allowUserAgent != null || locals.externalRequestsDisabledSource != null ? 'disabled' : '' %> /> Yes, PhotoStructure may share installation information with PhotoStructure, Inc.

<%= locals.settingOverrides.allowUserAgent != null || locals.externalRequestsDisabledSource != null ? 'disabled' : '' %> /> No thanks, do not share any installation information.

Error reports

PhotoStructure's error reports help us detect, triage, and fix issues. Learn more.

<%- include('_setting-override', { settingName: 'reportErrors', override: locals.settingOverrides.reportErrors }) %>

<%= locals.settingOverrides.reportErrors != null || locals.externalRequestsDisabledSource != null ? 'disabled' : '' %> /> Yes, PhotoStructure may report unexpected errors.

<%= locals.settingOverrides.reportErrors != null || locals.externalRequestsDisabledSource != null ? 'disabled' : '' %> /> No thanks, do not send any error reports.

Back Next

<%= advancedSummary %>

<%= aggregationSection.title %>

When PhotoStructure decides that two or more files represent the same photo or video, it groups them together in the user interface to make your browsing easier. This decision is made after examining both image content as well as metadata like the captured-at time and exposure information.

Strict: Group only very close matches. More copies of the same photo may appear separately.
Default: Group typical copies and resized versions. Dates and other photo details help keep different shots apart.
Lenient: Allow larger differences, such as color edits or changed dates. This can also group different photos that look alike. If you have backups from Google Photos and other cloud services that modified your originals, pick this option.

<% if (locals.aggregationModeOptions.some(option => option.value === 'manual')) { %>

Manual uses the custom matching rules saved for this library. Leave it selected to keep your current rules.

<% } %>

Changing this setting checks your existing photos and videos again. Larger libraries take longer to finish.

<%= previewSection.title %>

PhotoStructure uses previews (smaller copies) of your photos and videos so your library loads quickly.

<%# This range is measured, not estimated. Watch the denominator: one video notch on examples/ is +56% of total preview disk, but 2x the MP4 bytes alone (135.6 vs 67.5 MB) -- see _done/20260710-preview-resolution-settings.md. Re-measured across all three sliders 2026-08-12. Re-measure before narrowing it. %>

Moving any slider one notch to the right uses more preview disk space — 10% more in some libraries, twice as much in others.

Changing any of these values rebuilds your preview cache the next time sync runs. Current previews keep working until their replacements are ready, but large libraries may take several days.

Your original photos and videos are never changed. Each preview fits inside the size you pick, and a small photo is never blown up to fill a larger one.

PhotoStructure keeps a few sizes of each photo and video: small ones for the gallery, larger ones for when you open something. Browsing previews sets how many in-between sizes are kept, and how sharp the gallery thumbnails look.

Sizes up to 1440p are kept for both tall and wide screens. 4K and larger are kept for wide screens only.

For real-world numbers, see how much disk space PhotoStructure needs.

<% if (locals.previewSavedValues.length > 0) { %>

Currently saved settings.toml

<%= saved.label %>: <%= saved.value %>

<% } %>

📷 Photo size

Set this to the highest-resolution display you’ll use to browse your library.

<%- include('_setting-override', { settingName: 'photoPreviewFitInside', override: locals.settingOverrides.photoPreviewFitInside }) %>

/>

<% for (const [index, option] of locals.photoPreviewResolutionOptions.entries()) { %> <% } %>

🎬 Video size

This sets both the still frame shown before a video starts and the video PhotoStructure prepares for playback. Videos your browser can play directly stream at their original size.

<%- include('_setting-override', { settingName: 'videoPreviewFitInside', override: locals.settingOverrides.videoPreviewFitInside }) %>

/>

<% for (const [index, option] of locals.videoPreviewResolutionOptions.entries()) { %> <% } %>

🏄 Browsing previews

Choose how much preview disk space PhotoStructure uses to keep gallery thumbnails sharp and browsing responsive.

<%- include('_setting-override', { settingName: 'previewCacheProfile', override: locals.settingOverrides.previewCacheProfile }) %> <% if (locals.previewPixelWastePctOverrideSource) { %>

<%= locals.previewPixelWastePctOverrideSource %> sets the advanced previewPixelWastePct setting to <%= locals.previewPixelWastePct %>%, which overrides part of this profile.

<% } %> <% if (locals.maxThumbnailLongEdgeOverrideSource) { %>

<%= locals.maxThumbnailLongEdgeOverrideSource %> sets the advanced maxThumbnailLongEdge setting to <%= locals.maxThumbnailLongEdge %> px, which overrides part of this profile.

<% } %>

/>

<% for (const [index, option] of locals.previewCacheProfileOptions.entries()) { %> <% } %>

<% for (const [index, option] of locals.photoPreviewResolutionOptions.entries()) { %> <% } %> <% for (const [index, option] of locals.videoPreviewResolutionOptions.entries()) { %> <% } %>

Back Next

<%= updatesSection.title %>

<%- include('_setting-override', { settingName: 'autoUpdateCheck', override: locals.settingOverrides.autoUpdateCheck }) %>

Learn more about PhotoStructure updates.

<%= locals.settingOverrides.autoUpdateCheck != null || locals.externalRequestsDisabledSource != null ? 'disabled' : '' %> /> Yes, PhotoStructure may check for updates automatically

<%= locals.settingOverrides.autoUpdateCheck != null || locals.externalRequestsDisabledSource != null ? 'disabled' : '' %> /> No thanks, do not check for updates automatically

Update channel

<%- include('_setting-override', { settingName: 'updateChannel', override: locals.settingOverrides.updateChannel }) %>

<%= locals.settingOverrides.updateChannel != null ? 'disabled' : '' %> /> beta — newer features, may have bugs

<%= locals.settingOverrides.updateChannel != null ? 'disabled' : '' %> /> stable — may have fewer bugs

Back Next

<%= loggingSection.title %>

Log detail level

<%- include('_setting-override', { settingName: 'logLevel', override: locals.settingOverrides.logLevel }) %>

<%= locals.settingOverrides.logLevel != null ? 'disabled' : '' %> /> fatal — critical failures only

<%= locals.settingOverrides.logLevel != null ? 'disabled' : '' %> /> error — errors only

<%= locals.settingOverrides.logLevel != null ? 'disabled' : '' %> /> warn — recommended

<%= locals.settingOverrides.logLevel != null ? 'disabled' : '' %> /> info — more detail

<%= locals.settingOverrides.logLevel != null ? 'disabled' : '' %> /> debug — very verbose, impacts performance

Back Next

<%= licenseSection.title %>

<% if (locals.welcome) { %>

<%- include('eula.html') %>

<% } else { %>

<%- include('eula.html') %>

<% } %> <% if (locals.welcome) { %>

By clicking Start you agree to all terms of this license.

<% } %>

Back

<%= planSection.title %>

<%= librarySection.title %>

<%= scanSection.title %>

<%= organizationSection.title %>

<%= privacySection.title %>

Installation information

Error reports

<%= aggregationSection.title %>

<%= previewSection.title %>

<%= updatesSection.title %>

Update channel

<%= loggingSection.title %>

Log detail level

<%= licenseSection.title %>

Saving...