iCloud Photo Downloader
Übersicht der Parameter von icloudpd
Section titled “Übersicht der Parameter von icloudpd”icloudpd (iCloud Photo Downloader) bietet eine Vielzahl von Parametern zur flexiblen Steuerung des Downloads aus der iCloud Fotobibliothek. Hier sind alle relevanten Optionen beschrieben:
Referenz der Parameter
Section titled “Referenz der Parameter”Dies ist eine Liste aller Optionen, die für die Kommandozeilenschnittstelle (CLI) von icloudpd verfügbar sind.
(until-found-parameter)=
Section titled “(until-found-parameter)=”--until-found X
: Überprüft die neuesten bis zu den ältesten Objekte darauf, ob sie lokal vorhanden sind. Fehlen sie lokal, werden sie heruntergeladen. Der Vorgang stoppt, sobald X aufeinanderfolgende Überprüfungen ein lokales mit dem entfernten Objekt abgleichen.
Diese Option ist eine nützliche Optimierung für inkrementelle Updates: Nur ein kleiner Teil (X) des lokalen Speichers wird erneut auf Vorhandensein überprüft, was lokale IO spart. Allerdings werden dadurch keine „Lücken“ im lokalen Speicher gefüllt oder erkannt.
Die Überprüfung erfolgt nach dem Hinzufügedatum in iCloud, nicht nach dem Aufnahme-/Erstellungsdatum.(recent-parameter)=
Section titled “(recent-parameter)=”--recent X
: Überprüft die X zuletzt hinzugefügten Objekte auf lokale Kopien. Fehlende werden heruntergeladen.
Diese Option ist vor allem beim Testen und Experimentieren mit Parametern nützlich, um die Downloadmenge zu begrenzen.
Die Überprüfung erfolgt nach dem Hinzufügedatum in iCloud, nicht nach dem Aufnahme-/Erstellungsdatum.(album-parameter)=
Section titled “(album-parameter)=”--album X
: Gibt an, welches Album heruntergeladen werden soll.
Wird kein Album angegeben, wird die gesamte Sammlung betrachtet.
Es kann immer nur ein Album heruntergeladen werden.(list-albums-parameter)=
Section titled “(list-albums-parameter)=”--list-albums
: Listet alle verfügbaren Alben auf.
(library-parameter)=
Section titled “(library-parameter)=”--library X
: Gibt an, welche Bibliothek verwendet werden soll.
Standard: „Persönliche Bibliothek“.
Es kann immer nur eine Bibliothek verwendet werden.(list-libraries-parameter)=
Section titled “(list-libraries-parameter)=”--list-libraries
: Listet alle für das Konto verfügbaren Bibliotheken auf.
(watch-with-interval-parameter)=
Section titled “(watch-with-interval-parameter)=”--watch-with-interval X
: Führt icloudpd dauerhaft aus und prüft in regelmäßigen Abständen (in Sekunden, z. B. 3600 für 1 Stunde) auf Änderungen in iCloud.
Ein zu kurzes Intervall kann zu Drosselung durch Apple führen, auch wenn bisher keine Fälle bekannt sind.
(version-parameter)=
Section titled “(version-parameter)=”--version
: Zeigt die aktuelle Version sowie Commit-Hash und das Erstellungsdatum dieser Version an.
Wenn `--use-os-locale` vor `--version` angegeben wurde, wird das Datum im OS-Format ausgegeben.(use-os-locale-parameter)=
Section titled “(use-os-locale-parameter)=”--use-os-locale
: Weist icloudpd an, die Betriebssystem-Lokalisierung zu verwenden. Standardmäßig wird US-Englisch genutzt.
Siehe Abschnitt [Dateibenennung](naming) für das beeinflusste Verhalten.(dry-run-parameter)=
Section titled “(dry-run-parameter)=”--dry-run
: Nimmt keine Änderungen am lokalen oder iCloud-Speicher vor.
Die Authentifizierung wird durchgeführt und entfernte Dateien werden mit lokalen verglichen. Unterschiede werden gemeldet, aber kein Download durchgeführt.
Diese Option ist nützlich zum Testen neuer Parameter.
(domain-parameter)=
Section titled “(domain-parameter)=”--domain X
: Der Zugriff auf Apple-Server ist aus Festlandchina blockiert. Alternativ kann die interne .cn-Domain angegeben werden, damit icloudpd aus China funktioniert.
Standard ist „.com“. „.cn“ ist die einzige weitere Option.
(password-parameter)=
Section titled “(password-parameter)=”--password X
: Gibt das iCloud-Passwort für die Authentifizierung an.
Die Übergabe von Zugangsdaten über die Kommandozeile ist unsicher, da sie protokolliert oder anderweitig ausgelesen werden können. Nutze besser andere [Passwortanbieter](authentication).(directory-parameter)=
Section titled “(directory-parameter)=”--directory X
: Legt den Wurzelordner fest, in dem die Ordnerstruktur beginnt und Dateien gespeichert werden.
(file-match-policy-parameter)=
Section titled “(file-match-policy-parameter)=”--file-match-policy X
: Legt den Algorithmus (die Richtlinie) zum Abgleich von entfernten und lokalen Dateien fest.
Siehe [Dateibenennung und Duplikaterkennung](naming)(username-parameter)=
Section titled “(username-parameter)=”--username X
: Gibt die AppleID (E-Mail-Adresse) für die iCloud-Authentifizierung an.
(auth-only-parameter)=
Section titled “(auth-only-parameter)=”--auth-only
: Führt nur die Authentifizierung durch, speichert die Ergebnisse (Tokens/Cookies) und beendet sich dann ohne weitere Verarbeitung.
(cookie-directory-parameter)=
Section titled “(cookie-directory-parameter)=”--cookie-directory X
: Legt den Ordner für die Speicherung der Authentifizierungsdaten (Cookies/Tokens) fest. Standard ist ~/.pyicloud.
(size-parameter)=
Section titled “(size-parameter)=”--size X
: Legt die Größe der herunterzuladenden Objekte fest.
Siehe [Asset-Größen](size)(force-size-parameter)=
Section titled “(force-size-parameter)=”--force-size
: Lädt nur die angeforderte Größe herunter. Andernfalls wird die Originalgröße heruntergeladen, falls die gewünschte Größe fehlt.
[`--size` Parameter](size-parameter)(live-photo-size-parameter)=
Section titled “(live-photo-size-parameter)=”--live-photo-size X
: Legt die Größe der Live-Foto-Objekte fest.
(skip-videos-parameter)=
Section titled “(skip-videos-parameter)=”--skip-videos
: Videos werden nicht verarbeitet.
(skip-live-photos-parameter)=
Section titled “(skip-live-photos-parameter)=”--skip-live-photos
: Live-Fotos werden nicht verarbeitet.
(auto-delete-parameter)=
Section titled “(auto-delete-parameter)=”--auto-delete
: Lokal werden Objekte gelöscht, die in iCloud gelöscht wurden (bzw. in „Zuletzt gelöscht“ verschoben wurden).
Siehe [Betriebsmodi](mode)(delete-after-download-parameter)=
Section titled “(delete-after-download-parameter)=”--delete-after-download
: Nach dem lokalen Download werden die Objekte in iCloud gelöscht (bzw. in „Zuletzt gelöscht“ verschoben). Veraltet, nutze stattdessen --keep-icloud-recent-days.
Wurden entfernte Objekte nicht heruntergeladen (z. B. weil sie schon lokal vorhanden waren), werden sie NICHT in iCloud gelöscht.(keep-icloud-recent-days-parameter)=
Section titled “(keep-icloud-recent-days-parameter)=”--keep-icloud-recent-days X
: Löscht Objekte in iCloud, nachdem sie heruntergeladen oder lokal bestätigt wurden, außer denen, die innerhalb der angegebenen Tage aufgenommen wurden. Bei 0 werden alle Fotos aus iCloud gelöscht.
: Werden Filter wie --skip-videos verwendet, werden davon ausgeschlossene Objekte nicht aus iCloud gelöscht.
: Das Alter wird anhand des Aufnahme-/Erstellungsdatums berechnet, wie von iCloud gemeldet. Beispiel: Ein Objekt von 2000, das 2024 zu iCloud hinzugefügt wurde, ist 2025 dann 25 Jahre alt. Dieser Zeitstempel wird auch für die Ordnerstruktur verwendet.
: Wird der Parameter nicht angegeben, wird nichts aus iCloud gelöscht.
Siehe [Betriebsmodi](mode)
Siehe [Ordnerstruktur](folder_structure)(only-print-filenames-parameter)=
Section titled “(only-print-filenames-parameter)=”--only-print-filenames
: Es werden keine Dateien heruntergeladen, sondern nur die Dateipfade ausgegeben (keine weiteren Informationen).
[`--dry-run` Parameter](dry-run-parameter)(folder-structure-parameter)=
Section titled “(folder-structure-parameter)=”--folder-structure X
: Legt das Benennungsschema für Unterordner fest.
Siehe Details im Abschnitt [Ordnerstruktur](naming).(set-exif-datetime-parameter)=
Section titled “(set-exif-datetime-parameter)=”--set-exif-datetime
: Aktualisiert das EXIF-Datum/-Uhrzeit des Bildes mit dem Aufnahme-/Erstellungsdatum, sofern noch kein EXIF vorhanden ist.
(no-progress-bar-parameter)=
Section titled “(no-progress-bar-parameter)=”--no-progress-bar
: Unterdrückt die Fortschrittsanzeige. Nützlich beim Umleiten der Ausgabe in eine Datei.
(keep-unicode-in-filenames-parameter)=
Section titled “(keep-unicode-in-filenames-parameter)=”--keep-unicode-in-filenames
: Unicode-Zeichen werden in Dateinamen beibehalten. Andernfalls werden sie entfernt (Standard).
(live-photo-mov-filename-policy-parameter)=
Section titled “(live-photo-mov-filename-policy-parameter)=”--live-photo-mov-filename-policy X
: Legt das Benennungsschema für den Videoteil von Live-Fotos fest.
Siehe Details im Abschnitt [Live Photo](naming).(align-raw-parameter)=
Section titled “(align-raw-parameter)=”--align-raw X
: Legt die Behandlung von RAW+JPEG-Objekten fest.
Siehe Details im Abschnitt [RAW+JPEG](raw).(password-provider-parameter)=
Section titled “(password-provider-parameter)=”--password-provider X
: Legt fest, wie das Passwort für die iCloud-Authentifizierung abgefragt wird.
Siehe Details im Abschnitt [Passwortanbieter](authentication).(mfa-provider-parameter)=
Section titled “(mfa-provider-parameter)=”--mfa-provider X
: Legt fest, wie der Code für die Zwei-Faktor-Authentifizierung (MFA) abgefragt wird.
Siehe Details im Abschnitt [MFA-Anbieter](authentication).(xmp-sidecar-parameter)=
Section titled “(xmp-sidecar-parameter)=”--xmp-sidecar
: Exportiert zusätzliche Daten als XMP-Sidecar-Dateien (Standard: kein Export).
(smtp-parameter)=
Section titled “(smtp-parameter)=”--smtp-username X, --smtp-password X, --smtp-host X, --smtp-port X, --smtp-no-tls
: Einstellungen für SMTP-Benachrichtigungen bei abgelaufener/benötigter Authentifizierung.
(notification-email-parameter)=
Section titled “(notification-email-parameter)=”--notification-email X, --notification-email-from X
: Einstellungen für die E-Mail-Benachrichtigungsadresse.
(notification-script-parameter)=
Section titled “(notification-script-parameter)=”--notification-script X
: Skript, das bei abgelaufener MFA zur Benachrichtigung ausgeführt wird.
(skip-created-before-parameter)=
Section titled “(skip-created-before-parameter)=”--skip-created-before
: Verarbeitet keine Objekte, die vor dem angegebenen Zeitstempel erstellt wurden. Zeitstempel im ISO-Format, z. B. 2025-06-01, oder als Intervall ab jetzt, z. B. 5d. Ohne Zeitzone wird die lokale Zeitzone verwendet.
Das Datum ist das Erstellungsdatum, nicht das Hinzufügedatum in iCloud.