Bug Fixes and Performance Improvements

2026-02-01

Added osxphotos dbversion command to print version info for a given Photos library. This does not parse the database, only prints version info, so it should be useful on unknown database versions. (#2066)
Added --skip-raw-jpeg to osxphotos export; this option causes only the RAW image of a RAW+JPEG pair to be exported. Complement to --skip-raw which skips the RAW and exports the JPEG. (#1549)
Added --pre-load option to osxphotos export. This can be used to rebuild or pre-load a new osxphotos export database from an existing folder structure. See osxphotos help export pre-load for more info.

osxphotos export --only-new can now be used with --cleanup. Any file previously exported by osxphotos will not be deleted when exporting with both options.
Debug options such as --debug, --profile, --watch, --breakpoint can now be added at the end of the command line instead of the beginning
When using osxphotos query and osxphotos export, photos are now always processed in order of oldest first to newest last. (#2078)

Fixed docs formatting (#2029)
Partial fix for shared albums in macOS Tahoe (#2003) (Still needs testing by Tahoe users)
Fix for osxphotos export --dry-run with --download-missing or --pre-load to avoid downloading images from iCloud. (#2095)
Fix PhotosAlbum to ignore shared photos (#2067)
Improved export speed on SMB volumes (#2087)
Avoid downloading edited images unnecessarily when using --download-missing (#1086)
Fixed osxphotos import grouping with edited files in format IMG_1234_edited (1).heic (#2075)