# PhotoStructure

> Your new home for all your photos and videos

https://photostructure.com/

## Documentation

- [Install PhotoStructure](https://photostructure.com/install/index.md): Download and install PhotoStructure for Windows, macOS, Linux, Docker, or Node.js.
- [PhotoStructure for Servers](https://photostructure.com/server/photostructure-for-servers/index.md): Run PhotoStructure with Docker or directly with Node.js and npx.
- [PhotoStructure user guide](https://photostructure.com/getting-started/user-guide/index.md): User guide and documentation roadmap for PhotoStructure, providing organized links to installation guides, setup …
- [Why should I use PhotoStructure?](https://photostructure.com/about/why-photostructure/index.md): Why PhotoStructure? You own your photos, it runs anywhere, respects your privacy, and is built to last decades.
- [What is a “PhotoStructure library”?](https://photostructure.com/guide/library/index.md): Learn about your PhotoStructure library.
- [Introducing: PhotoStructure!](https://photostructure.com/about/introducing-photostructure/index.md): Learn why we're building PhotoStructure.
- [Docker Compose Wizard](https://photostructure.com/server/docker-compose-wizard/index.md): Interactive Docker Compose wizard for PhotoStructure
- [PhotoStructure pricing](https://photostructure.com/about/pricing/index.md): Compare PhotoStructure LITE and PLUS plans, pricing details, billing information, and subscription policies for …
- [PhotoStructure for Node](https://photostructure.com/server/photostructure-for-node/index.md): Instructions for installing PhotoStructure for Node
- [PhotoStructure for Docker](https://photostructure.com/server/photostructure-for-docker/index.md): Docker reference: system requirements, bind mounts, PUID/PGID, networking, Synology, and more
- [Photo and video import tools](https://photostructure.com/getting-started/media-codec-support/index.md): What PhotoStructure installs to import videos and phone photos, and how to install those tools yourself.
- [PhotoStructure for systemd](https://photostructure.com/server/systemd/index.md): Interactive systemd service file generator for PhotoStructure for Node
- [Add PhotoStructure to your home screen](https://photostructure.com/getting-started/add-to-home-screen/index.md): Install PhotoStructure as an app on your iPhone, iPad, or Android device for a full-screen, app-like experience.
- [PhotoStructure v2026.10](https://photostructure.com/about/v2026.10/index.md): PhotoStructure v2026.10 release notes
- [PhotoStructure vNext](https://photostructure.com/about/vnext/index.md): PhotoStructure unreleased notes
- [PhotoStructure on TrueNAS](https://photostructure.com/server/photostructure-for-truenas/index.md): Install PhotoStructure from the TrueNAS app catalog
- [What is browser renewal?](https://photostructure.com/guide/browser-renewal/index.md): Preview of planned browser-based PLUS license renewal for libraries with noNetwork enabled.
- [PhotoStructure v2026.9](https://photostructure.com/about/v2026.9/index.md): PhotoStructure v2026.9 release notes
- [Import metadata from Apple Photos libraries](https://photostructure.com/guide/apple-photos/index.md): Import albums, named people, keywords, and other metadata from Apple Photos, with instructions for library access and …
- [Less yakking, more doing](https://photostructure.com/coding/less-yakking-more-doing/index.md): Communication and scope rules from my CLAUDE.md: fewer rehearsed apologies, concrete claims, no unasked-for code, and an …
- [PhotoStructure v2026.8](https://photostructure.com/about/v2026.8/index.md): PhotoStructure v2026.8 release notes
- [How PhotoStructure stores file locations](https://photostructure.com/guide/file-uris/index.md): What pslib, psfile, and psnet file URIs mean, and how PhotoStructure resolves them on each computer.
- [Malformed EXIF text](https://photostructure.com/guide/malformed-exif-text/index.md): How PhotoStructure rejects damaged EXIF labels and recovers legacy text encodings
- [How do I access my PhotoStructure library on other computers?](https://photostructure.com/guide/remote-access/index.md): Learn how to reach PhotoStructure from another computer without confusing network exposure with authentication.
- [Library users, sign-in, and permissions](https://photostructure.com/guide/user-accounts/index.md): Set up email-code sign-in, OIDC, or access without sign-in in the upcoming PhotoStructure beta, and recover a paused library.
- [Single sign-on (SSO / OIDC)](https://photostructure.com/guide/single-sign-on/index.md): Configure OpenID Connect sign-in for the upcoming PhotoStructure beta, link verified member accounts, and recover access locally.
- [Commit like a librarian.](https://photostructure.com/coding/clean-commits/index.md): Coding agents leave working trees full of interleaved changes, and git add -A turns them into megacommits nobody can …
- [Serendipity, or how I stopped being bored with my own photos](https://photostructure.com/about/random-samples/index.md): The design story behind PhotoStructure's random samples and hierarchical tags.
- [PhotoStructure v2026.4](https://photostructure.com/about/v2026.4/index.md): PhotoStructure v2026.4 release notes
- [Claude Code has amnesia. So do PRs, changelogs, and your future self.](https://photostructure.com/coding/claude-code-tpp/index.md): Technical Project Plans (TPPs) are living docs that brief four readers: the next session (when context runs out), the PR …
- [How does PhotoStructure populate the Where tag?](https://photostructure.com/guide/places/index.md): How PhotoStructure builds the Where tag from GPS coordinates and location metadata
- [How does PhotoStructure populate the Who tag?](https://photostructure.com/guide/people/index.md): How PhotoStructure extracts people from face regions, Google Takeout, and metadata
- [How does PhotoStructure populate the Albums tag?](https://photostructure.com/guide/albums/index.md): How PhotoStructure extracts albums from EXIF, XMP, and Google Takeout metadata
- [Linux troubleshooting](https://photostructure.com/guide/linux-troubleshooting/index.md): Troubleshooting common PhotoStructure issues on Linux, including frozen file dialogs and health check failures.
- [Sync reports](https://photostructure.com/guide/sync-reports/index.md): PhotoStructure's sync reports: what they contain, where to find them, and how to use them for troubleshooting.
- [Where should PhotoStructure look for photos and videos?](https://photostructure.com/guide/scan-paths/index.md): How PhotoStructure finds your photos and videos, plus configuration options.
- [Claude picks the first idea that works. Make it pick the best one.](https://photostructure.com/coding/claude-code-replan/index.md): Coding agents plan by picking the first reasonable approach and running with it. Replan is a skill that forces iterative …
- [Most AI code reviews are noise. Here's how to fix that.](https://photostructure.com/coding/claude-code-review/index.md): AI code review defaults to a wall of style nitpicks and speculative concerns. A skill that demands proof before …
- [Family hierarchies: how PhotoStructure parses names](https://photostructure.com/guide/name-parsing/index.md): Configure how PhotoStructure parses face tag names into hierarchical "Who" tags
- [The LLM sycophancy antidote](https://photostructure.com/coding/you-are-absolutely-right/index.md): A dead-simple trick to make LLMs actually push back on your ideas instead of cheerfully agreeing with everything you …
- [PhotoStructure on Raspberry Pi](https://photostructure.com/server/photostructure-for-rpi/index.md): Instructions for installing PhotoStructure on Raspberry Pi
- [Temperature Monitoring on Linux](https://photostructure.com/server/temperature-monitoring/index.md): How to set up hardware temperature monitoring for PhotoStructure on Linux, including lm-sensors, hwmon, thermal zones, and drive temperatures.
- [PhotoStructure v2026.2](https://photostructure.com/about/v2026.2/index.md): PhotoStructure v2026.2 release notes
- [Serve AI-readable Markdown from Hugo](https://photostructure.com/coding/hugo-markdown-output/index.md): Build clean Markdown alongside Hugo’s HTML, advertise it to agents, and negotiate text/markdown from each page’s …
- [Custom status lines for Claude Code](https://photostructure.com/coding/claude-code-statusline/index.md): Claude Code can display a persistent status line at the bottom of your terminal. Here’s how to configure one that shows …
- [What are "Library metrics"?](https://photostructure.com/guide/metrics/index.md): Explanation of PhotoStructure’s library metrics including assets, image files, and video files displayed on the about …
- [How PhotoStructure copies your files](https://photostructure.com/guide/file-copy-strategies/index.md): How PhotoStructure copies files to your library, and how to troubleshoot copy failures on TrueNAS/ZFS and other NAS systems.
- [PhotoStructure v2026.1](https://photostructure.com/about/v2026.1/index.md): PhotoStructure v2026.1 release notes
- [2026 PhotoStructure release notes](https://photostructure.com/about/2026-release-notes/index.md): Release notes for PhotoStructure
- [2025 PhotoStructure release notes](https://photostructure.com/about/2025-release-notes/index.md): Release notes for PhotoStructure in 2025
- [How to VACUUM SQLite in WAL Mode (and why you need a checkpoint)](https://photostructure.com/coding/how-to-vacuum-sqlite/index.md): In WAL mode, VACUUM doesn’t shrink your database—it writes changes to the WAL file. Without a checkpoint afterward, …
- [Fix "Exit handler never called" with Node 22.5.0](https://photostructure.com/coding/node-22-exit-handler-never-called/index.md): Troubleshooting guide for resolving the “Exit handler never called” error in Node.js 22.5.0 that was breaking npm …
- [PhotoStructure v2024.3](https://photostructure.com/about/v2024.3/index.md): Find out what's in PhotoStructure version 2024.3
- [2024 PhotoStructure release notes](https://photostructure.com/about/2024-release-notes/index.md): Release notes for PhotoStructure
- [2023 PhotoStructure release notes](https://photostructure.com/about/2023-release-notes/index.md): Release notes for PhotoStructure
- [Set up Wake-on-LAN with systemd](https://photostructure.com/coding/wake-on-lan/index.md): Step-by-step guide to configuring Wake-on-LAN functionality with systemd on Linux systems to remotely power on suspended …
- [2022 PhotoStructure release notes](https://photostructure.com/about/2022-release-notes/index.md): Release notes for PhotoStructure
- [How to scan software with VirusTotal](https://photostructure.com/guide/scan-for-viruses/index.md): Learn how to use VirusTotal to scan software for malware and understand false positives when downloading and installing …
- [2021 PhotoStructure release notes](https://photostructure.com/about/2021-release-notes/index.md): Release notes for PhotoStructure
- [How to archive, remove, and delete photos and videos in your PhotoStructure library](https://photostructure.com/guide/archive-remove-delete/index.md): Learn the differences between archiving, removing, and deleting photos and videos in PhotoStructure v2.0, including how …
- [What's a hierarchical tag?](https://photostructure.com/guide/whats-a-hierarchical-tag/index.md): Find out how PhotoStructure's tags are different from most other systems
- [How to import Google Photos into PhotoStructure](https://photostructure.com/guide/takeout/index.md): Complete guide for importing your Google Photos collection into PhotoStructure using Google Takeout archives.
- [PhotoStructure v1.0](https://photostructure.com/about/v1.0/index.md): Find out what's in PhotoStructure version 1.0
- [PhotoStructure Subscription and Cancellation Terms](https://photostructure.com/legal/subscription-terms/index.md): Detailed terms for PhotoStructure subscriptions including billing cycles, trial periods, cancellation policies, and fee …
- [PhotoStructure’s Privacy Policy](https://photostructure.com/legal/privacy/index.md): PhotoStructure’s privacy policy explaining how we collect, use, and protect your personal data when using our website …
- [PhotoStructure Terms of Service](https://photostructure.com/legal/terms/index.md): Complete terms of service governing the use of PhotoStructure’s web services, including user obligations, content …
- [How to search your PhotoStructure library](https://photostructure.com/guide/search/index.md): Details about searching for assets in your PhotoStructure library
- [PhotoStructure's responsible disclosure security policy](https://photostructure.com/legal/security/index.md): PhotoStructure’s security policy for responsible disclosure of vulnerabilities and contact information for security …
- [2020 PhotoStructure release notes](https://photostructure.com/about/2020-release-notes/index.md): Release notes for PhotoStructure
- [Switch your cross-platform CI to GitHub Actions in 5 minutes](https://photostructure.com/coding/switch-to-github-actions/index.md): Step-by-step guide to migrating your open source project’s CI/CD from other providers to GitHub Actions with …
- [How does PhotoStructure capture captured-at?](https://photostructure.com/guide/captured-at/index.md): Learn how PhotoStructure determines when photos and videos were captured using metadata, filenames, and advanced …
- [DAMs, systems of record, and how PhotoStructure plays well with others](https://photostructure.com/guide/system-of-record/index.md): Explains how PhotoStructure works as a friendly sidekick to other photo management apps by never assuming it’s the …
- [How do I safely store my files?](https://photostructure.com/guide/how-do-i-safely-store-files/index.md): What steps you can take to make sure your files stay safe.
- [How do I prevent a directory from being imported into my library?](https://photostructure.com/guide/how-to-hide-directories/index.md): Learn how to tell PhotoStructure to omit directories from being imported into your library.
- [PhotoStructure log files](https://photostructure.com/guide/log-files/index.md): How to send logs when asked, how to use the Log viewer, where log files are stored, and how to change the log level.
- [What are error reports?](https://photostructure.com/guide/error-reports/index.md): Choose whether to send error reports. Learn what PhotoStructure sends and how to change your choice.
- [PhotoStructure v0.9](https://photostructure.com/about/v0.9/index.md): Find out what's in PhotoStructure version 0.9
- [Library syncing vs rebuilds](https://photostructure.com/guide/sync-vs-rebuild/index.md): Library syncing vs rebuilding
- [Using environment variables with PhotoStructure](https://photostructure.com/guide/environment-variables/index.md): How to override PhotoStructure's settings via environment variables
- [Windows troubleshooting](https://photostructure.com/guide/windows-troubleshooting/index.md): Troubleshooting guide for common PhotoStructure issues on Windows, including firewall problems, antivirus conflicts, and …
- [RAID is not a backup](https://photostructure.com/guide/raid-is-not-a-backup/index.md): Why redundant disk arrays aren't the same as a backup.
- [PhotoStructure tools](https://photostructure.com/server/tools/index.md): Learn about PhotoStructure's tooling to help you work with your library.
- [What do you mean by "deduplicate"?](https://photostructure.com/guide/what-do-you-mean-by-deduplicate/index.md): What de-duplication means to PhotoStructure.
- [What's a "volume?"](https://photostructure.com/guide/what-is-a-volume/index.md): Everything you wanted to know about volumes, but were afraid to ask.
- [Automatic library organization](https://photostructure.com/getting-started/automatic-library-organization/index.md): Learn about PhotoStructure's automatic organization feature.
- [If Something is Odd, Inappropriate, Confusing, or Boring, It Is Probably Important.](https://photostructure.com/coding/odd-inappropriate-confusing-or-boring/index.md): If Something is Odd, Inappropriate, Confusing, or Boring, It Is Probably Important.
- [PhotoStructure's advanced settings](https://photostructure.com/getting-started/advanced-settings/index.md): How to view and edit PhotoStructure's advanced settings.
- [PhotoStructure v0.8](https://photostructure.com/about/v0.8/index.md): Find out what's in PhotoStructure version 0.8
- [Why is PhotoStructure rebuilding my library?](https://photostructure.com/guide/library-rebuilds/index.md): Learn about PhotoStructure library rebuilds
- [What keyboard shortcuts does PhotoStructure have?](https://photostructure.com/getting-started/keyboard-shortcuts/index.md): Navigate like a pro around PhotoStructure
- [How does PhotoStructure extract keywords from my photos and videos?](https://photostructure.com/guide/keywords/index.md): Find out how PhotoStructure extracts keywords from metadata and files
- [Why didn't my file get imported into my Library?](https://photostructure.com/guide/why-is-my-file-missing/index.md): Find out why PhotoStructure didn't import a photo or video
- [Post-installation #protips](https://photostructure.com/getting-started/post-install-protips/index.md): Seven tips to learn after installing PhotoStructure.
- [How to zoom in PhotoStructure](https://photostructure.com/getting-started/zoom/index.md): How to zoom images in PhotoStructure's asset view
- [How do I change my library?](https://photostructure.com/guide/how-do-i-change-my-library/index.md): Learn about how to change your PhotoStructure library, and what happens when you do.
- [How do I fix Windows to support worldwide languages?](https://photostructure.com/faq/windows-unicode/index.md): How to configure Windows 10 to support UTF-8 filenames
- [How to uninstall PhotoStructure](https://photostructure.com/guide/uninstall/index.md): Step-by-step instructions for completely removing PhotoStructure from your system, including all data and settings.
- [2019 PhotoStructure release notes](https://photostructure.com/about/2019-release-notes/index.md): 2019 release notes for PhotoStructure
- [Uncertain, lazy, forgetful, & impatient: It’s what you want your code to be.](https://photostructure.com/coding/uncertain-lazy-forgetful-and-impatient/index.md): Uncertain, lazy, forgetful, & impatient; characteristics of good code.
- [PhotoStructure v0.6](https://photostructure.com/about/v0.6/index.md): Find out what's in PhotoStructure version 0.6
- [Where should I install PhotoStructure?](https://photostructure.com/getting-started/where-to-install/index.md): Learn what's required to install PhotoStructure.
- [What metadata is inside your photos?](https://photostructure.com/faq/metadata-what-lurks-inside-your-photos/index.md): What metadata do cameras and smartphones record in your photos and videos?
- [PhotoStructure End-User License Agreement](https://photostructure.com/legal/eula/index.md): What you may do with PhotoStructure, household licensing, what we promise, and how this agreement can change or end.
- [Why doesn't PhotoStructure move original files?](https://photostructure.com/faq/why-doesnt-photostructure-move-original-files/index.md): Learn why PhotoStructure doesn't move original files.
- [How much disk space do I need?](https://photostructure.com/getting-started/how-much-disk-space-do-i-need-for-my-photostructure-library/index.md): Learn how much free disk space you should have when running PhotoStructure.
- [How do I start and stop PhotoStructure?](https://photostructure.com/guide/how-to-start-and-stop-photostructure/index.md): Learn how to launch and shut down PhotoStructure.
- [Corrupt installation](https://photostructure.com/faq/installation-corrupt/index.md): How to fix MODULE_NOT_FOUND errors in PhotoStructure
- [Corrupt library database](https://photostructure.com/faq/library-corrupt/index.md): How to recover from a corrupt PhotoStructure library
- [Crashes and segfaults](https://photostructure.com/faq/crashes/index.md): What to do when PhotoStructure crashes
- [File permissions](https://photostructure.com/faq/file-permissions/index.md): How to fix permission denied errors in PhotoStructure
- [Out of memory](https://photostructure.com/faq/out-of-memory/index.md): How to fix memory issues and OOM kills in PhotoStructure
- [Port already in use](https://photostructure.com/faq/port-in-use/index.md): How to fix EADDRINUSE errors when starting PhotoStructure
- [Search PhotoStructure Documentation](https://photostructure.com/search/index.md): Search the PhotoStructure documentation site.
- [Too many open files](https://photostructure.com/faq/too-many-open-files/index.md): How to fix EMFILE errors in PhotoStructure