Skip to content

A tool to clean and organize Google Photos Takeout exports.

License

Notifications You must be signed in to change notification settings

feloex/GoogleTakeoutFixer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GoogleTakeoutFixer

drawing

A tool that allows you to easily merge Google's weird JSON metadata with your images.

The Issue

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

Solution

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.

Preview

GoogleTakeoutFixer Window

Tutorial

1. Preparation

To use GoogleTakeoutFixer, you must have downloaded your photos from Google Takeout and extracted them. Follow these steps:

  1. Go to Google Takeout and click "Deselect all".

    Google Takeout deselect button
  2. Scroll down and select "Google Photos".

    Google Takeout Selected
  3. Scroll down to the bottom and click "Next Step".

  4. 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.

    Create Export options
  5. 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.

2. Installation

  1. Download the latest release of GoogleTakeoutFixer from the release page. Choose the version that matches your operating system.
  2. Extract the downloaded archive.
  3. Run the executable file.

3. Using GoogleTakeoutFixer

  1. Click "Select Google Takeout folder" and choose the folder where you extracted your Google Takeout photos. This folder is named something like "Google Photos".
  2. Click "Select output folder" and choose the folder where you want the fixed photos to be saved.
  3. 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.
  4. 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.

Planned Features

  • 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

Credits

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).

Disclaimer

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.