Set of tools for importing photo and video files into specified folder organizing them according to the date and time information. Import files and albums from Google Photo is also supported.
- import_photo.py
usage: import_photo.py [-h] [--src-dir SRC_DIR] [--out-dir OUT_DIR]
[--log-file LOG_FILE]
Import photos (*.jpg; *.jpeg) into a specified folder organizing them according to EXIF tags.
optional arguments:
-h, --help show this help message and exit
--src-dir SRC_DIR directory containing photos (*.jpg; *.jpeg)
--out-dir OUT_DIR destination directory
--log-file LOG_FILE output file for imported photos list
- import_video.py
usage: import_video.py [-h] [--src-dir SRC_DIR] [--out-dir OUT_DIR]
[--log-file LOG_FILE]
Import videos (*.mp4; *.mov; *.mpg) into a specified folder organizing them according to "creation_time" information found in any of its media streams.
optional arguments:
-h, --help show this help message and exit
--src-dir SRC_DIR directory containing videos (*.mp4; *.mov; *.mpg)
--out-dir OUT_DIR destination directory
--log-file LOG_FILE output file for imported videos list
- create_albums_metadata.py
usage: create_albums_metadata.py [-h] [--takeout-dir TAKEOUT_DIR]
[--out-dir OUT_DIR]
Create <UUID>.json file for each album with title, date and time, list of files, etc. As an input, it takes metadata.json that is generated by Google Photos.
optional arguments:
-h, --help show this help message and exit
--takeout-dir TAKEOUT_DIR
Google Photos takeout directory
--out-dir OUT_DIR destination directory
- create_albums.py
usage: create_albums.py [-h] [--src-dir SRC_DIR] [--out-dir OUT_DIR]
Copy media files into folders (one folder per album) according to album descriptions provided in <UUID>.json files.
optional arguments:
-h, --help show this help message and exit
--src-dir SRC_DIR directory containing imported photos, videos and albums
metadata files
--out-dir OUT_DIR destination directory for albums
- revert_import.py
usage: revert_import.py [-h] [--files-dir FILES_DIR]
[--log-files LOG_FILES [LOG_FILES ...]]
Delete previously imported files. It uses log files that were generated while importing.
optional arguments:
-h, --help show this help message and exit
--files-dir FILES_DIR
directory with photo and video files
--log-files LOG_FILES [LOG_FILES ...]
log files that were generated during import
- immich_archive_files.py
usage: archive_files.py [-h] [--metadata METADATA] [--immich-url IMMICH_URL] [--api-key API_KEY]
Mark files as archived in Immich
optional arguments:
-h, --help show this help message and exit
--metadata METADATA path to archive metadata file (same format as json for album description)
--immich-url IMMICH_URL
Immich server URL
--api-key API_KEY Immich API key
- immich_create_albums.py
usage: immich_create_albums.py [-h] [--metadata-dir METADATA] [--immich-url IMMICH_URL] [--api-key API_KEY]
Create albums in Immich according to metadata files
optional arguments:
-h, --help show this help message and exit
--metadata-dir METADATA path to directory with album description metadata files
--immich-url IMMICH_URL Immich server URL
--api-key API_KEY Immich API key
import_video.py and create_albums_metadata.py need ffprobe being available via PATH.
It is possible to build a docker image for import_photo.py and import_video.py tools:
docker build --file .\docker\Dockerfile --tag import_files .
docker run -it --rm -v /path/to/source/dir:/source -v /path/to/output/dir:/output -v /path/to/logs/dir:/logs import_files