- iCloudアカウントの写真をコマンドラインから直接ダウンロードできるようにするオープンソースツール
- Linux、Windows、macOS など主要なオペレーティングシステムで実行可能で、Docker・PyPI・AUR・npm を通じたインストールをサポート
- Copy・Sync・Move の3つのモードで動作し、Live Photos・RAW画像・EXIFメタデータ の処理機能を含む
- 自動重複除去、継続的な変更監視、増分実行の最適化 など多様なオプションを提供
- MITライセンスで公開されており、現在 メンテナー(maintainer) を募集している
プロジェクト概要
- iCloud Photos Downloader は、iCloudに保存された写真をローカルシステムにダウンロードする コマンドラインベースのツール
- iCloud写真全体をダウンロードしたり、変更分のみを同期したりできる
- ボランティアコミュニティ が開発と保守を行っており、新たなコントリビューターを募集中
- MITライセンスで配布されており、自由に利用・改変可能
- GitHubで 1万件超のスター(star) と 705件のフォーク(fork) を保有
対応プラットフォームと配布方法
- OS互換性: Linux、Windows、macOS、NAS環境をサポート
- 配布チャネル:
- Docker イメージ
- PyPI パッケージ
- Arch Linux AUR
- npm パッケージ
- 実行ファイルを直接ダウンロードするか、ソースコードからビルド可能
主な機能
- 3つの動作モード
- Copy: 新しい写真のみダウンロード（デフォルトモード）
- Sync: iCloudで削除された写真をローカルでも削除 (
--auto-delete)
- Move: ダウンロード後にiCloudから写真を削除 (
--keep-icloud-recent-days)
- 対応フォーマット: Live Photos（画像・動画を分離保存）、RAWおよびRAW+JPEG
- 機能オプション
- 同名写真の 自動重複除去
- 継続監視モード (
--watch-with-interval)
- 増分実行の最適化 (
--until-found, --recent)
- EXIFメタデータの修正 (
--set-exif-datetime)
--help コマンドで全オプションを確認可能
インストールと実行
- インストール方法
- GitHubリリースページから実行ファイルをダウンロード
- パッケージマネージャー（Docker、PyPI、AUR、npm）でインストール
- ソースコードを直接ビルド
- iCloud設定の要件
- iPhone/iPadで
Access iCloud Data on the Web を有効化
Advanced Data Protection を無効化する必要あり
- 使用例
実験的機能と開発状況
- 一部機能は Experimental Mode として先行追加され、検証後に正式反映される
- 最新リリースは v1.32.2 (2025年9月2日)
- 週1回（金曜日） を目標に新バージョンをリリース
- 最近のコミットには マルチユーザー設定のサポート、非Linuxビルドの修正、テスト環境の改善 などが含まれる
貢献とコミュニティ
- 貢献ガイドライン(CONTRIBUTING.md) を通じて外部開発者も参加可能
- 42人のコントリビューター がコードに参加しており、Dependabotなどの自動化ツールも利用
- 現在 プロジェクトメンテナーを公開募集中
- 公式ドキュメントと議論は GitHub Discussions で行われている
1件のコメント
Hacker News の意見
私は Photos Backup Anywhere の開発者です。Apple Photos を解析していて驚いたのは、ディスク上のファイルだけでは全体の状態を表現できないことです
アルバム、Live Photos、バースト撮影、スローモーション、編集履歴、撮影日の修正などは別途管理されており、ほとんどのバックアップツールは復元時にこれらを正しく再構成できません
そのため私は Photos 自体を 真実の源泉(source of truth) と見なし、復元時にはそれを基準に検証する方式を採用しました
このツールはアルバムとあらゆる写真タイプを完全に復元しつつ、位置情報、作成日、更新日を保持します
プロジェクトページは photosbackup.app にあります
Image Captureアプリで 0〜9999 単位でコピーしています。1万枚を超えるとファイル名が再び 00001(1) に戻ってしまい不便ですMacBook の SSD 容量が小さく、iCloud を経由したくないのですが、元の RAW/JPEG/Live/Video を外付けドライブへ直接書き出す方法があるのか知りたいです
このプロジェクトは本当に素晴らしいです。Windows 用 iCloud アプリの代わりになれるかもしれません
私も約 2TB の iCloud データを持っていますが、MacBook は容量不足なので、外付けドライブに別の Photo Library を置いています
Windows 用 iCloud アプリはずっと 50MB/s でダウンロード中ですが、フォルダを開くと大半が「オンラインでのみ利用可能」状態です
現在 944GB ほどダウンロードできましたが、完全に終わるまではまだ時間がかかりそうです
Windows で HEIC と Live Photo をきちんと表示できる 代替写真ビューア があるのか知りたいです
macOS 専用ですが、有料アプリ Parachute があります。iCloud ライブラリ内の写真とファイルをすべてダウンロードできます
App Store リンク
元データは書き出しますが、AAE ファイルは含みません。一方で PhotoSync には復元機能がないのが惜しいです
驚くべきことに、iCloud からすべての写真（約 400GB）を一度にダウンロードする公式の方法はありません
その代わり、オープンソースの コマンドラインツール で iCloud 写真全体を取得できます
Cmd+A > File > Export Unmodified Originalsでオリジナルを書き出せます数日前に共有ライブラリをバックアップしましたが、約 10K 件の写真・動画（300GB）を扱いました
iPhoto ライブラリの復旧 → 年ごとに分けて書き出し → 外付け HDD へ移動 → 外付け HDD 上のライブラリをデフォルトに指定して iCloud と再同期
有線 Ethernet 接続と Repair 機能 が大いに役立ちました
私は usbmuxd + ifuse の組み合わせで iPhone から写真ファイルを直接コピーしています
アップロードやダウンロード待ちなしでケーブル直結してオリジナルを取り出せて、しかも移動して 空き容量の確保 までできます
私は小さな シェルスクリプト で定期的に iCloud 写真をダウンロードしています
icloudpd/icloudpd:latestコンテナを使って、フォルダ構造ごとにオリジナルを保存しています我が家では毎年およそ 2TB のメディアを生成しています。合計で 12TB ほどになります
iCloud の思い出機能は良いのですが、月 60 ドルは負担なので次のようにしています
高速なローカルディスク（例: OWC 4M2 + M.2 SSD）が重要です。HDD ベースの NAS は遅いです
docker-icloudpd GitHub リンク
iCloud Photos.app では一部の写真が見えないのに、Photometor.app（Apple 所有）では見えます
Photos.app で表示されない理由が分からず、もどかしいです
Apple が サードパーティ統合 をほとんど許可していないのは残念です
特定のアルバムの写真を両親のフォトフレームや Samsung Frame TV に自動同期したいのですが、こうした機能が塞がれています
少し開放するだけでも 革新的な活用 が可能になりそうです