This tool has been designed to Interact and Manage different Photos Cloud services, and allow users to do an Automated Migration from one Photo Cloud service to other or from one account to a new account of the same Photo Cloud service.
As of today, the Supported Photo Cloud Services are:
-
Google Photos Takeout
- Unpack your Takeout Zip files.
- Process .json files to fix metadata (including creation date and time) of all your assets.
- Merge Live picture with separate files (.HEIC and .MP4).
- 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.
-
Synology Photos - Features included:
- Upload Album(s)
- Upload ALL (from folder)
- Download Album(s)
- Download ALL (into folder)
- Remove ALL Assets
- Remove ALL Albums
- Remove Empty Albums
- Remove Duplicates Albums
-
Immich Photos - Features included:
- Upload Album(s)
- Upload ALL (from folder)
- Download Album(s)
- Download ALL (into folder)
- Remove ALL Assets
- Remove ALL Albums
- Remove Empty Albums
- Remove Duplicates Albums
- Remove Orphans Assets
-
Apple Photos
(not available yet but is on the ROADMAP.md for next release) -
Google Photos
(not available yet but is on the ROADMAP.md for next release)
Apart from Manage the different Photo Cloud Services, the Tool also contains some 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
- Remove Empty Albums in Photo Cloud Services
- Remove Duplicates Albums in Photo Cloud Services
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.
Download the tool either for Linux, MacOS or Windows (for both x64/amd64 or arm64 architectures) or Docker version (plattform & architecture independent) as you prefer, directly from following links:
Youn can see how to configure the Config.ini file in this help section: Configuration File
You can check the whole list of functions and arguments with the right syntax here: Command Line Syntax
- Configuration File
- Command Line Syntax
- Automated Migration Feature
- Google Takeout Management
- Synology Photos Management
- Immich Photos Management
- Other Features
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 Instructions Link Difficulty Pros Cons Compiled
BinariesInstructions 🟢 Easiest way ✅ 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 systems.Docker
ContainerInstructions ⭐ Recommended ✅ Platform and architecture independent.
✅ Easy configuration viadocker.configfile (RELEASE_TAG, TIMEZONE).
✅ 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 folder.Source
RepositoryInstructions 🔴 More difficult ✅ 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. -
Feature Compiled
Binaries
easiest wayDocker
Container
recommendedSource
Repository
more difficultPlatform 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 ⭐⭐⭐⭐☆ (3.5) ⭐⭐⭐⭐☆ (3.7) ⭐⭐⭐☆☆ (3.0)
Note
From version 3.0.0 onwards, the Tool supports a new Feature called 'Automated Migration'.
Use the argument '--source' to select the <SOURCE> and the argument '--target' to select <TARGET> for the Automated Migration Process to Pull all your Assets (including Albums) from the <SOURCE> Cloud Service and Push them to the <TARGET> Cloud Service (including all Albums that you may have on the
-
Possible values for:
- <SOURCE> : ['synology-photos', 'immich-photos']-[id] or <INPUT_FOLDER> (id=[1, 2] to select which account to use from the Config.ini file).
- <TARGET> : ['synology-photos', 'immich-photos']-[id] or <OUTPUT_FOLDER> (id=[1, 2] to select which account to use from the Config.ini file).
-
The i 8000 dea is complete above list to allow also Google Photos and Apple Photos (iCloud), so when this is done, the allowed values will be:
- <SOURCE> : ['synology-photos', 'immich-photos', 'google-photos', 'apple-photos']-[id] or <INPUT_FOLDER> (id=[1, 2] to select which account to use from the Config.ini file).
- <TARGET> : ['synology-photos', 'immich-photos', 'google-photos', 'apple-photos']-[id] or <OUTPUT_FOLDER> (id=[1, 2] to select which account to use from the Config.ini file).
If you ommit the suffix -[id], the tool will assume that account 1 will be used for the specified client (ie: --source=synology-photos means that Synology Photos account 1 will be used as <SOURCE> client.)
Also, you can ommit the suffix -photos in both <SOURCE> and <TARGET> clients, so, you can just use --source=synology --target=immich to set Synology Photos account 1 as <SOURCE> client and Immich Photos account 1 as <TARGET> client.
By default, the whole Migration process is executed in parallel using multi-threads (it will detect automatically the number of threads of the CPU to set properly the number of Push workers.
The Pull worker and the different Push workes will be executed in parallel using an assets queue to guarantee that no more than 100 assets will be temporarily stored on your local drive, so you don't need to care about the hard disk space needed during this migration process.
By default, (if your terminal size has enough width and heigh) a Live Dashboard will show you all the details about the migration process, including most relevant log messages, and counter status. You can disable this Live Dashboard using the flag '-dashboard=false or --dashboard=false'.
Additionally, this Automated Migration process can also be executed secuencially instead of in parallel, so first, all the assets will be pulled from
Also, take into account that in this case, the Live Dashboard will not be displayed, so you only will see the different messages log in the screen, but not the live counters during the migration.
and execute this feature, the Tool will automatically do the whole migration job from <SOURCE> Cloud Service to <TARGET> Cloud Service.
Warning
If you use a local folder <INPUT_FOLDER> as source client, all your Albums should be placed into a subfolder called 'Albums' within <INPUT_FOLDER>, creating one Album subfolder per Album, otherwise the tool will no create any Album in the target client.
Example:
<INPUT_FOLDER>/Album1
<INPUT_FOLDER>/Album2
Important
It is important that you configure properly the file 'Config.ini' (included with the tool), to set properly the accounts for your Photo Cloud Services.
- Alpha version. : 2025-03-14
- Beta version : 2025-03-21
- Release Candidate: 2025-03-28
- Official Release : 2025-03-31
-
Support to runnning the Tool from Docker container.
-
Included Live Progress Dashboard in Automated Migration process for a better visualization of the job progress.
-
Added a new argument '--source' to specify the <SOURCE> client for the Automated Migration process.
-
Added a new argument '--target' to specify the <TARGET> client for the Automated Migration process.
-
Removed argument '-AUTO, --AUTOMATED-MIGRATION <SOURCE> <TARGET>' because have been replaced with two above arguments for a better visualization.
-
Added new flag '-dashboard, --dashboard=[true, false]' (default=true) to show/hide Live Dashboard during Atomated Migration Job.
-
Added new flag '-gpthProg, --show-gpth-progress=[true, false]' (default=false) to show/hide progress messages during GPTH processing.
-
Added new flag '--gpthErr, --show-gpth-errors=[true, false]' (default=true) to show/hide errors messages during GPTH processing.
-
Renamed flag '-gitf, --google-input-takeout-folder' to '-gtProc, --google-takeout-to-process' for a better understanding.
-
Completely refactored Automated Migration Process to allow parallel threads for Downloads and Uploads jobs avoiding downloading all assets before to upload them (this will save disk space and improve performance). Also objects support has been added to this mode for an easier implementation and future enhancements.
-
Support for 'Uploads Queue' to limit the max number of assets that the Downloader worker will store in the temporary folder to 100 (this save disk space). In this way the Downloader worker will never put more than 100 assets pending to Upload in the local folder.
-
Support Migration between 2 different accounts on the same Cloud Photo Service.
-
Support to use Local Folders as SOURCE/TARGET during Automated Migration Process. Now the selected local folder works equal to other supported cloud services.
-
Code Refactored to convert ServiceGooglePhotos, ServiceSynologyPhotos and ServiceImmichPhotos into Classes (ClassTakeoutFolder, ClassSynologyPhotos, ClassImmichPhotos) and homogenized all functions of all these classes.
-
Added new Class ClassLocalFolder with the same methods as other supported Cloud Services Classes to manage Local Folders in the same way as a Photo Cloud Service.
-
ClassTakeoutFolder inherits all methods from ClassLocalFolder and includes specific methods to process Google Takeouts since at the end Google Takeout is a local folder structure.
-
Updated GPTH version to cop latest changes in Google Takeouts.
-
Documentation completelly re-written and structured in different filels
-
Documentation is now included as part of the distribution packages.
-
Bug Fixing.
-
Tests Pending:
- Deep Test on Immich Support functions. (volunteers are welcomed)
- Deep Test on Synology Support functions. (volunteers are welcomed)
- Deep Test on Google Takeout functions. (volunteers are welcomed)
- Deep Test on Automated Migration Mode. (volunteers are welcomed)
- Alpha version. : (No estimated date)
- Beta version : (No estimated date)
- Release Candidate: (No estimated date)
- Official Release : (No estimated date)
- Include Apple Support (initially just for downloading)
- Create Class ClassApplePhotos with the same methods and behaviour as ClassSynologyPhotos or ClassImmichPhotos. (volunteers are welcomed)
- -adAlb, --apple-download-albums
- -adAll, --apple-download-all
- -auAlb, --apple-upload-albums
- -auAll, --apple-upload-all
- Include native support for Google Photos through API
(See: https://max-coding.medium.com/loading-photos-and-metadata-using-google-photos-api-with-python-7fb5bd8886ef)- Create Class ClassGooglePhotos with the same methods and behaviour as ClassSynologyPhotos or ClassImmichPhotos. (volunteers are welcomed)
- -gdAlb, --google-download-albums
- -gdAll, --google-download-all
- -guAlb, --google-upload-albums
- -guAll, --google-upload-all
- Allow Google Photos and Apple Photos as TARGET in AUTOMATED-MODE
- Add option to filter assets in all Immich Actions:
- by Dates
- by Country
- by City
- by Archive
- by Person
- Update README.md
- Update RELEASES-NOTES.md
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
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 💖
