A tool that allows you to easily merge Google's weird JSON metadata with your images.
When you download your files from Google's "Google Photos" service through "Google Takeout", the exported data is inconsistently organized and often fragmented. This can lead to problems:
- Files cannot be reliably sorted or grouped by date or location
- The export contains unnecessary files and a cluttered folder structure
- Your takeout having a big file size due to duplicated media and unnecessary JSON files
GoogleTakeoutFixer solves these issues by:
- Writing EXIF metadata directly into your media.
- Organizing your files into a clear and structured folder structure for easier navigation.
- Automatically removing unnecessary JSON files.
To use GoogleTakeoutFixer, you must have downloaded your photos from Google Takeout and extracted them. Follow these steps:
-
Go to Google Takeout and click "Deselect all".
-
Scroll down and select "Google Photos".
-
Scroll down to the bottom and click "Next Step".
-
In the "Transfer to" section, choose how you'd like to recieve your download link, i recommend choosing email. For "File size", select 50 GB for easier handling.
-
Click "Create export" and follow the instructions.
Note: All your files need to be inside of a single folder for GoogleTakeoutFixer to work. If you have multiple folders, you can simply move all the files into one folder.
- Download the latest release of GoogleTakeoutFixer from the release page. Choose the version that matches your operating system.
- Extract the downloaded archive.
- Run the executable file.
- Click "Select Google Takeout folder" and choose the folder where you extracted your Google Takeout photos. This folder is named something like "Google Photos".
- Click "Select output folder" and choose the folder where you want the fixed photos to be saved.
- Choose the options that you want to apply:
- "Write EXIF metadata": Writes metadata from JSON files into the media files. May not be necessary.
- "Use symlinks for albums": Creates file links instead of duplicating files for albums.
- Click "Start processing" and wait for the process to finish. The time it takes depends on the number of photos and videos you have.
Once the process is complete, you can find your fixed files in the output folder you selected.
- Support for more languages
- Cancel button during processing in the GUI
- Better looking and more user-friendly GUI
- More options for how to organize / structure the output folder
This project modifies metadata using the ExifTool library by Phil Harvey. ExifTool is licensed under the Perl Artistic license, or the GNU General Public License (see here for more details).
This project is an independent open-source project and is not affiliated with, endorsed, or sponsored by Google LLC or any of its subsidiaries. The use of the name "Google" in this repository is solely for descriptive purposes.

