Repolode
simulot

simulot/immich-go

Google Photos Takeoutアーカイブを含む写真コレクションを、Node.jsなしでセルフホストのImmichサーバーにアップロードできるGo製CLIツール。

代替できる製品:Google Photos

スター
7,065
フォーク
273
未解決の Issue
272
最終コミット
昨日

これは何?

Immich-goは、大規模な写真ライブラリをセルフホストのImmichサーバーに移行するためのCLIツールです。公式のimmich-cliに代わる選択肢として利用でき、単一のバイナリで配布されるため、実行にNode.jsやDockerは不要です。

さまざまな取り込み元に対応する複数のアップロードコマンドを備えています。ローカルフォルダ、Google Photos Takeoutアーカイブ、iCloudのエクスポート、Picasaフォルダ、ZIPファイル、別のImmichサーバーなどからアップロードできます。Google Photos用コマンドは写真とJSONメタデータを照合し、アルバム、説明、位置情報を復元します。ほかのコマンドでは、フォルダ構成からアルバムを作成したり、XMPサイドカーファイルを読み込んだり、RAW+JPEGのペアや連写写真をスタックしたりできます。

重複を検出して既存ファイルの再アップロードを防ぐほか、サムネイルフォルダや.DS_Storeファイルなど、よくあるシステム由来の不要ファイルをデフォルトでスキップします。また、独自の除外パターンでファイルをフィルタリングできます。Immich V2とV3に対応し、Windows、macOS、Linux、FreeBSDで動作します。

主な機能

  • 01ローカルフォルダ、Google Photos Takeout、iCloudのエクスポート、Picasaフォルダ、ZIPアーカイブからアップロード
  • 02フィルタリングしながらImmichサーバー間でアセットをコピー
  • 03ソースのメタデータからアルバム、タグ、説明、位置情報を保持
  • 04重複を検出し、RAW+JPEGのペアや連写写真をスタック
  • 05Node.jsやDockerに依存せず、単一のバイナリで利用可能

ユースケース

  • Google PhotosのライブラリをセルフホストのImmichサーバーに移行する
  • iCloud PhotosのエクスポートをImmichに取り込む
  • あるImmichインスタンスから別のインスタンスへアセットを移す
  • NASやディスクに保存した大規模な写真アーカイブを一括アップロードする

クイックスタート

  1. 1

    GitHubのリリースページから、お使いのシステム用のビルド済みバイナリをダウンロード

  2. 2

    ローカルフォルダーから写真をアップロード

    immich-go upload from-folder --server=http://your-ip:2283 --api-key=your-api-key /path/to/your/photos
  3. 3

    Google Photos Takeoutをアップロード

    immich-go upload from-google-photos --server=http://your-ip:2283 --api-key=your-api-key /path/to/takeout-*.zip

使う前に知っておきたいこと

  • 作者によると、まだ十分なテストが行われていない初期バージョンです。
  • 稼働中のImmichサーバーと、適切な権限を持つAPIキーが必要です。
  • AGPL-3.0の下でライセンスされており、ネットワーク利用に関する義務を伴うコピーレフトライセンスです。

トピック

よくある質問

immich-go とは?
Google Photos Takeoutアーカイブを含む写真コレクションを、Node.jsなしでセルフホストのImmichサーバーにアップロードできるGo製CLIツール。 Immich-goは、大規模な写真ライブラリをセルフホストのImmichサーバーに移行するためのCLIツールです。公式のimmich-cliに代わる選択肢として利用でき、単一のバイナリで配布されるため、実行にNode.jsやDockerは不要です。
immich-go は無料で使えますか?ライセンスは?
immich-go は AGPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
immich-go は今もメンテナンスされていますか?
活発にメンテナンス中。immich-go の最終コミットは 2026年10月18日 です。
immich-go は何に使えますか?
Google PhotosのライブラリをセルフホストのImmichサーバーに移行する iCloud PhotosのエクスポートをImmichに取り込む あるImmichインスタンスから別のインスタンスへアセットを移す NASやディスクに保存した大規模な写真アーカイブを一括アップロードする
immich-go のインストール方法は?
GitHubのリリースページから、お使いのシステム用のビルド済みバイナリをダウンロード ローカルフォルダーから写真をアップロード: immich-go upload from-folder --server=http://your-ip:2283 --api-key=your-api-key /path/to/your/photos Google Photos Takeoutをアップロード: immich-go upload from-google-photos --server=http://your-ip:2283 --api-key=your-api-key /path/to/takeout-*.zip
immich-go はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/simulot/immich-go

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト