Osxphotos

Changed

- Added `-r` option to `osxphotos install` for use with requirements.txt files

Added

- Updated `osxphotos inspect` to include details about shared iCloud library photos
- Added `osxphotos template` command for interactive template REPL tool

Removed

Fixed

- Added clarifying note to help for `--push-exif` option

Contributors

- [RhetTbull](https://github.com/RhetTbull) for code
- [kvisle](https://github.com/kvisle) for testing & data to implement iCloud Shared Library features

[v0.62.1](https://github.com/RhetTbull/osxphotos/compare/v0.62.0...v0.62.1)

Documentation Fixes

Changed

Added

Removed

Fixed

- Minor fixes to the documentation.

Contributors

- [RhetTbull](https://github.com/RhetTbull)

[v0.62.0](https://github.com/RhetTbull/osxphotos/compare/v0.61.0...v0.62.0)

Initial support for iCloud Shared Libraries.

This release contains a lot of changes some of which may be breaking depending on your workflow. If you use `--sidecar-template`, you should look at the help for this option as the options have changed from boolean flags to named flags.

If you use `--report` with `--append` and you use CSV reports, you should archive the existing report and start a new one as the report now contains additional fields for user files.

If you use `--post-function`, the called function may now return an [ExportResults](https://rhettbull.github.io/osxphotos/reference.html#osxphotos.ExportResults) object with information about the files written, the files skipped, and any errors generated. If returned, these files will be included in `--report` and will be protected from cleanup with `--cleanup`.

Initial support for photos in Shared iCloud Libraries has been implemented. These photos can be queried via the `--shared-library` option. Still working on decoding the participant information (who is sharing the photos).

Added

- Support for iCloud shared libraries, PhotoInfo.shared_library, PhotoInfo.share_participants, PhotoInfo.share_info (860)
- Shared moment, syndicated, shared library support to `osxphotos inspect`(860)
- `--post-command-error` option to configure error handling of `--post-command` (1142)
- `.osxphotos_keep` file can now be used to specify keep patterns for `--cleanup` (1135)
- Option to `--sidecar-template` to skip zero length files

Removed

Changed

- Changed `--sidecar-template` options to use named options instead of boolean
- Changed signature of --post-function function to enable it to work with --report, --cleanup (1136)
- Now can catch template errors with `catch_errors` option to `--sidecar-template`

Fixed

- Fixed bug with PhotoInfo.path_raw on Photos <= 4.0

Contributors

- [RhetTbull](https://github.com/RhetTbull) - Code and testing
- [neilpa](https://github.com/neilpa) - The idea for custom sidecars and suggestions to improve the feature
- [kvisle](https://github.com/kvisle) - For user testing with iCloud shared libraries

[v0.61.0](https://github.com/RhetTbull/osxphotos/compare/v0.60.10...v0.61.0)

Custom sidecars for osxphotos export

Added

- `--sidecar-template` option to export to allow user to specify one or more Mako templates for creating custom sidecars. See [example](https://github.com/RhetTbull/osxphotos/blob/main/examples/custom_sidecar.mako for an example)

Removed

Changed

- Added `user_sidecar` field to all report formats. This means that if you are using a CSV report with `--append`, you should archive your current report and create a new one which will include the correct headers. For JSON reports, the JSON outpput will simply include a new key for new records. For SQLite reports, the `report` table will be altered to add the new column.

Contributors

- [RhetTbull](https://github.com/RhetTbull) - Code and testing
- [neilpa](https://github.com/neilpa) - The idea for custom sidecars

[v0.60.10](https://github.com/RhetTbull/osxphotos/compare/v0.60.9...v0.60.10)

Support for syndicated photos on Monterey (Photos 7)

Added

Removed

Changed

- Added additional photo details to `osxphotos debug-dump`

Fixed

- Syndicated photos now work on Monterey (1116)
- `osxphotos orphans` now also scans the scopes directory

Contributors

- [RhetTbull](https://github.com/RhetTbull) - code
- [neilpa](https://github.com/neilpa) - for testing and finding the bug with syndicated photos on Monterey

[v0.60.9](https://github.com/RhetTbull/osxphotos/compare/v0.60.8...v0.60.9)

Fixed missing path for photos that are part of a shared moment (Ventura+)

Added

- `PhotoInfo.shared_moment` property (True if photo is part of a shared moment, otherwise False)
- `--shared-moment`, `--not-shared-moment` query options

Removed

Changed

Contributors

- [RhetTbull](https://github.com/RhetTbull) for code
- [neilpa](https://github.com/neilpa) for identifying the bug with shared moments

[v0.60.8](https://github.com/RhetTbull/osxphotos/compare/v0.60.7...v0.60.8)

Adds support for working with Photos libraries on macOS Sonoma (14.0 preview)