TakeoutFix

Move your Google Photos library without losing important metadata. TakeoutFix processes Google Takeout ZIP files and restores fields like capture date, location, and description.

English · Русский · 中文 · हिन्दी · Español · Français · العربية · Deutsch

Why TakeoutFix

• Keeps photo/video metadata that is often lost during migration.
• Works directly with standard Google Takeout ZIP exports.
• Guides you through a clear terminal flow from start to finish.
• Built for regular users: no scripting required.

Quick Start (3 Steps)

1. Export your Google Photos archive from Google Takeout as ZIP files.
2. Put all *.zip files into one local folder.
3. Open a terminal in that folder and run the recommended command below.

Run (Recommended)

Run directly in the folder with your Takeout ZIP files.

macOS/Linux:

curl -fsSL https://github.com/vchilikov/takeout-fix/releases/latest/download/install.sh | sh

Windows (PowerShell):

iwr -useb https://github.com/vchilikov/takeout-fix/releases/latest/download/install.ps1 | iex

Manual Run (Optional)

Use this only if you do not want the one-liner installer.

1. Download the latest binary for your OS from GitHub Releases.
2. Run it in the folder that contains your Takeout ZIP files.

macOS/Linux:

./takeoutfix
./takeoutfix --workdir /path/to/folder

Windows (PowerShell):

.\takeoutfix.exe
.\takeoutfix.exe --workdir C:\path\to\folder

What You Get

After a successful run:

• Your processed media is ready in ./takeoutfix-extracted/Takeout.
• Metadata is applied to supported photos and videos.
• JSON Tags are written to Keywords and Subject.
• If the JSON capture timestamp is missing or invalid and the filename starts with YYYY-MM-DD HH.MM.SS, the date is restored from the filename.
• A detailed run report is saved to ./.takeoutfix/reports/report-YYYYMMDD-HHMMSS.json.
• You can upload ./takeoutfix-extracted/Takeout to your new storage.

Common Issues

• No ZIP files or extracted Takeout data found in this folder.
  • Place Takeout ZIP parts in the folder root, or run from a folder that already contains extracted Takeout content.
• Some ZIP files are corrupted. Please re-download them and run again.
  • Re-download broken archive parts from Google Takeout, then rerun.
• Step 1/3: Checking dependencies... missing
  • Use the recommended one-liner command above, or install exiftool manually and rerun.
• Not enough free disk space to continue.
  • Free up disk space and rerun.
• macOS says the app is not verified
  • Remove quarantine and run again:

    xattr -d com.apple.quarantine ./takeoutfix