This tool has been designed to Interact and Manage different Photos Cloud services, and allow users to do an Automatic Migration from one Photo Cloud service to other or from one account to a new account of the same Photo Cloud service.
The main use case is the Automatic Migration Feature to migrate all your photos and videos from one Photo cloud service to other, or between different accounts of the same service.
Apart from the 'Automatic Migration Feature', you can use the tool also to manage different Photo Cloud Services. Currently, the Features Included per each Supported Photo Cloud Service are:
-
- Unpack your Takeout Zip files.
- Merge Live picture with separate files (.HEIC and .MP4).
- Process .json files to fix metadata (including creation date and time, GPS data, etc...) of all your assets.
- Separate your assets per Albums (if belong to any album).
- Organize your assets in a year/month structure for a better organization.
- Create Symbolic Links for assets within any Album (to save disk space).
- Detect and remove duplicates.
- Auto rename Albums folders to homogenize all names based on content dates.
-
Synology Photos & Immich Photos - Features included:
Feature Synology Immich Upload Album(s) (from folder) doc doc Download Album(s) (into folder) doc doc Upload ALL (from folder) doc doc Download ALL (into folder) doc doc Remove ALL Assets doc doc Remove ALL Albums doc doc Remove Albums by Name Pattern doc doc Rename Albums by Name Pattern doc doc Remove Empty Albums doc doc Remove Duplicates Albums doc doc Merge Duplicates Albums doc doc Remove Orphans Assets No Available doc -
Apple Photos
(not available yet but is on the Roadmap for next release) -
Google Photos
(not available yet but is on the Roadmap for next release) -
Other Useful Features
Apart from Manage the different Photo Cloud Services and the 'Automatic Migration Mode', the Tool also contains Other Useful Features such as:- Metadata fixing of any Photo Library in your local drive (not necesarely needs to be a Google Takeout folder)
- Library Organization features:
- Manage Duplicates assets
- Splitting of assets with and without associated albums
- Folder Structure (customizable) for 'Albums' and 'No Albums' folders
- Symbolic Links Support for Albums folders
- Fix Symbolic Links Broken
- Homogenize Albums folders name based on content
Download the tool either for Linux, MacOS or Windows (for both x64 and arm64 architectures) or Docker version (plattform & architecture independent) as you prefer, directly from following links:
Or check the Historical Releases Notes to choose any specific release.
Note
The Tool is Multi-Platform and Multi-Architecture, and has been designed to be run directly within a Linux Server or NAS such as Synology NAS (Compatible with DSM 7.0 or higher), so feel free to download the version according to your system.
You can also execute the Tool from a Docker container or from sources files for a better compatibility. In below sections you can find the execution instructions to run the Tool from the different methods.
In order to connect to the different Photo Cloud Services, you must configure the conection settings using the Configuration file (Config.ini) provided with the Tool.
You can see how to configure the Configuration File in this help section: Configuration File
This Tool is based on commands given through the Command Line Interface (CLI), so it is important to know the syntax of that interface.
You can check the whole list of features and arguments with the right syntax here: Command Line Interface (CLI)
Check all arguments descriptions and usage examples in the Arguments Description or in the shorter version.
- Configuration File
- Command Line Interface (CLI)
- Arguments Description
- Automatic Migration Feature
- Google Takeout Management
- Synology Photos Management
- Immich Photos Management
- Other Features
- GPTH Tool Pipeline Description
There are three different methods to execute this Tool:
- From Compiled Binaries
- From Docker Container
- From Source Repository
The below tables show the pros and cons of each method together with a comparative rating of each one of them for you to decide wich one fits best with your needed:
-
Execution Method Difficulty Pros Cons Binaries 🟢 ✅ Only basic knowledge on command line commands needed ❌ Platform and architecture dependent
❌ Need basic knowledge of running command line instructions
❌ Some anti-virus may detect the tool as suspicious in Windows systemsDocker ⭐ ✅ Platform and architecture independent
✅ Easy configuration viadocker.config
✅ Automatically pulls latest image ifRELEASE_TAG=latest❌ Need intermediate knowledge of running command line instructions
❌ Need to install Docker (if not already installed)
❌ All paths given as arguments must be relative to the execution folderSource 🔴 ✅ Platform and architecture independent ❌ Need advance knowledge of running command line instructions
❌ Need to install Git and Python 3.8+ (if not already installed).
❌ Need to pull the source repository again to update to a new release🟢 Easiest way ⭐ Recommended 🔴 More difficult
-
Feature Binaries
(easiest way)Docker
(recommended)Source
(more difficult)Platform and architecture independence ⭐☆☆☆☆ ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ Ease of updating to new release ⭐⭐⭐☆☆ ⭐⭐⭐⭐⭐ ⭐☆☆☆☆ Allow paths arguments point outside execution folder ⭐⭐⭐⭐⭐ ⭐☆☆☆☆ ⭐⭐⭐⭐⭐ No Requires Technical knowledge (Command line syntax) ⭐⭐⭐⭐⭐ ⭐⭐⭐☆☆ ⭐☆☆☆☆ No Requires additional tools/software ⭐⭐⭐⭐⭐ ⭐⭐⭐☆☆ ⭐☆☆☆☆ No Risk of Antivirus alert (especially on Windows) ⭐⭐☆☆☆ ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ Average Rating ⭐⭐⭐⭐☆ ⭐⭐⭐⭐☆ ⭐⭐⭐☆☆ Average Score 3.5 3.7 3.0
The Historical Releases Notes can be checked in the following link: Releases Notes
The Planned Roadmap for futures releases can be checked in the following link: Planed Roadmap
I hope this can be useful for any of you. Enjoy it!
(c) 2024-2025 by Jaime Tur (@jaimetur).
Part of this Tool is based on GPTH Tool by TheLastGimbus/Wacheee and v4.x.x by Xentraxx
If you consideer that this Tool has helped you, you can also consider donating me with a ☕
I spent a lot of time developping this Tool for free, so donations will contribute to motivate me to continue working on this project 💖
