TheLastGimbus /GooglePhotosTakeoutHelper
Script that organizes the Google Takeout archive into one big chronological folder
★ 5,995⑂ 333👁 44⑃ 138● 265▤ 30
+0
日增长
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 theTop issues
#180Handle "moving photo" video files26 comments · 2023-02-23#203Ignore dot files when using non-AppleFS on Mac17 comments · 2023-05-04#479Anyone interested in sharing the $39 costs for Metadata Fixer?12 comments · 2026-04-20#389Emoji's in albumn names12 comments · 2025-03-04#353Google Photos Takeout now adds a suffix to json file (and not properly either)9 comments · 2024-10-27#195gpth doesn't re-insert data from jsons to exif9 comments · 2023-04-10#261Windows: duplicate files in separate folders8 comments · 2023-11-10#366Extracted a few albums, combine into one folder, program couldn't find anything7 comments · 2025-01-04
Discussions
#492A free browser-local Takeout sidecar/date checker — looking for real-export feedback1 comments · 2026-10-09#491Videos and Live Photos videos from iPhone not treated1 comments · 2026-09-20#488Getting stuck with the merging and your Google account is in a language different than English? try this:0 comments · 2026-08-21#487"Can't find any D:"1 comments · 2026-08-11#477Issue with "I couldn't find any D:" error and Error Code 13 and more on Windows 10/11 Body1 comments · 2026-04-06#474This program is awesome!!!1 comments · 2026-03-24#463What happens with photos without timestamps?0 comments · 2025-12-25#458File naming conventions0 comments · 2025-12-01
Latest release
v3.4.3 v3.4.3 2023-09-24Just 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