immich-go v0.23.0-RC3 🏗️ user feedback included 🏗️

Thank you to all the users who have tested immich-go and shared your feedback. Your input is essential for finding and fixing issues and making the tool better.

Special thanks to @shaankhosla who have found and fixed an issue with Apple's series of images with the same name #554

My gratitude to users who found problems with the latest RC

• @Koli0842 intensively tested the RC2 and identified problems with GPS Timestamps #560, now fixed.
• @J3a90r Found a "bad request" (not fixed yet)... Need more logs from you
• @samholton Detected a problem with album names (need more logs from you).

New Contributors

• @shaankhosla made their first contribution in #558

Full Changelog: v0.23.0-RC2...v0.23.0-RC3

immich-go v0.23.0-RC2 🏗️ Polishing 🏗️

Hi everyone,

Thank you to all the users who have tested immich-go and shared your feedback. Your input is essential for finding and fixing issues and making the tool better.

Here’s what’s new in this version:

• Simplified Date Handling: The new --date-from-name flag allows immich-go to infer capture dates from file names or paths when metadata is missing. Immich-go now opens files directly to read metadata without relying on external tools. Supported file types include: .jpg, .mp4, .heic, .dng, .cr2, and .cr3.
• Removed Dependency on ExifTool: immich-go no longer requires ExifTool for metadata extraction, making the setup simpler and more lightweight.
• Bug Fix: --folder-as-album Improvements: When using --folder-as-album with the current folder (.), immich-go now correctly uses the actual folder name instead of . for album creation.
• Bug Fix: --date-from-name Enhancement: The --date-from-name flag now works seamlessly when the current folder (.) itself is a date, ensuring better handling of date inference in such cases.

known bug

• archive files with same name can be overwritten in the archive
• Stack error with MP~2 files

Please keep testing and let me know what you think. Your help is key to making immich-go reliable and easy to use.
Thank you for your support! 🚀

— Simulot

Release v0.23.0-RC 🏗️ Almost there 🏗️

This version is a complete rewrite of the original immich-go project. It is designed to be more efficient, more reliable, and easier to use. It is also more flexible, with more options and features.

What's new:

• archive
• tags

I'd love to hear your feedback!

Share your thoughts:

• Let me know what you think in the discussion, or on Discord.
• If you're up for it, please take a look at the README file and let me know if you spot any typos or unclear sections.

Release v0.23.0-alpha6 the tags release 🏗️ Work in progress 🏗️

Release v0.23.0-alpha6 the tags release 🏗️ Work in progress 🏗️

New features

Folder import tags
Its now possible to assign tags to photos and videos:

--folder-as-tags                     Use the folder structure as tags, (ex: the file "holidays/summer 2024/file.jpg" get the tag holidays/summer 2024)
--session-tag                        Tag uploaded photos with a tag "{immich-go}/YYYY-MM-DD HH-MM-SS"
--tag strings                        Add tags to the imported assets. Can be specified multiple times. Hierarchy is supported using a / separator (e.g. 'tag1/subtag1')

The session tag is useful to identify all photos imported at the same time. It's easy to remove them from the tag screen

Google photos import tags

--takeout-tag                        Tag uploaded photos with the takeout file name: "{takeout}/takeout-YYYYMMDDTHHMMSSZ"
--session-tag                        Tag uploaded photos with a tag "{immich-go}/YYYY-MM-DD HH-MM-SS"
--tag strings                        Add tags to the imported assets. Can be specified multiple times. Hierarchy is supported using a / separator (e.g. 'tag1/subtag1')

Breaking change since v0.23.0-alpha5

A metadata file is created withe same name as the main file, but with the extension .json. The XMP file is left untouched.

Fixes

• #533 RAW file metadata
  The efforts for determining the capture date from the file name are useless.
  Now the file date is provided to Immich as if the file was dropped on the immich's page.
  The --capture-date-method is now set to NONE by default.
