This tool has been designed to Interact and Manage different Photo Services such as Google Photos, Synology Photos, Immich Photos, NextCloud Photos & Google Takeout, 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 Tool supports multiple accounts for the same service, so you can migrate your assets between different accounts of the same 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.
Note
For more info you can check the feature documentation in below link:
Other important feature included in the tool is the Google Takeout Fixing.
This feature has been designed to automatically analyze your Google Photos Takeout, extract all the information from the sidecar JSON files (or guess some missing information using heuristics algorithms) and embeds all the extracted info into each asset file using EXIF tags.
In this way your Media Library will be ready to be migrated to any other Cloud Photo services without losing any important info such as, Albums info, Original date, GPS location, Camera info, etc...
But this feature also helps you to organize and clean your Media Library removing duplicates, creating Year/Month folder structure, creating symbolic links for Albums assets, Auto renaming Albums to clean their names and include a prefix with the date of its assets, Process Motion/Live Pictures, etc...
The whole process is done in an automatic way and is divided in different steps (some of them are optionals).
Note
For more info you can check the feature documentation in below link:
Apart from the 'Automatic Migration' and 'Google Takeout Fixing' features, you can use the tool also to manage different Photo Cloud Services. Currently, the Features Supported per each Photo Cloud Service are:
| Feature | Synology | Immich | Nextcloud | Google Photos |
|---|---|---|---|---|
| Upload Album(s) (from folder) | doc | doc | doc | doc |
| Download Album(s) (into folder) | doc | doc | doc | doc |
| Upload ALL (from folder) | doc | doc | doc | doc |
| Download ALL (into folder) | doc | doc | doc | doc |
| Remove ALL Assets | doc | doc | doc | Not supported by API |
| Remove ALL Albums | doc | doc | doc | Not supported by API |
| Remove Albums by Name Pattern | doc | doc | doc | Not supported by API |
| Rename Albums by Name Pattern | doc | doc | doc | Not supported by API |
| Remove Empty Albums | doc | doc | doc | Not supported by API |
| Remove Duplicates Albums | doc | doc | doc | Not supported by API |
| Merge Duplicates Albums | doc | doc | doc | Not supported by API |
| Remove Orphans Assets | Not supported by API | doc | Not supported by API | Not supported by API |
Note
For more info you can check the feature documentation in below links:
Important
-
NextCloud Photos is available since v4.0.0 using WebDAV-based integration.
-
Google Photos is available since v4.0.0 with partial support due current official API limitations.
Finally, the Tool also contains Other Useful Standalone Features such as:
- Metadata fixing of any Photo Library in your local drive (not necessarily 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 folder's name based on content
Note
For more info you can check the feature documentation in below link:
PhotoMigrator now includes a Web Interface that executes the same CLI arguments under the hood.
Main characteristics:
- Multi-tab UI separated by module:
- Automatic Migration
- Google Takeout
- Google Photos
- Synology Photos
- Immich Photos
- NextCloud Photos
- Other Features
- General/optional arguments available for all tabs.
- Real command preview + execution output in the browser.
- Backend powered by
FastAPI+uvicornon port6078.
Note
You can access to the new Web Interface (demo) on this link:
PhotoMigrator Web Interface (demo)
Username: demo
Password: demo
Before running Docker Compose, install Docker on your host:
-
Windows (recommended): Install Docker Desktop
https://docs.docker.com/desktop/setup/install/windows-install/ -
macOS (recommended): Install Docker Desktop
https://docs.docker.com/desktop/setup/install/mac-install/ -
Linux: Install Docker Engine + Docker Compose plugin
https://docs.docker.com/engine/install/
After installation, verify Docker is working:
docker --version
docker compose versionIf you are on Linux and want to run Docker without sudo, follow:
https://docs.docker.com/engine/install/linux-postinstall/
Create or download to 'docker' folder the following files:
docker/docker-compose.ymldocker/.env
Example .env:
# Timezone
TZ=Europe/Madrid
# <you must find out your PUID/PGID through SSH, run in terminal: id $user. If needed, change $user to the user you created.>
PUID=1001
PGID=1001
# Container Name
CONTAINER_NAME=photomigrator
# Host Port
PORT=6078
PORT_DEV=6071
# Config dir, where the config is stored (host paths)
CONFIG_DIR=../config
# Data dir, where the tool will look for inputs, and save the outputs and intermediate files (host paths)
DATA_DIR=../data
# Volumes dir, other folder that you may want to mount on the tool (host paths)
VOLUMES_DIR=/volume1
# App dir, whith the source code (for docker-compose-env.yml only)
APP_DIR=../
# Comma-separated list of allowed base folders for "Remove Selected" in the web folder picker.
# Any delete request outside these roots will be rejected.
PHOTOMIGRATOR_WEB_DELETE_ROOTS=/app/data,/app/config,/app/volumes
# Max. Lines in buffer for the Web Interface Log panel
PHOTOMIGRATOR_WEB_MAX_JOB_OUTPUT_LINES=100000
# Docker image tag to pull
IMAGE_TAG=latest-stableExample docker-compose.yml:
# PhotoMigrator Web Interface compose file for production.
services:
photomigrator:
image: jaimetur/photomigrator:${IMAGE_TAG}
container_name: ${CONTAINER_NAME}
ports:
- "${PORT}:6078"
env_file:
- .env
volumes:
- ${CONFIG_DIR}:/app/config
- ${DATA_DIR}:/app/data
- ${VOLUMES_DIR}:/app/volumes
restart: unless-stopped
healthcheck:
test: ["CMD", "python", "-c", "import os,sys,urllib.request; port=os.getenv('PORT','6078'); urllib.request.urlopen(f'http://127.0.0.1:{port}/healthz', timeout=5); sys.exit(0)"]
interval: 30s
timeout: 5s
retries: 3
start_period: 30scd docker
docker compose pull
docker compose up -dThen open:
http://localhost:6078
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
- NextCloud Photos Management
- Google 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
- From Web Interface (docker)
Below tables show the pros and cons of each method together with a comparative rating of each one of them for you to decide which 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 systems |
| Docker | ⭐ | ✅ Platform and architecture independent ✅ Easy configuration via docker.config ✅ Automatically pulls latest image if RELEASE_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 | 🔴 | ✅ 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 |
| Web Interface | 🟢⭐ | ✅ Platform and architecture independent ✅ Easy configuration via .env file ✅ Automatically pulls latest image if IMAGE_TAG=latest |
❌ In Windows/MacOS you need to install Docker Desktop |
🟢 Easiest way ⭐ Recommended 🔴 More difficult
| Feature | Binaries (easiest way) |
Docker (balanced) |
Source (more difficult) |
Web Interface (recommended) |
|---|---|---|---|---|
| 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 | 4.5 |
Download the tool either for Linux, MacOS or Windows (for both x64 and arm64 architectures) or Docker version (platform & architecture independent) as you prefer, directly from following links:
Or check the Changelog to choose any specific release.
Note
The Tool is Multi-Platform and Multi-Architecture, and has been designed to be run directly from Windows systems, MacOs or 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 connection 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
The Historical Change Log can be checked in the following link: Changelog
The Planned Roadmap for futures releases can be checked in the following link: Planned Roadmap
By participating in this project, you agree to abide by our Code of Conduct.
Caution
⚠️ The project is under very active development.⚠️ Expect bugs and breaking changes.
If you want to Contribute to this project please, first read the file CONTRIBUTING.md
- Synology Photos Create albums full of precious moments, share your perfectly framed photos, and store them securely on your Synology NAS.
- Immich Photos High performance self-hosted photo and video management solution.
- NextCloud Photos Your memories under your control.
- Google Photos Takeout Helper (GPTH) Script that organizes the Google Takeout archive into one big chronological folder.
- Exiftool Metadata information reader/writer.
I hope this can be useful for any of you. Enjoy it!
(c) 2024-2026 by Jaime Tur (@jaimetur).
Part of this Tool is based on GPTH Tool by TheLastGimbus/Wacheee and v4.x.x by Xentraxx
If you consider that this Tool has helped you, you can also consider donating me with a ☕
I spent a lot of time developing this Tool for free, so donations will contribute to motivate me to continue working on this project 💖
