immichporter 0.0.1

Import photos from various sources to Immich

Immichporter

Google photos to immich importer helper

---

[!WARNING] Still in a early stage. At the moment only exporting from google photos is supported.

Immichporter exports google photos information into a database which can be used to import the information back into immich.

[!IMPORTANT] This tool does not download any images from google photos. It only exports the information into a database.

Use google takeout to export your google photos data and the immich-go tool to import the data into immich. After this you can use immichporter to create all albums and add people to shared albums.

Installation

Using uv (recommended):

uv add immichporter

Or with pip:

pip install immichporter

Usage

# Show help
immichporter --help

# login is required the first time, the session is saved
immichporter gphotos login

# add all albums to the database
immichporter gphotos albums

# add all photos for each album to the database
immichporter gphotos photos
# multiple runs miht be needed until everything is correct!

# see the database with https://sqlitebrowser.org
sqlitebrowser immichporter.db

TODO:

• export albums with photos and people from gphotos (first version)
• import to immich
• improve documentation
• imporve gphotos export stability

Development

To set up the development environment:

# Clone the repository
git clone https://github.com/burgdev/immichporter.git
cd immichporter

# Install development dependencies
make
uv run invoke install # install 'dev' and 'test' dependencies per default, use --all to install all dependencies

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

License

MIT - See LICENSE for details.