Google Photos Matcher (Linux fork) (v 1.2)

Simple executable to match metadata from JSONs to original images/videos. This repository is a fork of anderbggo's project modified to run on Linux via CLI

Same work than MetadataFixer but its free!

Wiki 📖

When you download the images from google photos, they lose some metadata such as the date and the coordinates in which they were taken.

This algorithm is able to match this information in the image/video from the downloaded JSONs

Usage

1. Download your Google Photos media from Takeout

2. Clone this repository and run python3 cli.py <path>

   • Optionally run with --suffix or -s to add a custom file suffix

3. Matched images/videos will be on directory -MatchedMedia inside the same path

FAQs

Why is there another folder called EditedRaw?

Images and videos edited from Google Photos's editor will have 2 different versions:

1. Edited version
2. Original version

Edited version will be stored in MatchedMedia while original in EditedRaw

Why some images/videos stay unmatched?

Sometimes, the algorithm does not recognize the names of the images due to the presence of some special characters. These files will remain in the same folder. To fix it, rename both the JSON and the original file.

For example:

• Algorithm fails with image %E&xample.jpg

Solution

1. Rename %E&xample.jpg to Example.jpg and %E&xample.json to Example.json

2. Open JSON and change title attribute to Example.jpg

3. Run again

Contributors ✒️

• anderbggo - Author
• Freepik - Icon creator
• UvixCreative - Forked and modified to run on Linux

Donations💰

See the original project for donation links