GoogleTakeoutFixer

GoogleTakeoutFixer

A tool to easily clean and organize Google Photos Takeout exports.

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/broken. 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

Tutorial

1. Preparation

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

1. Go to takeout.google.com and click “Deselect all”.

   

2. Scroll down and select “Google Photos”.

   

3. Scroll down to the bottom and click “Next Step”.

4. In the “Transfer to” section, choose how you’d like to receive your download link. I recommend choosing email. For “File size”, select 50 GB for easier handling.

   

5. Click “Create export” and follow the instructions.

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 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.
   • “Ignore album folders”: Ignores album folders and only processes year folders.
   • “Create month subfolders”: Creates month subfolders (labeled 1-12) inside of the output folders.
   • “Flatten output structure”: Puts all files directly in the output folder.
   • “Restore .MOV file extension”: Restores .MOV file extension in case the Major Brand EXIF field says “Apple QuickTime (.MOV/QT)” (See #2).
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.

You will be able to find a full log file inside of the GoogleTakeoutFixer folder inside of the logs folder.

---

CLI usage

You can also use GoogleTakeoutFixer through the CLI. Use the following flags:

• --input "PATH": Path to Google takeout directory
• --output "PATH": Path to output directory
• --symlink: Use symlinks inside of albums instead of duplicating images
• --skip-metadata: Skip writing metadata to files
• --ignore-albums: Ignore album folders and only process year folders
• --month-subfolders: Create month subfolders (labeled 1-12) inside of folders
• --flatten: Flatten the folder structure and put all files directly in the output folder
• --restore-mov: Restore .MOV file extension in case the Major Brand EXIF field says "Apple QuickTime (.MOV/QT)" (See #2)
• --version: Show version
• --help: Show help message

Example usage:

./GoogleTakeoutFixer --input "/path/to/takeout/Google Photos/" --output "/path/to/output/folder/" --symlink

You might have to give the executable permissions to run on Linux and macOS using chmod +x GoogleTakeoutFixer before you can run it through the terminal.

Development

Setup

This project uses Go as the programming language and Fyne as the GUI framework. To run this programm in a developement enviroment, cd into the cmd directory and run go run . to start the program. To run the GUI, make sure you have the necessary dependencies for Fyne installed. See the Fyne Prerequisites.

# Clone this repo
git clone https://github.com/feloex/GoogleTakeoutFixer.git
cd GoogleTakeoutFixer

# cd into the entrypoint directory and run the main.go file
cd cmd
go run .

License

GoogleTakeoutFixer itself is licensed under GNU General Public License v3. See LICENSE for more details.

Used libaries may use different licenses.

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

AMD64 Windows users are provided with a copy of the library “Mesa3D” (opengl32.dll). This is mostly licensed under the MIT License, but some files may be licensed under different licenses. See here for more details. A copy of the MIT license may be obtained here. It is also provided as MESA-LICENSE.txt in the corresponding release assets.

Donate

This software is completely free. You are free to use, modify, and distribute it. If you’d like to support my work, you can donate via my monero adress. Remember that donating is completely optional. Please consider supporting other open-source projects.

XMR: 86ApiK5RFKeVsaEDreQvvkE5Mdo6p3xwtGAZTcbf7JKFDnJ4bG52zqsZjAzgFW6prWhfarinBLrCpW8faxKotG26RcRD4fQ

Disclaimer

Not affiliated with Google LLC.