osxphotos is a command-line interface tool and programmatic database interface designed for managing and exporting media from Apple Photos libraries. It provides a bridge to the underlying system database, allowing for the automation of batch operations and the retrieval of technical metadata.
The project distinguishes itself through a metadata-driven export system that uses custom templates to organize files into directory hierarchies. It can extract machine-learning data—including aesthetic scores and optical character recognition—and synchronize metadata across different libraries using unique file fingerprints.
Its broader capabilities include comprehensive metadata management, such as batch editing EXIF data and generating XMP or JSON sidecars. The tool also supports asset querying via filters, duplicate photo identification, and the ability to trigger native actions within the photo application via scripts.
The project is implemented in Python.
