Takeout JSON
EN

GooglePhotosTakeoutHelper (GPTH): Download, Use, Neo Fork

GooglePhotosTakeoutHelper (GPTH) is a free tool that sorts a Google Takeout export. Where to download it, how to run it, GPTH Neo, and when to use an app.

GooglePhotosTakeoutHelper, usually called GPTH, is a free, open-source program that takes a Google Photos Takeout export, finds every photo and video, sets their dates from the .json files and puts them into one folder or into folders by date. There are two versions. The original by TheLastGimbus was last released in 2023. GPTH Neo, a fork by Xentraxx, is maintained and also writes dates and GPS into the photos' EXIF.

If you searched for "googlephotostakeouthelper", you probably want Neo. This page shows where to get it, how to run it on Windows and Mac, what each version does, and how it compares with Takeout JSON Metadata Fixer, a paid desktop app for the same job.

GooglePhotosTakeoutHelper download

Both versions are published on GitHub, on the Releases page of each repository. Download only from there.

  • GPTH Neo: github.com/Xentraxx/GooglePhotosTakeoutHelper, Releases. Version 6.3.0 as of August 2026.
  • Original GPTH: github.com/TheLastGimbus/GooglePhotosTakeoutHelper, Releases. Last version 3.4.3, September 2023.

Each release has one file per system: Windows, macOS and Linux. Both are licensed under Apache 2.0. Is Google Photos Takeout Helper safe? covers the safety question.

How to use GooglePhotosTakeoutHelper

Before you start, download every Takeout part and keep the zips. GPTH moves files by default, and its own README says to re-export if something goes wrong mid-way.

On Windows

  1. Unpack all Takeout zips into one folder. 7-Zip is faster than the built-in extractor.
  2. For GPTH Neo, install exiftool, which Neo needs to write EXIF into files other than JPEG. 7-Zip is recommended.
  3. Double-click the downloaded .exe. Windows SmartScreen may warn about an unknown publisher; choose "More info", then "Run anyway" if you trust the download.
  4. In interactive mode, choose the Takeout folder and an empty output folder, and answer the questions about albums and date folders.

On Mac

  1. Unpack all zips into one folder with Archive Utility, and merge the Takeout 2, Takeout 3 folders into the first.
  2. Install exiftool, for example with brew install exiftool.
  3. Open Terminal in the download folder. Make the file executable with chmod +x, and remove the quarantine flag with xattr -d com.apple.quarantine followed by the file name. On Apple Silicon, the original GPTH also needs Rosetta.
  4. Run the file from Terminal, for example ./gpth, and answer the same questions.

On Linux the steps are the same as on Mac, without xattr and Rosetta.

When the run ends, check a few photos that had no date before, such as screenshots and WhatsApp images. How to check photo dates are fixed lists the checks.

What the original GPTH does

It "organizes and cleans up your Takeout": finds all photos across the export's folders, sets their "file last modified" date from the JSON, and puts them in one big folder or folders by month. It moves files rather than copying them; in the README's words, "if anything goes wrong mid-way, re-export the zips again." It offers several ways to represent albums. It does not write EXIF. That is what the exiftool step at the end is for.

What GPTH Neo does

Neo keeps the shape of the original and adds most of what was missing. --write-exif is on by default and writes GPS coordinates and dates into the file. It handles "truncated file names" and other edge cases explicitly, works with non-English exports, removes duplicates by content hash, can skip -edited extras or keep duplicates in a subfolder, sorts by year, year/month or year/month/day, separates partner-shared media, converts Pixel Motion Photos, fixes wrong file extensions, resumes an interrupted run, and has a --fix mode for dates in any folder, not just Takeout. It can extract the zips itself.

The prerequisites grew with it. Neo needs exiftool installed for EXIF writing to anything other than JPEG, and recommends 7-Zip for faster extraction. It still moves files by default, with a --keep-input flag that works on a temporary copy.

What Takeout JSON Metadata Fixer does

It is a desktop app for Windows and Mac, installed from the Mac App Store, the Microsoft Store or a Windows installer. It needs no terminal and nothing else installed. It reads every sidecar and writes date, time and location into JPG, HEIC, PNG and videos, with the truncated names, (1) duplicates, edited copies and UTC timestamps handled. It renames with date and place, sorts into year/month or place folders, converts HEIC to JPG with metadata kept, keeps Live Photo pairs together, converts old AVI and MOV to MP4, and lets you set date and place by hand. It runs offline with no account. The first 500 photos are free; Premium is USD 19.99 once.

Side by side

