PhotoStructure
  • Features
  • Install
  • Pricing
  • Forum
  • User Guide
  • Docs
  • 🔍
Guides

Guides

In-depth guides and documentation

Photo by Tim W
Malformed EXIF text

Malformed EXIF text

Configure malformed EXIF filtering and MacRoman or Windows-1252 recovery.
How do I access my PhotoStructure library on other computers?

How do I access my PhotoStructure library on other computers?

Learn how to reach PhotoStructure from another computer without confusing network exposure with authentication.
Library users, sign-in, and permissions

Library users, sign-in, and permissions

PhotoStructure will add built-in sign-in and permissions without making the first person who visits your server its owner.
Single sign-on (SSO / OIDC)

Single sign-on (SSO / OIDC)

PhotoStructure will use OpenID Connect to prove identity while keeping library access and roles under the owner's control.
How does PhotoStructure populate the Where tag?

How does PhotoStructure populate the Where tag?

PhotoStructure reverse-geocodes GPS coordinates found in your media's metadata.
How does PhotoStructure populate the Who tag?

How does PhotoStructure populate the Who tag?

PhotoStructure builds the "Who" tag from face metadata written by your camera, photo editor, and other tools.
How does PhotoStructure populate the Albums tag?

How does PhotoStructure populate the Albums tag?

PhotoStructure reads three metadata fields to build the Albums tag hierarchy. This page lists those fields and explains common sources of confusion (like Lightroom CatalogSets).
Linux troubleshooting

Linux troubleshooting

Troubleshooting common PhotoStructure issues on Linux, including frozen file dialogs and health check failures.
Sync reports

Sync reports

Sync reports are JSONL log files that record everything PhotoStructure does during a sync, including the file format, state values, and tips for filtering and analysis.
Where should PhotoStructure look for photos and videos?

Where should PhotoStructure look for photos and videos?

Scan paths tell PhotoStructure which folders to search. Learn how to add, remove, and configure them.
Family hierarchies: how PhotoStructure parses names

Family hierarchies: how PhotoStructure parses names

Complete guide to configuring PhotoStructure's name parsing engine, including formatters, name order, multi-word names, and international naming conventions.
What are "Library metrics"?

What are "Library metrics"?

Explanation of PhotoStructure's library metrics including assets, image files, and video files displayed on the about page.
How PhotoStructure copies your files

How PhotoStructure copies your files

Learn about PhotoStructure's file copy strategies, including automatic detection, reflink support for copy-on-write filesystems, and solutions for TrueNAS/ZFS permission errors.
How to scan software with VirusTotal

How to scan software with VirusTotal

Learn how to use VirusTotal to scan software for malware and understand false positives when downloading and installing applications.
How to archive, remove, and delete photos and videos in your PhotoStructure library

How to archive, remove, and delete photos and videos in your PhotoStructure library

Learn the differences between archiving, removing, and deleting photos and videos in PhotoStructure v2.0, including how to hide, exclude, and permanently delete files.
What's a hierarchical tag?

What's a hierarchical tag?

PhotoStructure uses hierarchical tags that support inheritance and relationships, allowing for more expressive organization than flat tagging systems.
How to import Google Photos into PhotoStructure

How to import Google Photos into PhotoStructure

Complete guide for importing your Google Photos collection into PhotoStructure using Google Takeout archives.
How to search your PhotoStructure library

How to search your PhotoStructure library

Guide to PhotoStructure's search functionality including filters, operators, and advanced search syntax for finding photos and videos.
How does PhotoStructure capture captured-at?

How does PhotoStructure capture captured-at?

Learn how PhotoStructure determines when photos and videos were captured using metadata, filenames, and advanced heuristics.
DAMs, systems of record, and how PhotoStructure plays well with others

DAMs, systems of record, and how PhotoStructure plays well with others

Explains how PhotoStructure works as a friendly sidekick to other photo management apps by never assuming it's the system of record and gracefully handling external changes.
How do I safely store my files?

How do I safely store my files?

Learn how to safely store digital files using multiple copies, different storage formats, and modern NAS systems with data integrity features to prevent data loss.
PhotoStructure log files

PhotoStructure log files

PhotoStructure's Logs page lets you browse, filter, and download logs from the web UI. This page also covers log levels, log locations, and how to collect and send logs for troubleshooting.
What are error reports?

What are error reports?

Error reporting is opt-in. If you enable it, reports include system information and error context, never your actual photos or videos.
Library syncing vs rebuilds

Library syncing vs rebuilds

Comparison between library syncing (filesystem updates) and rebuilds (database updates), explaining when and how each process runs.
Using environment variables with PhotoStructure

Using environment variables with PhotoStructure

Complete guide to configuring PhotoStructure settings using environment variables, including format examples, platform-specific instructions, and .env file support.
Windows troubleshooting

Windows troubleshooting

Troubleshooting guide for common PhotoStructure issues on Windows, including firewall problems, antivirus conflicts, and network share issues.
RAID is not a backup

RAID is not a backup

Explains why RAID provides data redundancy but isn't a substitute for proper backups, covering human errors, malware, hardware failures, and other risks.
What do you mean by "deduplicate"?

What do you mean by "deduplicate"?

Explanation of PhotoStructure's deduplication process, including how it handles RAW+JPEG pairs, cloud backups, and file variations while determining the "best" version to display.
What's a "volume?"

What's a "volume?"

Guide to PhotoStructure's volume management system, including UUID handling, stable file references, and troubleshooting volume identification issues.
Why is PhotoStructure rebuilding my library?

Why is PhotoStructure rebuilding my library?

Explanation of library rebuilds when upgrading PhotoStructure versions, covering the process of updating metadata, regrouping assets, and refreshing previews.
How does PhotoStructure extract keywords from my photos and videos?

How does PhotoStructure extract keywords from my photos and videos?

Detailed explanation of how PhotoStructure extracts keywords from metadata, sidecars, and file paths, including hierarchical tagging support.
Why didn't my file get imported into my Library?

Why didn't my file get imported into my Library?

Troubleshooting guide explaining PhotoStructure's file filters and common reasons why photos or videos might not be imported into your library.
How do I change my library?

How do I change my library?

Instructions for changing PhotoStructure library locations and moving existing libraries to new drives safely.
How to uninstall PhotoStructure

How to uninstall PhotoStructure

Step-by-step instructions for completely removing PhotoStructure from your system, including all data and settings.
How do I start and stop PhotoStructure?

How do I start and stop PhotoStructure?

Step-by-step instructions for launching and shutting down PhotoStructure on macOS, Windows, and Ubuntu, including why shutdown takes time.
PhotoStructure

PhotoStructure is a personal digital asset manager designed to make organizing, browsing, and sharing a lifetime of photos and videos effortless and fun.

Product

  • Install
  • Pricing
  • Why PhotoStructure?
  • What’s new

Learn

  • User Guide
  • FAQ
  • Docs
  • Release notes

Community

  • Forum
  • Discord
  • GitHub
  • Email

Legal

  • Terms
  • Privacy
  • EULA

© 2017–2026 PhotoStructure, Inc. PhotoStructure® is a registered trademark of PhotoStructure, Inc. (U.S. Reg. No. 8,272,183).

PhotoStructure
  • Features
  • Install
  • Pricing
  • Forum
  • User Guide
  • Docs
  • 🔍 Search
Related
  • Corrupt installation
  • Corrupt library database
  • Crashes and segfaults
  • File permissions
  • Out of memory
  • Port already in use
  • Search PhotoStructure Documentation
  • Too many open files