Skip to content

RhetTbull/RepairPhotosBookmarks

Repository files navigation

Repair Apple Photos Bookmarks

Work in progress to repair file location bookmarks in Apple Photos.

Background

Starting in macOS 10.15/Catalina, photos imported into the Apple Photos app and not copied into the library (e.g. referenced photos) are tied to a specific volume on a specific computer. If you move the photos to a different volume or computer, even with the same name, Photos will be unable to open the original files and will produce a "Missing file" dialog. This is caused because of macOS Sandbox security features and the fact that Photos now stores locations to photos using security-scoped file system bookmarks instead by path. This script will repair your photos library by updating the bookmarks.

This is a work in progress and it's a bit of hack. It requires a few manual steps to get it working (the script will prompt you).

How to use

First, move your Photos library to the new volume or the new computer. Note: the absolute path to the photos must remain the same. For example, if your photos were located on an external drive named "Fotos" and in a folder named "MyFotos" the path would /Volumes/Fotos/MyFotos, the new volume must also be named "Fotos" and the folder must be named "MyFotos".

  • pip install -r requirements.txt
  • python3 repair_photos_bookmarks.py PATH_TO_PHOTOS_LIBRARY
  • Follow the prompts

Contributors

Thanks to @dgleich for the idea behind this project and for contributing significant research, testing, and code! This was a joint effort.

TODO

  • Add option to change the absolute path to the photos
  • Incorporate as an option to osxphotos

Additional Information

For more information, see this discussion

About

Repair broken bookmarks to referenced files in Apple Photos to fix "Missing file" errors when moving a Photos library to a different disk or machine.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages