[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-71457":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":33,"readmeContent":34,"aiSummary":35,"trendingCount":16,"starSnapshotCount":16,"syncStatus":36,"lastSyncTime":37,"discoverSource":38},71457,"immich-go","simulot\u002Fimmich-go","simulot","An alternative to the immich-CLI command that doesn't depend on nodejs installation. It tries its best for importing google photos takeout archives.","",null,"Go",6332,215,21,204,0,23,60,196,69,38,"GNU Affero General Public License v3.0",false,"main",true,[27,28,29,30,31,32],"golang","google","immich","immich-cli","photos","takeout","2026-06-12 02:02:52","# Immich-Go: Upload Your Photos to Your Immich Server\n\n**Immich-Go** is an open-source tool designed to streamline uploading large photo collections to your self-hosted Immich server.\n\n> ⚠️ This is an early version, not yet extensively tested\u003Cbr>\n> ⚠️ Keep a backup copy of your files for safety\u003Cbr>\n\n## 🌟 Key Features\n\n- **Simple Installation**: No NodeJS or Docker required\n- **Multiple Sources**: Upload from Google Photos Takeouts, iCloud, local folders, ZIP archives, and other Immich servers\n- **Large Collections**: Successfully handles 100,000+ photos\n- **Smart Management**: Duplicate detection, burst photo stacking, RAW+JPEG handling\n- **Cross-Platform**: Available for Windows, macOS, Linux, and FreeBSD\n\n## 🚀 Quick Start\n\n### 1. Install Immich-Go\nDownload the pre-built binary for your system from the [GitHub releases page](https:\u002F\u002Fgithub.com\u002Fsimulot\u002Fimmich-go\u002Freleases).\n\n### 2. Basic Usage\n```bash\n# Upload photos from a local folder\nimmich-go upload from-folder --server=http:\u002F\u002Fyour-ip:2283 --api-key=your-api-key \u002Fpath\u002Fto\u002Fyour\u002Fphotos\n\n# Upload Google Photos takeout\nimmich-go upload from-google-photos --server=http:\u002F\u002Fyour-ip:2283 --api-key=your-api-key \u002Fpath\u002Fto\u002Ftakeout-*.zip\n\n# Archive photos from Immich server\nimmich-go archive from-immich --from-server=http:\u002F\u002Fyour-ip:2283 --from-api-key=your-api-key --write-to-folder=\u002Fpath\u002Fto\u002Farchive\n```\n\n### 3. Requirements\n- A running Immich server with API access\n- API key with appropriate permissions ([see full list](docs\u002Finstallation.md#api-permissions))\n\n> ⚠️ **Breaking Change**: API keys must now include the `asset.copy` and `asset.delete` permissions in addition to previously required permissions. Please update your API keys accordingly.\n\n## 🙈 Skip System Files\n\n- Use `--ban-file` to exclude junk artifacts. Patterns ending with `\u002F` apply to directories (for example, `--ban-file .Spotlight-V100\u002F`), while patterns without the trailing slash apply to individual files (for example, `--ban-file .DS_Store`).\n- Immich-Go ships with sensible defaults that already skip common clutter such as `@eaDir\u002F`, `@__thumb\u002F`, `SYNOFILE_THUMB_*.*`, `Lightroom Catalog\u002F`, `thumbnails\u002F`, `.DS_Store`, `\u002F._*`, `.Spotlight-V100\u002F`, `.photostructure\u002F`, and `Recently Deleted\u002F`.\n- Add additional patterns as needed to keep uploads focused on real photos. See the [banned files reference](docs\u002Ftechnical.md#banned-files) for details.\n\n## 📚 Documentation\n\n| Topic | Description |\n|-------|-------------|\n| [Installation](docs\u002Finstallation.md) | Detailed installation instructions for all platforms |\n| [Commands](docs\u002Fcommands\u002F) | Complete command reference and options |\n| [Configuration](docs\u002Fconfiguration.md) | Configuration options and environment variables |\n| [Examples](docs\u002Fexamples.md) | Common use cases and practical examples |\n| [Best Practices](docs\u002Fbest-practices.md) | Tips for optimal performance and reliability |\n| [Technical Details](docs\u002Ftechnical.md) | File processing, metadata handling, and advanced features |\n| [Upload Commands Overview](docs\u002Fupload-commands-overview.md) | How `immich-go` processes files from different sources |\n| [Release Notes](docs\u002Freleases\u002F) | Version history and release notes |\n\n## ✨ How immich-go Works\n\n`immich-go` offers a versatile set of commands to handle your photo and video uploads. Whether you're uploading from a simple folder, migrating from a Google Photos Takeout, or transferring assets between Immich servers, the tool provides intelligent features to preserve your metadata and organization.\n\nHere's a brief overview of the main upload commands:\n\n*   **`from-folder`**: The basic command for uploading from any local folder. It can create albums from your directory structure and read XMP sidecar files.\n*   **`from-google-photos`**: A powerful command to migrate from a Google Photos Takeout. It intelligently matches photos with their JSON metadata to preserve albums, descriptions, and locations.\n*   **`from-immich`**: A server-to-server migration tool that allows you to copy assets between two Immich instances with fine-grained filtering.\n*   **`from-picasa`**: A specialized version of `from-folder` that automatically reads `.picasa.ini` files to restore your Picasa album organization.\n*   **`from-icloud`**: Another specialized command that handles the complexity of an iCloud Photos takeout, correctly identifying creation dates and album structures from the included CSV files.\n\n### Leveraging Immich's Features\n\n`immich-go` is more than just an uploader; it intelligently interacts with the Immich server to preserve your library's structure:\n\n*   **Albums and Tags**: Automatically creates albums and tags on the server to match your source organization.\n*   **Stacking**: Groups related images, like RAW+JPEG pairs or photo bursts, into stacks.\n*   **Duplicate Detection**: Avoids re-uploading files that already exist on the server.\n*   **Efficient Uploads**: Can pause Immich's background jobs (like thumbnailing) during an upload for better performance.\n\nFor a detailed explanation of how each upload command works, please see the [Upload Commands Overview](docs\u002Fupload-commands-overview.md).\n\n## 🎯 Popular Use Cases\n\n- **Google Photos Migration**: [Complete guide](docs\u002Fbest-practices.md#google-photos-migration)\n- **iCloud Import**: [Step-by-step instructions](docs\u002Fexamples.md#icloud-import)\n- **Server Migration**: [Transfer between Immich instances](docs\u002Fexamples.md#server-migration)\n- **Bulk Organization**: [Stacking and tagging strategies](docs\u002Fbest-practices.md#organization-strategies)\n\n## 💡 Support the Project\n\n- [GitHub Sponsor](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fsimulot)\n- [PayPal Donation](https:\u002F\u002Fwww.paypal.com\u002Fdonate\u002F?hosted_button_id=VGU2SQE88T2T4)\n\n\n## 🤝 Contributing\n\nContributions are welcome! Please see our [contributing guidelines](CONTRIBUTING.md) for details.\n\n## 📄 License\n\nThis project is licensed under the terms specified in the [LICENSE](LICENSE) file.\n\n---\n\n**Need help?** Check our [documentation](docs\u002F) or open an issue on GitHub.\n","Immich-Go 是一个用于将大量照片集合上传到自托管 Immich 服务器的开源工具。其核心功能包括简单的安装过程（无需 NodeJS 或 Docker），支持从 Google Photos 导出、iCloud、本地文件夹、ZIP 压缩包等多种来源上传照片，并且能够处理超过十万张照片的大规模收藏。此外，它还具备智能管理功能，如重复检测、连拍照片堆叠和 RAW+JPEG 文件处理等。该工具跨平台可用，支持 Windows、macOS、Linux 和 FreeBSD 系统。适用于需要将个人或家庭照片库迁移到私有云存储环境中的用户，特别是那些希望摆脱对商业服务依赖的人群。",2,"2026-06-11 03:37:48","high_star"]