# thelastgimbus/googlephotostakeouthelper **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/thelastgimbus-googlephotostakeouthelper).** 5,508 stars · 298 forks · Dart · apache-2.0 ## Links - GitHub: https://github.com/TheLastGimbus/GooglePhotosTakeoutHelper - Homepage: https://aur.archlinux.org/packages/gpth-bin - awesome-repositories: https://awesome-repositories.com/repository/thelastgimbus-googlephotostakeouthelper.md ## Topics `exif` `exif-data` `google-photos` `google-takeout` `json` `python-scripts` ## Description GooglePhotosTakeoutHelper is a tool that processes Google Photos Takeout exports by decompressing multi-part archives, extracting photos, and restoring original metadata, timestamps, and album structures. It functions as an archive extraction tool, metadata restoration utility, and album structure reconstructor, consolidating scattered export folders into an organized local file system. It resolves creation dates from JSON sidecar files first, then falls back to Exif tags embedded in image files for maximum accuracy. The tool handles multi-part ZIP and TGZ archives transparently by scanning sequentially numbered archive parts and concatenating them before extraction. It reconstructs the original Google Photos album hierarchy from export metadata, preserving trash and archive folders with nested structure. Photos are organized into a single flat directory or subfolders grouped by year-month or album, and file modification timestamps are set to the extracted original creation dates. The project provides a command-line interface that processes Google Photos Takeout archives end‑to‑end, from decompression to final folder organization, without requiring manual extraction of individual archive parts. ## Tags ### Graphics & Multimedia - [Google Photos Takeout Importers](https://awesome-repositories.com/f/graphics-multimedia/google-photos-takeout-importers.md) — Handling the massive archive files and nested folders from a Google Takeout export of your photo library. - [Album Reconstructors](https://awesome-repositories.com/f/graphics-multimedia/google-photos-takeout-importers/album-reconstructors.md) — A Google Takeout Photo Organizer tool that reconstructs album hierarchy from export data, preserving trash and archive folders, with multiple output options. ([source](https://github.com/TheLastGimbus/GooglePhotosTakeoutHelper/blob/master/CHANGELOG.md)) - [Photo Album Reconstructors](https://awesome-repositories.com/f/graphics-multimedia/photo-album-reconstructors.md) — Rebuilds album folder structure from the Google Photos export's album metadata and trash markers, preserving nesting and special folders. ### Part of an Awesome List - [Media File Relocations](https://awesome-repositories.com/f/awesome-lists/devtools/file-and-directory-management/file-and-directory-moves/media-file-relocations.md) — Applies deterministic renaming and moving of all media files to a single flat directory or grouped subfolders, preserving original filenames. - [Date Resolvers](https://awesome-repositories.com/f/awesome-lists/media/photo-management/google-takeout-importers/date-resolvers.md) — A Google Takeout Photo Organizer tool that restores original creation dates and metadata from JSON sidecar files and Exif data to photo files. ([source](https://github.com/TheLastGimbus/GooglePhotosTakeoutHelper/blob/master/CHANGELOG.md)) - [Export Folder Consolidators](https://awesome-repositories.com/f/awesome-lists/media/photo-management/export-folder-consolidators.md) — Consolidating photos from scattered export folders into a single directory or date-based subfolders. ### Business & Productivity Software - [Photo Metadata Restorations](https://awesome-repositories.com/f/business-productivity-software/user-profile-management/profile-archivers/restoration-utilities/photo-metadata-restorations.md) — Restores original creation dates and Exif metadata to photos using JSON sidecar files from the Google Photos export. ### Content Management & Publishing - [Split Archive Handlers](https://awesome-repositories.com/f/content-management-publishing/content-archiving/web-content-archivers/session-data-archivers/remote-archive-extraction/archive-extraction/multi-format-archive-extraction-commands/split-archive-handlers.md) — Decompress by scanning sequentially numbered archive parts (zip, tgz) and concatenating them transparently before extraction. ### Data & Databases - [Metadata Extraction](https://awesome-repositories.com/f/data-databases/file-storage-and-metadata-management/sidecar-file-persistence/metadata-extraction.md) — Reads companion JSON files to extract original creation timestamps and geolocation, then applies them to the corresponding media file. ### Operating Systems & Systems Programming - [Bulk Timestamp Correctors](https://awesome-repositories.com/f/operating-systems-systems-programming/bulk-timestamp-correctors.md) — Setting each photo's file timestamp to its original creation date using embedded JSON metadata. - [Multi-Part Decompressors](https://awesome-repositories.com/f/operating-systems-systems-programming/file-system-access/zip-archive-access/zip-archive-extraction-commands/google-takeout-archive-parsers/multi-part-decompressors.md) — A Google Takeout Photo Organizer tool that decompresses ZIP and TGZ archive files, including multi-part ones, without manual extraction. ([source](https://github.com/TheLastGimbus/GooglePhotosTakeoutHelper/blob/master/CHANGELOG.md)) - [File Timestamp Preservers](https://awesome-repositories.com/f/operating-systems-systems-programming/system-administration-maintenance/system-clock-utilities/timestamp-injection/file-timestamp-preservers.md) — Sets file modification and creation timestamps from extracted metadata using OS system calls, ensuring chronology is kept after extraction. ### Software Engineering & Architecture - [Temporal Folder Arrangement](https://awesome-repositories.com/f/software-engineering-architecture/directory-based-organization/temporal-folder-arrangement.md) — Algorithmically sorts extracted media into year-month or album-based directory tree by parsing the resolved timestamp. - [Photo Timestamp Fallback Resolution](https://awesome-repositories.com/f/software-engineering-architecture/hierarchical-metadata-resolution/photo-timestamp-fallback-resolution.md) — Resolves creation date first from JSON sidecar, then falls back to Exif tags embedded in image files for maximum accuracy. ### User Interface & Experience - [Photo Organizers](https://awesome-repositories.com/f/user-interface-experience/links/folder-based-organization/photo-organizers.md) — A Google Takeout Photo Organizer tool that moves all photos from export folders into a single folder or subfolders grouped by month or album. ([source](https://github.com/TheLastGimbus/GooglePhotosTakeoutHelper/blob/master/README.md))