PhotoStructure has a number of filters that all must pass for a photo or video to be added to your library.
Default import filters #
The file must be a JPEG, PNG, digital camera raw format, or a video format that FFmpeg can decode.
If the JPEG is found to be corrupt it will be skipped. This may be due to bitrot or a failed backup.
If the image is too small, it will be skipped. The default minimum dimension is 480 pixels for images, and 240 pixels for videos. The default minimum filesize is 50 KB. These defaults can be changed with the
minAssetSizeByteslibrary settings, or the
If a file is too large, it will be skipped. This mostly applies to videos, and prevents your NAS from filling up with transcoded versions of that 45 minute piano recital that you’ll never watch. This defaults to 500 MB, and can be changed with the
Images must have a make and model in their metadata. This filter prevents screenshots, downsampled photos, and web cache images from being imported into your library. This filter can be disabled by setting
falsein your library settings, or setting the
PS_REQUIRE_MAKE_MODELenvironment variable to
PhotoStructure will refuse to walk into directories that have the same path element more than 7 times. This helps avoid infinite filesystem loops.
These loops are caused by directory symlinks that (eventually) point to a parent directory, and would cause the directory contents to be imported indefinitely (with ever-repeating parent directory names).
Why didn’t an individual file get imported? #
As of July 2020, answering this question requires some amount of comfort with the terminal, using PhotoStructure’s command-line tools.