TheLastGimbus /GooglePhotosTakeoutHelper

Script that organizes the Google Takeout archive into one big chronological folder

★ 5,995⑂ 333👁 44⑃ 138● 265▤ 30
DartApache-2.0Created 2020-04-02aur.archlinux.org/packages/gpth-bin
Download: v3.4.3v3.4.3 ↓3.4.32023-09-24
+0
Daily
5,995
stars
333
forks
44
watchers
138
prs
265
issues
30
releases

README

Google Photos Takeout Helper 📸🆘
 What is this for 🧐
If you ever want to move from Google Photos to other platform/solution, your fastest choice to export all photos is Google Takeout 🥡

But when you download it, you will find yourself with zips with hundreds of little folders with weird .json files inside 🍝. 
What if you want to just have one folder with all photos, in chronological order? Good luck copying all of that 🙃

This script does just that - it organizes and cleans up your Takeout for you 🧹😌

It will take all of those folders, find all photos in them, set their file last modified correctly, and put it in one big folder (or folders divided by a month) 🗄

 How to use:
Since v3.2.0, gpth is interactive 🎉 - you don't need to type any complicated arguments - just get your takeout, run gpth, and follow prompted instructions 💃

If you want to run it on Synology, have problems with interactive, or just love cmd, look at "Running manually with cmd". Otherwise, just:

 1. Get all your photos from Google Takeout 📥
"deselect all" and then select only Google Photos
      


 2. Unzip them all and merge into one, so that all "Takeout" folders become one
   
   NOTE: Keep those original zips, you may need them if anything goes wrong
   
   
   
 3. Download the executable for your system from releases tab 🛒 (also available on AUR 😏)

 4. Run gpth
   - On Windoza: just double-click the downloaded .exe 🎉 - tell windoza defender that it's safe, and follow prompted instructions 🧾
   - On Mac/Linux: open terminal, cd to the folder with downloaded executable and run it:
     bash
      if you have Mac with M1/M2 chip, you need to enable x86 emulation
      otherwise, just skip it
     softwareupdate --install-rosetta
     
     cd Downloads  probably
      add execute permission for file
     chmod +x gpth-macos  or gpth-linux
      tell MacOS Gatekeeper to not worry
     xattr -r -d com.apple.quarantine gpth-macos
      run it 🏃
     ./gpth-macos  or ./gpth-linux
      follow prompted instructions 🥰
     

   Fun fact: gpth moves files around by default - so if anything goes wrong mid-way, re-export the zips again :pray:
     
 5. Most of your photos should have correct original EXIFs (metadata), but if you want, you can insert them everywhere with exiftool, so you won't lose their creation time
   - Download Phil Harvey's exiftool: https://exiftool.sourceforge.net/
   - Open the cmd/terminal, and run
     bash
      cd to folder where you downloaded exiftool
     cd Downloads
      run it on your output folder:
      (the '-r' means "run on all files/in sub-folders" aka recursively)
      (Make sure you didn't change file modify dates aka didn't do anything with the files after running gpth
     exiftool -overwrite_original -r -if 'not defined DateTimeOriginal' -P "-AllDates<FileModifyDate" "your/output/folder/ALL_PHOTOS/"
     

Done! Enjoy your photos!!!

 Running manually with cmd

You may still need this mode if:
- You want to run on Synology where the

Top issues

Discussions

Latest release

v3.4.3 v3.4.3 2023-09-24
Just a few patches ❤️‍🩹

- put stuff in date-unknown also when not div-to-dates - 245
- fix extras detection on mac - 243
- add note to not worry about album finding ;)
- nice message when trying to run interactive on headless

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON