iCloud Photos Downloader

• Un outil open source qui permet de télécharger directement en ligne de commande les photos d’un compte iCloud
• Fonctionne sur les principaux systèmes d’exploitation, dont Linux, Windows et macOS, avec installation via Docker, PyPI, AUR et npm
• Propose trois modes de fonctionnement, Copy, Sync et Move, avec prise en charge des Live Photos, des images RAW et des métadonnées EXIF
• Offre diverses options comme la déduplication automatique, la surveillance continue des changements et l’optimisation des exécutions incrémentales
• Distribué sous licence MIT et actuellement à la recherche d’un maintainer

---

Aperçu du projet

• iCloud Photos Downloader est un outil en ligne de commande permettant de rapatrier sur un système local les photos stockées dans iCloud
  • Il peut télécharger l’ensemble de la photothèque iCloud ou ne synchroniser que les changements
  • Il est développé et maintenu par une communauté de bénévoles, qui recherche de nouveaux contributeurs
• Distribué sous licence MIT, il peut être utilisé et modifié librement
• Sur GitHub, le projet compte plus de 10k étoiles et 705 forks

Plateformes prises en charge et modes de distribution

• Compatibilité système : prise en charge de Linux, Windows, macOS et des environnements NAS
• Canaux de distribution :
  • Image Docker
  • Package PyPI
  • AUR d’Arch Linux
  • Package npm
• Il est possible de télécharger directement les exécutables ou de compiler depuis le code source

Fonctionnalités principales

• Trois modes de fonctionnement
  • Copy : télécharge uniquement les nouvelles photos (mode par défaut)
  • Sync : supprime aussi en local les photos supprimées d’iCloud (--auto-delete)
  • Move : supprime les photos d’iCloud après téléchargement (--keep-icloud-recent-days)
• Formats pris en charge : Live Photos (enregistrement séparé de l’image et de la vidéo), RAW et RAW+JPEG
• Options disponibles
  • Déduplication automatique des photos portant le même nom
  • Mode de surveillance continue (--watch-with-interval)
  • Optimisation des exécutions incrémentales (--until-found, --recent)
  • Modification des métadonnées EXIF (--set-exif-datetime)
• La commande --help permet d’afficher l’ensemble des options

Installation et exécution

• Méthodes d’installation
  1. Télécharger l’exécutable depuis la page des releases GitHub
  2. Installer via un gestionnaire de paquets (Docker, PyPI, AUR, npm)
  3. Compiler directement depuis le code source
• Prérequis de configuration iCloud
  • Activer Access iCloud Data on the Web sur iPhone/iPad
  • Il faut désactiver Advanced Data Protection
• Exemples d’utilisation
  • Exécuter une synchronisation :

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

  • Créer une session d’authentification :

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

Fonctionnalités expérimentales et état du développement

• Certaines fonctionnalités sont d’abord ajoutées en Experimental Mode avant d’être validées puis intégrées officiellement
• La release la plus récente est v1.32.2 (2 septembre 2025)
• L’objectif est de publier une nouvelle version une fois par semaine (le vendredi)
• Les commits récents incluent notamment la prise en charge de configurations multi-utilisateurs, des correctifs pour les builds non Linux et des améliorations de l’environnement de test

Contribution et communauté

• Les développeurs externes peuvent participer via les guidelines de contribution (CONTRIBUTING.md)
• 42 contributeurs ont participé au code, avec également l’usage d’outils d’automatisation comme Dependabot
• Le projet recrute actuellement un maintainer
• La documentation officielle et les discussions ont lieu sur GitHub Discussions