
2026/01/12 4:23
iCloud フォト・ダウンローダー
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
**icloudpd** は、Linux、Windows、macOS、ラップトップ、デスクトップ、および NAS デバイス上でユーザーが iCloud 写真をすべてダウンロードできるコマンドラインユーティリティです。GitHub Releases では事前コンパイル済みの実行ファイルとして配布され、Docker、PyPI、AUR、または npm を介してインストールすることも可能です。 本プロジェクトはボランティアによって維持管理されており、新しいメンテナーと貢献者を積極的に募集しています。重要な変更があった場合には毎週金曜日に新バージョンがリリースされます。 ツールを使用するためには、Apple ID の設定で「Web から iCloud データへのアクセス」を有効にし、「高度なデータ保護」を無効化する必要があります。 icloudpd は次の三つの操作モードを提供します: - **Copy**(既定) – 新しい写真をダウンロード - **Sync** (`--auto-delete`) – iCloud で削除されたファイルをローカルストレージに反映 - **Move** (`--keep-icloud-recent-days`) – 新しい写真をダウンロードし、iCloud からそれらを削除 Live Photos(画像+動画)と RAW 画像(RAW+JPEG)の両方に対応しています。その他の機能としては、自動重複排除、`--watch-with-interval` を用いた一回限りまたは継続的監視、インクリメンタル最適化(`--until-found`、`--recent`)、および `--set-exif-datetime` により EXIF 日時を更新する機能があります。 実験ブランチが用意されており、新機能を本パッケージにマージする前にテストできます。同期の例は以下の通りです:
icloudpd --directory /data
--username my@email.address
--watch-with-interval 3600
プロジェクトには貢献ガイドラインがあり、コミュニティ参加を奨励しています。
本文
iCloud Photo Downloader
iCloudの写真をすべてダウンロードできるコマンドラインツールです。
Linux、Windows、macOS で動作し、ノートパソコン・デスクトップ・NAS デバイスでも利用可能です。
- 単体実行ファイル(直接ダウンロード)としても、各種パッケージ管理/エコシステム(Docker, PyPI, AUR, npm)経由でも入手できます。
- ボランティアによって開発・保守されており、常に協力者を歓迎しています。
詳細は Documentation をご覧ください。また、Issues も併せてチェックしてください。
新バージョンは週1回(金曜)リリースすることを目標とし、価値ある変更があれば随時公開します。
iCloud の前提条件
ダウンローダーを動作させるには、iCloud アカウントの設定を以下の通りにしておく必要があります。設定が不十分だと Apple サーバーから ACCESS_DENIED エラーが返ります。
- Web で iCloud データへのアクセスを有効化
iPhone / iPad の 設定 → Apple ID → iCloud → Web での iCloud データへのアクセス をオンにしてください。 - 高度なデータ保護を無効化
同じく 設定 → Apple ID → iCloud → 高度なデータ保護 をオフにします。
インストール & 実行
icloudpd を実行する方法は主に3つあります:
- GitHub Release から実行ファイルをダウンロード
ご自身のプラットフォーム用にビルドされた実行ファイルを入手し、起動してください。 - パッケージマネージャーを使用
Docker, PyPI, AUR, npm などでインストール・更新・(場合によっては)実行できます。 - ソースからビルドして実行
詳細は Documentation をご覧ください。
主な機能
操作モードの種類
| モード | 説明 |
|---|---|
| Copy | iCloud から新しい写真をダウンロード(デフォルトモード)。 |
| Sync | 新しい写真をダウンロードし、iCloud で削除されたローカルファイルも自動的に削除( オプション)。 |
| Move | 新しい写真をダウンロードし、iCloud 上の同一ファイルを削除( オプション)。 |
その他の機能:
- Live Photo(画像と動画を別々に保存)や RAW 画像(RAW+JPEG を含む)のサポート。
- 同名写真の自動重複排除。
- 一度だけダウンロードするモード、または iCloud の変更を継続監視するモード(
)。--watch-with-interval - インクリメンタル実行時の最適化(
,--until-found
オプション)。--recent - 写真メタデータ(EXIF)の更新(
)。--set-exif-datetime
…他にも多数あります。全リストは
icloudpd --help で確認できます。
実験モード
実験モードに追加された変更は、正式版に統合される前の検証段階です。詳細はドキュメントを参照してください。
使用例
# iCloud の写真コレクションをローカルと同期させ続ける icloudpd --directory /data \ --username my@email.address \ --watch-with-interval 3600
重要: 実行ファイルは
です。icloudpdという名前の実行ファイルではありません。icloud
Tip: 同期ロジックはコマンドラインパラメータで調整できます。全オプションは
icloudpd --help で確認してください。
# セッションを作成し認証する(必要なら 2SA/2FA を完了) icloudpd --username my@email.address \ --password my_password \ --auth-only
Tip: この機能は、セッションがまだ有効かどうか確認・検証する際にも利用できます。
コントリビュート
iCloud Photo Downloader に貢献したい方へ。素晴らしい!コントリビューションガイドライン をご覧いただき、ご参加ください。