This tool has been designed to Interact and Manage different Photo Services such as Google Photos, Synology Photos, Immich Photos, NextCloud Photos, Google Takeout & Apple iCloud 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.

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).

Other important feature included in the tool is the iCloud Takeout Fixing.

This feature has been designed to process Apple iCloud Photos privacy exports, recover the original capture dates from Photo Details.csv, assign those dates to the exported assets, and rebuild Albums from Apple CSV manifests.

In this way your Media Library will be ready to be migrated to any other Cloud Photo services without losing important information such as Original date and Albums relationships.

But this feature also helps you to reconstruct the exported library structure in a more usable way, including optional Memories rebuilding when those manifests are present in the export.

The whole process is done in an automatic way and is independent from the cloud-service management modules.

Apart from the Automatic Migration, Google Takeout Fixing, and iCloud Takeout Fixing features, you can also use the tool to manage Google Photos, photo cloud services, and managed local photo libraries.

• Google Photos supports direct upload/download operations through the official API.
• Synology Photos, Immich Photos, and NextCloud Photos provide cloud management and migration operations.
• Local Photos Folder provides the same library-management modules against a managed on-disk library, using No_Albums for physical media and Albums for album membership links.

Currently, the features supported by each service are:

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
  • Organize any local folder by capture date into year, year/month, year-month, or flatten
  • Splitting of assets with and without associated albums
  • Folder structure (customizable) for Albums, cloud No_Albums, and Takeout ALL_PHOTOS master libraries
• Symbolic Links Support for Albums folders
  • Fix Symbolic Links Broken
• Homogenize Albums folder's name based on content

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
  • iCloud Takeout
  • Google Photos
  • Synology Photos
  • Immich Photos
  • NextCloud Photos
  • Local Photos Folder
  • Other Features
• General/optional arguments available for all tabs.
• Automatic Migration and Local Photos Folder workflows support exclusion filters for unwanted folders/files such as @eaDir, .@__thumb, @Recycle, SYNOFILE_THUMB*, SYNOPHOTO_THUMB*, SYNOVIDEO_THUMB*, SYNOPHOTO_FILM*, Thumbs.db, ehthumbs.db, .DS_Store, or ._*.
• Real command preview + execution output in the browser.
• Backend powered by FastAPI + uvicorn on port 6078.

The complete Docker guide for the Web Interface now lives in:

• Deploy Web Interface from Docker

That guide includes:

• Linux, Windows, and macOS instructions
• direct download commands for docker-compose.yml and .env
• a ready-to-use .env that works without mandatory edits for local use
• a clear split between mandatory, recommended, and optional customization

Quick start:

cd docker-web
docker compose pull
docker compose up -d

Then open:

• http://localhost:6078

PhotoMigrator includes two local interactive interfaces in addition to the Web Interface:

• Desktop GUI: a native windowed interface built with tkinter.
• Terminal TUI: an interactive terminal interface built with Textual.

Both interfaces expose the same high-level structure:

• Feature Selector
• Features Config
• General Arguments
• App Settings
• command preview, status panel, and execution log

Default launcher behavior:

• Running PhotoMigrator without arguments tries to open the Desktop GUI first.
• If the GUI cannot be started because tkinter or a graphical display is not available, PhotoMigrator falls back to the Terminal TUI.
• If neither interactive interface can be started, PhotoMigrator falls back to the CLI and shows the arguments descriptions (same output as --help).

Explicit launchers:

• PhotoMigrator --gui opens the Desktop GUI explicitly.
• PhotoMigrator --tui opens the Terminal TUI explicitly.
• PhotoMigrator --configuration-file /path/to/Config.ini can be combined with either launcher, or used on its own, to open the default interactive UI with a different configuration file preloaded.

Config file behavior in GUI/TUI:

• If no explicit configuration path is provided, both interfaces use ./Config.ini from the current execution folder, matching the classic CLI behavior.
• You can also change the file later inside General Arguments > Configuration File.

Typical use:

• Use the Desktop GUI on Windows, macOS, or Linux systems with graphical desktop access.
• Use the Terminal TUI on SSH sessions, server terminals, or environments where a graphical window is not available but the terminal supports interactive rendering.

This Tool is based on commands given through the Command Line Interface (CLI), so it is important to know the syntax of that interface.

PhotoMigrator now also includes an interactive CLI TUI that mirrors the Web Interface structure much more closely:

• Feature Selector with the same top-level modules as the Web Interface
• General Arguments, Features Config, and App Settings views
• Dynamic forms for Automatic Migration, Google Takeout, iCloud Takeout, cloud-service actions, and standalone features
• Multi-account Features Config selectors for Google Photos, Synology Photos, Immich Photos, and NextCloud Photos
• Live command preview and in-terminal execution log panel

Quick launch:

python ./src/PhotoMigrator.py

This now opens the desktop GUI by default.

Force the CLI TUI explicitly:

python ./src/PhotoMigrator.py --tui

Open the desktop GUI explicitly:

python ./src/PhotoMigrator.py --gui

Open either interactive UI with an explicit configuration file:

python ./src/PhotoMigrator.py --gui --configuration-file ./Config.ini
python ./src/PhotoMigrator.py --tui --configuration-file ~/PhotoMigrator/custom.ini

Launcher fallback order when no arguments are provided:

• Desktop GUI
• CLI TUI
• Command-line help (--help)

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
• iCloud Takeout Management
• Google Photos Management
• Synology Photos Management
• Immich Photos Management
• NextCloud Photos Management
• Other Features
• GPTH Tool Pipeline Description
• Docker Deployment Documentation

• Deploy Web Interface from Docker
• Deploy CLI Interface from Docker

There are four different methods to execute this Tool:

• Execute from Compiled Binaries
• Execute from Source Repository
• Deploy Web Interface (from docker)
• Deploy CLI Interface (from 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:

🟢 Easiest way ⭐ Recommended 🔴 More difficult

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:

• Latest Stable Release
• Pre-Release
• All Releases

Or check the Changelog to choose any specific release.

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.

When running the Web Interface in Docker/Compose/Kubernetes, you can also override the same cloud-service keys through environment variables. Supported config keys can be provided directly as KEY=value or through Docker-secret style KEY_FILE=/path/to/secret. Runtime precedence is: environment variable > Config.ini > template default. This is useful for IMMICH_URL, IMMICH_API_KEY_ADMIN, SYNOLOGY_*, NEXTCLOUD_*, GOOGLE_PHOTOS_*, etc.

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.

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 💖