feat: add commands to handle iCloud and Picasa album imports

Author: simulot

adapters/folder/options.go

@@ -103,6 +103,9 @@ func (o *ImportFolderOptions) AddFromFolderFlags(cmd *cobra.Command, parent *cob
 		`/._*`,               // MacOS resource files
 		`.photostructure/`,   // PhotoStructure
 	)
+
+	o.ICloudTakeout = false
+	o.PicasaAlbum = false
 	cmd.Flags().StringVar(&o.ImportIntoAlbum, "into-album", "", "Specify an album to import all files into")
 	cmd.Flags().Var(&o.UsePathAsAlbumName, "folder-as-album", "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")
 	cmd.Flags().StringVar(&o.AlbumNamePathSeparator, "album-path-joiner", " / ", "Specify a string to use when joining multiple folder names to create an album name (e.g. ' ',' - ')")
@@ -130,6 +133,86 @@ func (o *ImportFolderOptions) AddFromFolderFlags(cmd *cobra.Command, parent *cob
 	}
 }
 
+func (o *ImportFolderOptions) AddFromICloudFlags(cmd *cobra.Command, parent *cobra.Command) {
+	o.ManageHEICJPG = filters.HeicJpgNothing
+	o.ManageRawJPG = filters.RawJPGNothing
+	o.ManageBurst = filters.BurstNothing
+	o.Recursive = true
+	o.SupportedMedia = filetypes.DefaultSupportedMedia
+	o.UsePathAsAlbumName = FolderModeNone
+	o.BannedFiles, _ = namematcher.New(
+		`@eaDir/`,
+		`@__thumb/`,          // QNAP
+		`SYNOFILE_THUMB_*.*`, // SYNOLOGY
+		`Lightroom Catalog/`, // LR
+		`thumbnails/`,        // Android photo
+		`.DS_Store/`,         // Mac OS custom attributes
+		`/._*`,               // MacOS resource files
+		`.photostructure/`,   // PhotoStructure
+	)
+
+	o.ICloudTakeout = true
+	o.PicasaAlbum = false
+	cmd.Flags().StringVar(&o.ImportIntoAlbum, "into-album", "", "Specify an album to import all files into")
+
+	cmd.Flags().Var(&o.BannedFiles, "ban-file", "Exclude a file based on a pattern (case-insensitive). Can be specified multiple times.")
+	cmd.Flags().StringSliceVar(&o.Tags, "tag", nil, "Add tags to the imported assets. Can be specified multiple times. Hierarchy is supported using a / separator (e.g. 'tag1/subtag1')")
+	cmd.Flags().BoolVar(&o.SessionTag, "session-tag", false, "Tag uploaded photos with a tag \"{immich-go}/YYYY-MM-DD HH-MM-SS\"")
+
+	cliflags.AddInclusionFlags(cmd, &o.InclusionFlags)
+	cmd.Flags().BoolVar(&o.TakeDateFromFilename, "date-from-name", true, "Use the date from the filename if the date isn't available in the metadata (Only for jpg, mp4, heic, dng, cr2, cr3, arw, raf, nef, mov)")
+
+	if parent != nil && parent.Name() == "upload" {
+		cmd.Flags().Var(&o.ManageHEICJPG, "manage-heic-jpeg", "Manage coupled HEIC and JPEG files. Possible values: NoStack, KeepHeic, KeepJPG, StackCoverHeic, StackCoverJPG")
+		cmd.Flags().Var(&o.ManageRawJPG, "manage-raw-jpeg", "Manage coupled RAW and JPEG files. Possible values: NoStack, KeepRaw, KeepJPG, StackCoverRaw, StackCoverJPG")
+		cmd.Flags().Var(&o.ManageBurst, "manage-burst", "Manage burst photos. Possible values: NoStack, Stack, StackKeepRaw, StackKeepJPEG")
+	}
+}
+
+func (o *ImportFolderOptions) AddFromPicasaFlags(cmd *cobra.Command, parent *cobra.Command) {
+	o.ManageHEICJPG = filters.HeicJpgNothing
+	o.ManageRawJPG = filters.RawJPGNothing
+	o.ManageBurst = filters.BurstNothing
+	o.Recursive = true
+	o.SupportedMedia = filetypes.DefaultSupportedMedia
+	o.UsePathAsAlbumName = FolderModeNone
+	o.BannedFiles, _ = namematcher.New(
+		`@eaDir/`,
+		`@__thumb/`,          // QNAP
+		`SYNOFILE_THUMB_*.*`, // SYNOLOGY
+		`Lightroom Catalog/`, // LR
+		`thumbnails/`,        // Android photo
+		`.DS_Store/`,         // Mac OS custom attributes
+		`/._*`,               // MacOS resource files
+		`.photostructure/`,   // PhotoStructure
+	)
+
+	o.ICloudTakeout = false
+	o.PicasaAlbum = true
+	cmd.Flags().StringVar(&o.ImportIntoAlbum, "into-album", "", "Specify an album to import all files into")
+	cmd.Flags().Var(&o.UsePathAsAlbumName, "folder-as-album", "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")
+	cmd.Flags().StringVar(&o.AlbumNamePathSeparator, "album-path-joiner", " / ", "Specify a string to use when joining multiple folder names to create an album name (e.g. ' ',' - ')")
+	cmd.Flags().BoolVar(&o.Recursive, "recursive", true, "Explore the folder and all its sub-folders")
+	cmd.Flags().Var(&o.BannedFiles, "ban-file", "Exclude a file based on a pattern (case-insensitive). Can be specified multiple times.")
+	cmd.Flags().BoolVar(&o.IgnoreSideCarFiles, "ignore-sidecar-files", false, "Don't upload sidecar with the photo.")
+
+	cmd.Flags().StringSliceVar(&o.Tags, "tag", nil, "Add tags to the imported assets. Can be specified multiple times. Hierarchy is supported using a / separator (e.g. 'tag1/subtag1')")
+	cmd.Flags().BoolVar(&o.FolderAsTags, "folder-as-tags", false, "Use the folder structure as tags, (ex: the file  holiday/summer 2024/file.jpg will have the tag holiday/summer 2024)")
+	cmd.Flags().BoolVar(&o.SessionTag, "session-tag", false, "Tag uploaded photos with a tag \"{immich-go}/YYYY-MM-DD HH-MM-SS\"")
+
+	cliflags.AddInclusionFlags(cmd, &o.InclusionFlags)
+	cmd.Flags().BoolVar(&o.TakeDateFromFilename, "date-from-name", true, "Use the date from the filename if the date isn't available in the metadata (Only for jpg, mp4, heic, dng, cr2, cr3, arw, raf, nef, mov)")
+
+	// exif.AddExifToolFlags(cmd, &o.ExifToolFlags) // disabled for now
+
+	// upload specific flags, not for archive to folder
+	if parent != nil && parent.Name() == "upload" {
+		cmd.Flags().Var(&o.ManageHEICJPG, "manage-heic-jpeg", "Manage coupled HEIC and JPEG files. Possible values: NoStack, KeepHeic, KeepJPG, StackCoverHeic, StackCoverJPG")
+		cmd.Flags().Var(&o.ManageRawJPG, "manage-raw-jpeg", "Manage coupled RAW and JPEG files. Possible values: NoStack, KeepRaw, KeepJPG, StackCoverRaw, StackCoverJPG")
+		cmd.Flags().Var(&o.ManageBurst, "manage-burst", "Manage burst photos. Possible values: NoStack, Stack, StackKeepRaw, StackKeepJPEG")
+	}
+}
+
 // AlbumFolderMode represents the mode in which album folders are organized.
 // Implement the interface pflag.Value