iCloud Photos Downloader

• Ein Open-Source-Tool, mit dem sich Fotos aus einem iCloud-Konto direkt über die Kommandozeile herunterladen lassen
• Läuft auf wichtigen Betriebssystemen wie Linux, Windows und macOS und unterstützt die Installation über Docker, PyPI, AUR und npm
• Arbeitet in drei Modi: Copy, Sync und Move; inklusive Unterstützung für Live Photos, RAW-Bilder und EXIF-Metadaten
• Bietet zahlreiche Optionen wie automatische Duplikatentfernung, kontinuierliche Änderungsüberwachung und Optimierung inkrementeller Ausführungen
• Wird unter der MIT-Lizenz veröffentlicht; derzeit wird ein Maintainer gesucht

---

Projektüberblick

• iCloud Photos Downloader ist ein kommandozeilenbasiertes Tool, das in iCloud gespeicherte Fotos auf ein lokales System herunterlädt
  • Es kann die gesamte iCloud-Fotomediathek herunterladen oder nur Änderungen synchronisieren
  • Es wird von einer freiwilligen Community entwickelt und gepflegt; neue Mitwirkende sind willkommen
• Wird unter der MIT-Lizenz vertrieben und kann frei genutzt und angepasst werden
• Verfügt auf GitHub über mehr als 10.000 Stars und 705 Forks

Unterstützte Plattformen und Bereitstellung

• Betriebssystem-Kompatibilität: Unterstützung für Linux, Windows, macOS und NAS-Umgebungen
• Distributionskanäle:
  • Docker-Image
  • PyPI-Paket
  • Arch Linux AUR
  • npm-Paket
• Die Binärdatei kann direkt heruntergeladen oder aus dem Quellcode gebaut werden

Hauptfunktionen

• Drei Betriebsmodi
  • Copy: Lädt nur neue Fotos herunter (Standardmodus)
  • Sync: Löscht lokal auch die Fotos, die in iCloud gelöscht wurden (--auto-delete)
  • Move: Löscht Fotos nach dem Download aus iCloud (--keep-icloud-recent-days)
• Unterstützte Formate: Live Photos (separate Speicherung von Bild und Video), RAW sowie RAW+JPEG
• Funktionsoptionen
  • Automatische Duplikatentfernung bei Fotos mit identischem Namen
  • Kontinuierlicher Überwachungsmodus (--watch-with-interval)
  • Optimierung inkrementeller Ausführungen (--until-found, --recent)
  • Anpassung von EXIF-Metadaten (--set-exif-datetime)
• Mit dem Befehl --help lassen sich alle Optionen anzeigen

Installation und Ausführung

• Installationsmethoden
  1. Binärdatei von der GitHub-Releases-Seite herunterladen
  2. Über Paketmanager installieren (Docker, PyPI, AUR, npm)
  3. Quellcode direkt bauen
• Erforderliche iCloud-Einstellungen
  • Auf iPhone/iPad Access iCloud Data on the Web aktivieren
  • Advanced Data Protection muss deaktiviert sein
• Beispiele für die Nutzung
  • Synchronisierung ausführen:

    icloudpd --directory /data --username [e-mail] --watch-with-interval 3600
    

  • Authentifizierungssitzung erstellen:

    icloudpd --username [e-mail] --password my_password --auth-only
    

Experimentelle Funktionen und Entwicklungsstand

• Einige Funktionen werden zunächst im Experimental Mode hinzugefügt und nach erfolgreicher Prüfung regulär übernommen
• Die neueste Veröffentlichung ist v1.32.2 (2. September 2025)
• Ziel ist die Veröffentlichung neuer Versionen einmal pro Woche (freitags)
• Zu den jüngsten Commits gehören u. a. Unterstützung für Mehrbenutzerkonfigurationen, Korrekturen für Nicht-Linux-Builds und Verbesserungen der Testumgebung

Beiträge und Community

• Über die Beitragsrichtlinien (CONTRIBUTING.md) können externe Entwickler mitwirken
• 42 Mitwirkende haben zum Code beigetragen; außerdem werden Automatisierungstools wie Dependabot eingesetzt
• Derzeit werden öffentlich Projekt-Maintainer gesucht
• Offizielle Dokumentation und Diskussionen finden in GitHub Discussions statt