immich-go(1)

📦 version 0.32.0, in ubuntu stonking

💖 immich-go(1) — the upload-from-google-photos glow-up 💖

okay bestie, so this is a page from the immich-go manual — section 1, the general commands zone. And specifically?? It's the upload from Google Photos command, and it's about to become your whole personality. 🦋

✨ NAME ✨

immich-go-upload-from-google-photos — upload photos either from a zipped Google Photos takeout or a decompressed archive. no cap. that's the whole job. 🎀

✨ SYNOPSIS ✨

immich-go upload from-google-photos [flags]  |

(yeah there's a little dangling | at the end, that's just how it's written, we don't ask questions, we respect the source material 🙈)

✨ DESCRIPTION ✨

Upload photos either from a zipped Google Photos takeout or a decompressed archive. That's it, that's the vibe. You got a takeout, you point this at it, the photos go up. 🌸

✨ OPTIONS ✨

okay this is the part where the girlies get choices. Every single one, in order, no skips:

  • --ban-file='@eaDir/', '@__thumb/', 'SYNOFILETHUMB.', 'Lightroom Catalog/', 'thumbnails/', '.DSStore', '/.*', '.Spotlight-V100/', '.photostructure/', 'Recently Deleted/' — exclude a file based on a pattern (case-insensitive, lowercase energy only). Can be specified multiple times. 🚫
  • --date-range=unset — only import photos taken inside the date range you name. time traveler behavior. 🕰️
  • --exclude-extensions= — comma-separated list of extensions to exclude. (e.g. .gif,.PM) (default: none). keep the gross ones OUT. 😤
  • --from-album-name="" — only import photos from this one specific Google Photos album, bestie. so loyal. 💅
  • -h, --help[=false] — help for from-google-photos. the classic. the icon. 👑
  • -a, --include-archived[=true] — import archived Google Photos too. the hidden ones get their moment. 📦
  • --include-extensions= — comma-separated list of extensions to include. (e.g. .jpg,.heic) (default: all). picky eating but make it file formats. 🍓
  • -p, --include-partner[=true] — import photos from your partner's Google Photos account. shared account?? shared slay. 🫶
  • -t, --include-trashed[=false] — import photos that are marked as trashed in Google Photos. rescuing them from the bin, literally. 🗑️✨
  • --include-type= — a single file type to include. (VIDEO or IMAGE) (default: all). one type only, we're being decisive today. 🎬
  • -u, --include-unmatched[=false] — import photos that do not have a matching JSON file in the takeout. the ones that came alone. no plus-one. 😭
  • --include-untitled-albums[=false] — include photos from albums that have no title in the import process. nameless but not blameless. 🙈
  • --partner-shared-album="" — add your partner's photo to the album name you specify here. 💜
  • --people-tag[=true] — tag uploaded photos with tags like "people/name" found in the JSON file. name-drop era. 🏷️
  • --sync-albums[=true] — automatically create albums in Immich that match the albums in your Google Photos takeout. matching set. iconic. 🎀
  • --takeout-tag[=true] — tag uploaded photos with a tag formatted "{takeout}/takeout-YYYYMMDDTHHMMSSZ". stamped and dated, periodt. ⏰

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

these came from the parent command, they're the family heirlooms, and they apply here too:

  • --admin-api-key="" — Admin's API Key for managing the server's jobs. 🔑
  • -k, --api-key="" — API Key. your all-access pass. 💳
  • --api-trace[=false] — enable trace of api calls. watch everything happen live, nosy queen behavior. 👀
  • --client-timeout=20m0s — set the server calls timeout. ⏳
  • --concurrent-tasks=16 — number of concurrent tasks, and it has to be between 1 and 20. multitasking icon. 🔥
  • --config="" — config file (default is ./immich-go.yaml). 🗂️
  • --device-uuid="framework" — set a device UUID. give your device a name, main character energy. 📱
  • --dry-run[=false] — simulate all actions. the rehearsal. the dress run. nothing is real yet, bestie. 🎭
  • -l, --log-file="" — write log messages into the file. receipts, on file, literally. 🧾
  • --log-level="INFO" — log level, one of (DEBUG|INFO|WARN|ERROR), default INFO. choose your drama level. 📢
  • --log-type="text" — log formatted as text or JSON file. ✍️
  • --manage-burst=NoStack — manage burst photos. Possible values: NoStack, Stack, StackKeepRaw, StackKeepJPEG. 💥
  • --manage-epson-fastfoto[=false] — manage Epson FastFoto file (default: false). 🖨️
  • --manage-heic-jpeg=NoStack — manage coupled HEIC and JPEG files. Possible values: NoStack, KeepHeic, KeepJPG, StackCoverHeic, StackCoverJPG. 🖼️
  • --manage-raw-jpeg=NoStack — manage coupled RAW and JPEG files. Possible values: NoStack, KeepRaw, KeepJPG, StackCoverRaw, StackCoverJPG. 📷
  • --no-ui[=false] — disable the user interface. no visuals, just vibes. 🫥
  • --on-errors=stop — what to do when an error occurs: stop, continue, or accept N errors at max. decide your coping strategy in advance. 🚨
  • --overwrite[=false] — always overwrite files on the server with local versions. ⚠️ this one is not kidding around, it will replace what's already there.
  • --pause-immich-jobs[=true] — pause Immich background jobs during upload operations. hold everything, we're uploading. ✋
  • --save-config[=false] — save the configuration to immich-go.yaml. write it down so you don't forget. 📝
  • -s, --server="" — Immich server address (example http://your-ip:2283 or https://your-domain). where the photos are going. the destination. the venue. 🏠
  • --session-tag[=false] — tag uploaded photos with a tag "{immich-go}/YYYY-MM-DD HH-MM-SS". timestamp slay. 🕐
  • --skip-verify-ssl[=false] — skip SSL verification. 😬
  • --tag=[] — add tags to the imported assets. Can be specified multiple times. Hierarchy is supported using a / separator (e.g. 'tag1/subtag1'). 🏷️
  • --time-zone="" — override the system time zone. 🌍

✨ SEE ALSO ✨

✨ HISTORY ✨

28-Mar-2026 — Auto generated by spf13/cobra. 🤖

💖 and that's the whole page bestie!! this fine piece of documentation was Auto generated by spf13/cobra, dated Mar 2026, footer and all — we just made it cute. now go upload your photos. slay. 💅✨🦋
📦 where this page comes from