• [#534] Errors on windows

Release 0.23.0-alpha5 🏗️ Work in progress 🏗️ Archiving immich

Release 0.23.0-alpha5 🏗️ Work in progress 🏗️

🚨 New binaries for Windows!

New features

The command archive --from-immich archives the user content from an Immich into a folder structure

Archive photos from Immich

Usage:
  immich-go archive from-immich [from-flags] [flags]

Flags:
      --from-album strings             Get assets only from those albums, can be used multiple times
      --from-api-key string            API Key
      --from-api-trace                 Enable trace of api calls
      --from-client-timeout duration   Set server calls timeout (default 5m0s)
      --from-date-range date-range     Get assets only within this date range (fromat: YYYY[-MM[-DD[,YYYY-MM-DD]]]) (default unset)
      --from-server string             Immich server address (example http://your-ip:2283 or https://your-domain)
      --from-skip-verify-ssl           Skip SSL verification
  -h, --help                           help for from-immich

Global Flags:
  -l, --log-file string          Write log messages into the file
      --log-level string         Log level (DEBUG|INFO|WARN|ERROR), default INFO (default "INFO")
      --log-type string          Log formatted  as text of JSON file (default "text")
  -w, --write-to-folder string   Path where to write the archive

Comming soon:
--minimal-rating
--from-favorite
--from-trashed
--from-archived

The command upload --from-immich upload the user content from another Immich

This command accepts the same flags as the archive --from-immich command.
It preserves albums and tags from the source Immich.

Release v0.23.0-alpha4 🏗️ Work in progress 🏗️

New features

New command archive

This command aims is to store photos and videos into a plain folder structure. The folder structure is YYYY/YYYY-MM/files, as following:

tree .
.
├── 2011
│   └── 2011-04
│       ├── 20110430.CR2
│       ├── 20110430.CR2.xmp
│       ├── 20110430.jpg
│       ├── 20110430.jpg.xmp
│       ├── IMG_2477.CR2
│       ├── IMG_2477.CR2.xmp
│       ├── IMG_2478.CR2
│       ├── IMG_2478.CR2.xmp
│       ├── IMG_2479.CR2
│       └── IMG_2479.CR2.xmp
└── 2023
    ├── 2023-06
    │   ├── PXL_20230607_063000139.jpg
    │   └── PXL_20230607_063000139.jpg.xmp
    └── 2023-10
        ├── PXL_20231006_063029647.jpg
        ├── PXL_20231006_063029647.jpg.xmp
        ├── PXL_20231006_063851485.jpg
        └── PXL_20231006_063851485.jpg.xmp

XMP files present in the source folder are copied in the destination folder.
Google Photos takeout JSON files are translated into customized XMP files and copied in the destination folder.
Those XMP files use a custom schema to store the Google Photos metadata:

<?xpacket begin='?' id='W5M0MpCehiHzreSzNTczkc9d'?>
<x:xmpmeta xmlns:x="adobe:ns:meta/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:exif="http://ns.adobe.com/exif/1.0/" xmlns:xmp="http://ns.adobe.com/xap/1.0/" xmlns:tiff="http://ns.adobe.com/tiff/1.0/" xmlns:digikam="http://www.digikam.org/ns/1.0/" xmlns:immichgo="http://ns.immich-go.com/immich-go/1.0/" x:xmptk="immich-go version:dev, commit:none, date:unknown">
  <rdf:RDF>
    <rdf:Description>
      <immichgo:ImmichGoProperties>
        <immichgo:title>This is a title</immichgo:title>
        <immichgo:DateTimeOriginal>2023-10-10T01:11:00.000-04:00</immichgo:DateTimeOriginal>
        <immichgo:trashed>False</immichgo:trashed>
        <immichgo:archived>False</immichgo:archived>
        <immichgo:fromPartner>False</immichgo:fromPartner>
        <immichgo:favorite>True</immichgo:favorite>
        <immichgo:rating>3</immichgo:rating>
        <immichgo:albums>
          <rdf:Bag>
            <rdf:Li>
              <immichgo:album>
                <immichgo:title>Vacation 2024</immichgo:title>
                <immichgo:description>Vacation 2024 hawaii and more</immichgo:description>
                <immichgo:latitude>19,49.23661N</immichgo:latitude>
                <immichgo:longitude>155,28.39525W</immichgo:longitude>
              </immichgo:album>
            </rdf:Li>
          </rdf:Bag>
        </immichgo:albums>
      </immichgo:ImmichGoProperties>
    </rdf:Description>
  </rdf:RDF>
</x:xmpmeta>
<?xpacket end='w'?>

The general syntax is:

.\immich-go archive from-xxx [from-xxx flags...] --write-to-folder <destination> <source> 

The command archive --from-google-photos archives a Google Photos takeout into a folder structure

This command create a folder structure in /path/to/destination with the result of the takeout analysis.
The resulting folder structure can be re-imported into immich-go with the command upload from-google-photo path/to/archived-folder.

The command archive --from- archives a Google Photos takeout into a folder structure

Example:

.\immich-go archive from-google-photos  --include-partner  --write-to-folder /path/to/destination /path/to/takeout*.zip

Coming soon:

• archiving an immich server into a folder.

Handling of scanned photos by Epson FastFoto

• --manage-epson-fastfoto Manage Epson FastFoto file (default: false)
  
  Group scanned photos in stacks
  • Scan_0001.jpg Original photo
  • Scan_0001_a.jpg Enhanced photo, the cover of the stack
  • Scan_0001_b.jpg Back of the photo

Release 0.23.0-alpha3 🏗️ Work in progress 🏗️ stacks are back

The code refactoring continue. Better code, less bugs, few features...

New features

• --manage-burst=BurstFlag Manage burst photos. Possible values are:

  • StackKeepRaw Discard JPEG files, and stack the RAW files (default)
  • StackKeepJPEG Discard RAW files, and stack the JPEG files
  • Stack Stack all photos, RAW and JPEG photos are imported in the same stack

• --manage-heic-jpeg=HeicJpgFlag Manage coupled HEIC and JPEG files. Possible values:

  • KeepHeic Keep only the HEIC files (default)
  • KeepJPG Keep only the JPEG files
  • StackCoverHeic Stack both, the HEIC file is the cover
  • StackCoverJPG Stack both, the JPEG file is the cover

• --manage-raw-jpeg=RawJPGFlag Manage coupled RAW and JPEG files. Possible values:

  • KeepRaw Keep only the RAW files (default)
  • KeepJPG Keep only the JPEG files
  • StackCoverRaw Stack both, the RAW file is the cover
  • StackCoverJPG Stack both, the JPEG file is the cover

Full Changelog: 0.21.2...0.23.0-alpha3

0.22.1

Changelog

• 7ee54ba "Update releases.md to include Release 0.22.0 with new features, changes, and contributors" (#459)
• be10802 Add new AutoArchive option (#450)
• 6cd230f Fix "reason" field not being populated by correct album title when use-full-path-album-name was used (#457)
• ce79f99 Fix incorrect argument description (#456)
• 726a523 Incompatible with Immich v1.118 Fixes #509
• 785f61a Incompatible with Immich v1.118 Fixes #509
• 3598281 Merge branch 'simulot/issue509' of github.com:simulot/immich-go into simulot/issue509
• 7f517ba Update README.md, google-takeout.md, and motivation.md (#454)

v0.23.0-alpha2 better logs

🏗️ Work in progress 🏗️

This an early version of immich-go version v0.23.0-alpha2
Yes, v0.23.0-alpha2, and not v1.0.0-alpha2. Let's stick to the semantic versioning.

• better logging
  • log level are effectives
  • adoption of the structured log package
  • the level DEBUG give file details and metadata
• colored log on screen
• clear separation between folder import and google import
• adoption of the linux convention of double dashes flags
• priority of EXIF data over file name for date capture
• code restructuration to enable further possibilities
  • Upload from Picasa
  • Exporting of google photos archive as a folder

Upload from folder options

Upload photos from a folder

Usage:
  immich-go upload from-folder [flags] <path>...

Flags:
      --album-path-joiner string           Specify a string to use when joining multiple folder names to create an album name (e.g. ' ',' - ') (default " / ")
      --ban-file FileList                  Exclude a file based on a pattern (case-insensitive). Can be specified multiple times. (default '@eaDir/', '@__thumb/', 'SYNOFILE_THUMB_*.*', 'Lightroom Catalog/', 'thumbnails/', '.DS_Store/')
      --capture-date-method DateMethod     Specify the method to determine the capture date when not provided in a sidecar file. Options: NONE (do not attempt to determine), FILENAME (extract from filename), EXIF (extract from EXIF metadata), FILENAME-EXIF (try filename first, then EXIF), EXIF-FILENAME (try EXIF first, then filename) (default EXIF-FILENAME)
      --date-range date-range              Only import photos taken within the specified date range (default unset)
      --exclude-extensions ExtensionList   Comma-separated list of extension to exclude. (e.g. .gif,.PM) (default: none)
      --exiftool-enabled                   Enable the use of the external 'exiftool' program (if installed and available in the system path) to extract EXIF metadata
      --exiftool-path string               Path to the ExifTool executable (default: search in system's PATH)
      --exiftool-timezone timezone         Timezone to use when parsing exif timestamps without timezone Options: LOCAL (use the system's local timezone), UTC (use UTC timezone), or a valid timezone name (e.g. America/New_York) (default Local)
      --filename-timezone timezone         Specify the timezone to use when detecting the date from the filename. Options: Local (use the system's local timezone), UTC (use UTC timezone), or a valid timezone name (e.g. America/New_York) (default Local)
      --folder-as-album folderMode         Import all files in albums defined by the folder structure. Can be set to 'FOLDER' to use the folder name as the album name, or 'PATH' to use the full path as the album name (default NONE)
  -h, --help                               help for from-folder
      --ignore-sidecar-files               Don't upload sidecar with the photo.
      --include-extensions ExtensionList   Comma-separated list of extension to include. (e.g. .jpg,.heic) (default: all)
      --into-album string                  Specify an album to import all files into
      --recursive                          Explore the folder and all its sub-folders (default true)

Global Flags:
      --api string                Immich api endpoint (example http://container_ip:3301)
  -k, --api-key string            API Key
      --api-trace                 Enable trace of api calls
      --client-timeout duration   Set server calls timeout (default 5m0s)
      --device-uuid string        Set a device UUID (default "gl65")
      --dry-run                   Simulate all actions
  -l, --log-file string           Write log messages into the file
      --log-level string          Log level (DEBUG|INFO|WARN|ERROR), default INFO (default "INFO")
      --log-type string           Log formatted  as text of JSON file (default "text")
      --no-ui                     Disable the user interface
  -s, --server string             Immich server address (example http://your-ip:2283 or https://your-domain)
      --skip-verify-ssl           Skip SSL verification
      --time-zone string          Override the system time zone

Upload from a google-photos

Upload photos either from a zipped Google Photos takeout or decompressed archive

Usage:
  immich-go upload from-google-photos [flags] <takeout-*.zip> | <takeout-folder>

Flags:
      --ban-file FileList                  Exclude a file based on a pattern (case-insensitive). Can be specified multiple times.
      --date-range date-range              Only import photos taken within the specified date range (default unset)
      --exclude-extensions ExtensionList   Comma-separated list of extension to exclude. (e.g. .gif,.PM) (default: none)
      --from-album-name string             Only import photos from the specified Google Photos album
  -h, --help                               help for from-google-photos
  -a, --include-archived                   Import archived Google Photos (default true)
      --include-extensions ExtensionList   Comma-separated list of extension to include. (e.g. .jpg,.heic) (default: all)
  -p, --include-partner                    Import photos from your partner's Google Photos account (default true)
  -t, --include-trashed                    Import photos that are marked as trashed in Google Photos
  -u, --include-unmatched                  Import photos that do not have a matching JSON file in the takeout
      --include-untitled-albums            Include photos from albums without a title in the import process
      --partner-shared-album string        Add partner's photo to the specified album name
      --sync-albums                        Automatically create albums in Immich that match the albums in your Google Photos takeout (default true)

Global Flags:
      --api string                Immich api endpoint (example http://container_ip:3301)
  -k, --api-key string            API Key
      --api-trace                 Enable trace of api calls
      --client-timeout duration   Set server calls timeout (default 5m0s)
      --device-uuid string        Set a device UUID (default "gl65")
      --dry-run                   Simulate all actions
  -l, --log-file string           Write log messages into the file
      --log-level string          Log level (DEBUG|INFO|WARN|ERROR), default INFO (default "INFO")
      --log-type string           Log formatted  as text of JSON file (default "text")
      --no-ui                     Disable the user interface
  -s, --server string             Immich server address (example http://your-ip:2283 or https://your-domain)
      --skip-verify-ssl           Skip SSL verification
      --time-zone string          Override the system time zone

0.22.0

Many thanks to @maybeanerd for their meticulous proofreading of the documentation files.

New feature: Use the full image path as album name

Thanks to @giejay for their contribution
When the -use-full-path-album-name option is enabled, photos are added to a new album named after their full file path.
The path separator can be replaced using the -album-name-path-separator=CHAR

New feature: google photos archived photos are imported as immich archive by default

Thanks to @Alex1607 for their contribution
Use the option -auto-archive=FALSE to disable this feature.

What's Changed

• fix Takeout zip is unsupported file type #357 by @simulot in #415
• docs: fix typos in readme by @maybeanerd in #421
• Program errors out due to no ping API response despite API responding by @simulot in #431
• remove "GetJobs" call from API traces by @simulot in #442
• Add support for -use-full-path-album-name to be able to use the full path to the file as album name/title by @giejay in #444
• Documentation-update by @simulot in #446
• Add new AutoArchive option by @Alex1607 in #450
• Update README.md, google-takeout.md, and motivation.md by @aaronjrodrigues in #454

New Contributors

• @maybeanerd made their first contribution in #421
• @giejay made their first contribution in #444
• @Alex1607 made their first contribution in #450

Full Changelog: 0.21.0...0.22.0