gphotos-takeout-repair

gphotos-takeout-repair

Organize a Google Photos export (created with Takeout) into a useful directory of files.

The output is a directory of files (with folder structure retained) suitable for use as a traditional photo library, where there are no JSON files or duplicate "edited" versions, and files have suitable Date Created timestamps.

For example given the following files in the source directory:

Filename	Date Created	Description
IMG_0001-edited.jpg	Takeout export date	Edited version of the file
IMG_0001.jpg	Takeout export date	Original version of the file
IMG_0001.jpg.json	Takeout export date	Metadata information for file
IMG_0002.mp4	Takeout export date	Original version of the file
IMG_0002.mp4.json	Takeout export date	Metadata information for file

The output in the destination directory will be:

Filename	Date Created	Description
IMG_0001.jpg	"Photo taken" date from JSON	Edited version of the file
IMG_0002.mp4	"Photo taken" date from JSON	Original version of the file

Features

• Copies files to destination directory using photoTakenTime from the JSON file
• Copies the (usually best) "edited" version where possible to prevent duplicates
• Retains source directory folder structure to handle Takeout's exporting of albums
• Handles many common Takeout export filename and encoding issues (view tests)

Install

npm install -g gphotos-takeout-repair

Usage

gphotos-takeout-repair --src ./unzipped-takeout-dir --dest ./output-dir

Related

• https://github.com/TheLastGimbus/GooglePhotosTakeoutHelper
• https://github.com/m1rkwood/google-photos-takeout-scripts
• https://github.com/mattwilson1024/google-photos-exif
• https://github.com/garzj/google-photos-migrate

Changelog

1.4.1

24 August 2024

• Bump dependencies b749093
• Upgrade ESLint to v9 03b382e
• Improve code readability 06017c4
• Switch from Jest to Vitest 4fb9497
• Update description 3acaf18
• Add CHANGELOG.md a3f008f