GPTH (original, v3.4.3)GPTH Neo (v6.3.0)Takeout JSON Metadata Fixer
PriceFree, Apache 2.0Free, Apache 2.0First 500 photos free; Premium USD 19.99 once
InstallDownload executable; exiftool separately for the EXIF stepDownload executable; exiftool required for non-JPEG EXIF, 7-Zip recommendedMac App Store, Microsoft Store, Windows installer; nothing else
Needs the command lineWindows: no. Mac and Linux: yes (chmod, xattr, Rosetta on Apple Silicon)Windows: no. Mac and Linux: terminal to runNo
Runs offline, photos stay on your computerYesYesYes, no account
Truncated sidecar names and (1) duplicatesNot statedTruncated names handled; duplicates removed by content hashBoth built in
Edited copies with no sidecar of their ownNot stated--skip-extras drops themBuilt in
Writes date and GPS into the fileNo; sets file modified date, then exiftoolYes, by defaultYes
HEIC to JPG with metadata keptNoNo (fixes wrong extensions, does not convert)Yes
Renames with the placeNoNoYes
Folders by placeNo; one folder or by monthNo; year, month or day foldersYes: year/month, year, or by place
Sets date and place by handNoNoYes, per photo or folder
Moves or copies your filesMoves by defaultMoves by default; --keep-input uses a temporary copyWrites to an output folder you choose
LanguagesNot statedHandles non-English exports; interface language not stated15 interface languages
Windows / Mac / LinuxAll threeAll threeWindows and Mac

Where GPTH wins

It is free and open. You can read the code, file an issue, or fix it yourself. For a one-off migration on a budget that is a real argument, and for anyone who distrusts closed software with their family photos it is the whole argument.

Neo's album handling is more flexible than anything the app offers: shortcuts, hard links, reverse shortcuts, a JSON manifest, or real copies. If album structure matters to you more than folder-by-date, Neo has thought about it harder.

Neo is scriptable. It runs headless on a NAS, it resumes, and its --fix mode repairs dates in a folder that never came from Google. It can extract the zips itself. And it supports Pixel Motion Photo conversion, which the app does not do.

The original GPTH is simpler. If you only want one big folder with sensible modified dates, and you will run exiftool at the end anyway, it still works.

Where Takeout JSON Metadata Fixer wins

No terminal on the Mac, and nothing to install beside it. GPTH on a Mac is chmod, xattr, maybe Rosetta, then exiftool via Homebrew. The app is one install from the store.

It does not move your files. GPTH's own README says to keep the zips because you may need to re-export. The app writes into an output folder you choose.

It goes past dates. Renaming with the place, folders by place, HEIC to JPG with metadata kept, Live Photo pairing, AVI and MOV to MP4, and manual date and place for the photos with no JSON. GPTH stops at organised folders with correct metadata, which is its stated scope.

15 interface languages, and a window with a progress bar rather than a log.

Which one for you

Pick GPTH Neo if you are comfortable installing exiftool, you want it free and open, or you need its album options, headless operation or Pixel Motion Photo handling. Do not pick the original GPTH for a new migration unless you already have exiftool ready for the second step.

Pick Takeout JSON Metadata Fixer if you want the whole thing done in one run without a terminal, you care about the files being named and sorted, or you have a Mac and no wish to type xattr. You can compare directly: run the free 500 photos through it and run Neo on the same sample.

For all five tools in one table see Google Takeout metadata tools compared. If Immich is the destination, immich-go vs Takeout JSON Metadata Fixer is the page you want instead.

Frequently asked questions

What is Google Photos Takeout Helper?

The same program as GooglePhotosTakeoutHelper and GPTH. It is a free tool that sorts a Google Photos Takeout export and sets the dates from the .json files.

What is GPTH Neo?

Google Photos Takeout Helper Neo is the maintained fork of GPTH by Xentraxx, at Xentraxx/GooglePhotosTakeoutHelper on GitHub. It writes dates and GPS into EXIF, handles cut-off sidecar names and removes duplicates.

Is "Google Takeout Helper" the same thing?

Usually yes. People shorten the name. There is no official Google tool with that name.

Does GPTH need exiftool?

The original sets only file dates, and its last step tells you to run exiftool yourself. Neo needs exiftool installed to write EXIF into files other than JPEG.

Does GPTH delete my Takeout?

It moves files out of the Takeout folder by default. Neo's --keep-input flag works on a temporary copy. Keep the zips either way.

Checked on 18 September 2026: original GPTH claims are from the README and latest release (v3.4.3) of TheLastGimbus/GooglePhotosTakeoutHelper on GitHub; GPTH Neo claims are from the README and latest release (v6.3.0) of Xentraxx/GooglePhotosTakeoutHelper. Licences from the repository listings. Takeout JSON Metadata Fixer claims are from our own listing copy for version 1.5.1.