How simulot/immich-go works
Immich-Go is a command-line photo migration and library-management tool. Its main workflow selects a source adapter, discovers and enriches photo assets, then uploads them to an Immich server with metadata and organization preserved. It also supports server-to-server migration, archiving, and stack management. The graph includes the shared file-processing and asset-tracking layer. Some adapter and archive connections are documented in the README rather than shown in full source excerpts; those relationships cite the README.
Main entry points: upload/run.go Upload workflow · rootCmd.go Command router · command.go Immich imports · archive/run.go Archive workflow
Components 17
Command workflows
- CLI entry
main.go - Command router
app/root/rootCmd.go - Upload workflow
app/upload/run.go - Archive workflow
app/archive/run.go - Stack command
app/stack/stack.go
Import sources
- Folder imports
adapters/folder/run.go - Google Photos
adapters/googlePhotos/googlephotos.go - Immich imports
adapters/fromimmich/command.go - Archive folder output
adapters/folder/writeFolder.go
Asset processing
- Asset processing
internal/fileprocessor/processor.go - Asset tracker
internal/assettracker/tracker.go - Grouping and stacks
internal/groups/groups.go
Immich services
- Server connection
app/client.go - Immich API client
immich/client.go - Immich file access
internal/immichfs/immich.go
Other components
- User
- Immich server
Connections 19
- User → CLI entry: runs
main.go - CLI entry → Command router: starts
main.go - Command router → Upload workflow: routes commands
app/root/rootCmd.go - Command router → Archive workflow: routes commands
app/root/rootCmd.go - Command router → Stack command: routes commands
app/root/rootCmd.go - Folder imports → Upload workflow: provides assets
- Google Photos → Upload workflow: provides assets
- Immich imports → Upload workflow: provides assets
- Upload workflow → Asset processing: processes files
app/upload/run.go - Asset processing → Asset tracker: tracks assets
internal/fileprocessor/processor.go - Upload workflow → Grouping and stacks: creates stacks
app/upload/run.go - Stack command → Grouping and stacks: groups assets
app/stack/stack.go - Upload workflow → Server connection: uses connection
- Server connection → Immich API client: creates clients
app/client.go - Immich API client → Immich server: sends API requests
- Immich imports → Immich API client: searches assets
adapters/fromimmich/command.go - Immich imports → Immich file access: reads asset files
adapters/fromimmich/command.go - Archive workflow → Folder imports: selects sources
- Archive workflow → Archive folder output: writes archive