iCloud Photos Downloader

 (github.com/icloud-photos-downloader)
3 poin oleh GN⁺ 2026-01-12 | 1 komentar | Bagikan ke WhatsApp
  • Alat open source yang memungkinkan mengunduh foto langsung dari baris perintah menggunakan akun iCloud
  • Dapat dijalankan di sistem operasi utama seperti Linux, Windows, macOS, serta mendukung instalasi melalui Docker, PyPI, AUR, npm
  • Bekerja dalam tiga mode: Copy, Sync, Move, dan mencakup penanganan Live Photos, gambar RAW, metadata EXIF
  • Menyediakan berbagai opsi seperti penghapusan duplikat otomatis, pemantauan perubahan berkelanjutan, dan optimasi eksekusi inkremental
  • Dirilis dengan lisensi MIT dan saat ini sedang mencari maintainer

Gambaran proyek

  • iCloud Photos Downloader adalah alat berbasis baris perintah untuk mengunduh foto yang tersimpan di iCloud ke sistem lokal
    • Dapat mengunduh seluruh foto iCloud atau hanya menyinkronkan perubahan
    • Dikembangkan dan dipelihara oleh komunitas relawan, serta sedang merekrut kontributor baru
  • Didistribusikan dengan lisensi MIT sehingga bebas digunakan dan dimodifikasi
  • Memiliki lebih dari 10k star dan 705 fork di GitHub

Platform yang didukung dan metode distribusi

  • Kompatibilitas sistem operasi: mendukung Linux, Windows, macOS, dan lingkungan NAS
  • Kanal distribusi:
    • Image Docker
    • Paket PyPI
    • Arch Linux AUR
    • Paket npm
  • File executable dapat diunduh langsung, atau dibangun dari source code

Fitur utama

  • Tiga mode operasi
    • Copy: hanya mengunduh foto baru (mode default)
    • Sync: menghapus foto lokal jika foto tersebut dihapus dari iCloud (--auto-delete)
    • Move: menghapus foto dari iCloud setelah diunduh (--keep-icloud-recent-days)
  • Format yang didukung: Live Photos (gambar dan video disimpan terpisah), RAW, dan RAW+JPEG
  • Opsi fitur
    • Penghapusan duplikat otomatis untuk foto dengan nama yang sama
    • Mode pemantauan berkelanjutan (--watch-with-interval)
    • Optimasi eksekusi inkremental (--until-found, --recent)
    • Modifikasi metadata EXIF (--set-exif-datetime)
  • Seluruh opsi dapat dilihat dengan perintah --help

Instalasi dan menjalankan

  • Cara instalasi
    1. Unduh file executable dari halaman rilis GitHub
    2. Instal melalui package manager (Docker, PyPI, AUR, npm)
    3. Build langsung dari source code
  • Persyaratan pengaturan iCloud
    • Aktifkan Access iCloud Data on the Web di iPhone/iPad
    • Advanced Data Protection harus dinonaktifkan
  • Contoh penggunaan
    • Menjalankan sinkronisasi: 
      icloudpd --directory /data --username my@email.address --watch-with-interval 3600
    • Membuat sesi autentikasi: 
      icloudpd --username my@email.address --password my_password --auth-only

Fitur eksperimental dan status pengembangan

  • Beberapa fitur terlebih dahulu ditambahkan sebagai Experimental Mode lalu diverifikasi sebelum dimasukkan secara resmi
  • Rilis terbaru adalah v1.32.2 (2 September 2025)
  • Menargetkan rilis versi baru seminggu sekali (Jumat)
  • Commit terbaru mencakup dukungan konfigurasi multi-pengguna, perbaikan build non-Linux, dan peningkatan lingkungan pengujian

Kontribusi dan komunitas

  • Partisipasi pengembang eksternal dimungkinkan melalui panduan kontribusi (CONTRIBUTING.md)
  • 42 kontributor telah berpartisipasi dalam kode, dan alat otomatis seperti Dependabot juga digunakan
  • Saat ini sedang membuka rekrutmen maintainer proyek
  • Dokumentasi resmi dan diskusi berlangsung di GitHub Discussions

Bacaan terkait

1 komentar

 
GN⁺ 2026-01-12
Komentar Hacker News

  • Saya adalah pembuat Photos Backup Anywhere. Saat menganalisis Apple Photos, hal yang mengejutkan adalah bahwa hanya dengan file-file di disk saja tidak cukup untuk merepresentasikan keseluruhan status
    Album, Live Photos, burst, slow motion, riwayat edit, perubahan tanggal pemotretan, dan sebagainya dikelola secara terpisah, dan sebagian besar alat backup tidak dapat menyusunnya kembali dengan benar saat pemulihan
    Karena itu saya memperlakukan Photos sendiri sebagai source of truth, lalu memverifikasi hasil pemulihan berdasarkan itu
    Alat ini memulihkan album dan semua jenis foto secara lengkap sambil mempertahankan lokasi, tanggal pembuatan, dan tanggal modifikasi
    Halaman proyeknya ada di photosbackup.app

    • Saat memindahkan foto dari iPhone, saya menyalin dengan aplikasi ‘Image Capture’ dalam rentang 0~9999. Kalau jumlahnya melewati 10 ribu, nama file kembali menjadi 00001(1), jadi merepotkan
      SSD MacBook saya kecil dan saya tidak ingin lewat iCloud; saya penasaran apakah ada cara mengekspor RAW/JPEG/Live/Video asli langsung ke drive eksternal
    • Saya benar-benar mengalami mimpi buruk saat mengekstrak foto dari ponsel Android lama. Kalau antarmukanya tidak muncul dengan benar, kita harus bergantung pada alat yang menyapu seluruh drive
    • Saya penasaran apakah mendukung backup ke storage kompatibel S3 (misalnya Backblaze B2)
    • Apakah Anda pernah melihat Parachute Backup? Mereka juga mengklaim bisa membackup data iPhotos yang kompleks

  • Proyek ini benar-benar keren. Mungkin bisa menjadi pengganti aplikasi iCloud untuk Windows
    Saya juga punya sekitar 2TB data iCloud, tetapi MacBook saya tidak cukup besar, jadi saya menaruh Photo Library terpisah di drive eksternal
    Aplikasi iCloud untuk Windows terus mengunduh pada 50MB/s, tetapi saat folder dibuka, kebanyakan masih berstatus ‘hanya tersedia online’
    Saat ini saya sudah mengunduh sekitar 944GB, tetapi sepertinya masih butuh waktu sampai benar-benar selesai
    Saya penasaran apakah ada penampil foto alternatif di Windows yang bisa menampilkan HEIC dan Live Photo dengan benar

  • Ada program berbayar Parachute yang khusus untuk macOS. Program ini bisa mengunduh semua foto dan file dari library iCloud
    Tautan App Store

    • Di iOS, PhotoSync juga lumayan bagus. Bisa mengirim foto ke NAS atau layanan jarak jauh seperti B2
    • Parachute stabil di versi desktop, tetapi versi iOS-nya tidak berhasil menyelesaikan backup inkremental library 1TB semalaman
      File asli diekspor, tetapi file AAE tidak ikut disertakan. Di sisi lain, kekurangan PhotoSync adalah tidak punya fitur pemulihan
    • Saya pernah menanyakan apakah kompatibel dengan akun ADP, tetapi tidak mendapat jawaban. Saya juga penasaran apakah ada solusi unduhan yang layak untuk akun ADP
    • Saya juga ingin tahu apakah verifikasi keamanan dari sisi privasi memungkinkan, dan apakah ada alternatif untuk Windows

  • Anehnya, tidak ada cara resmi untuk mengunduh semua foto sekaligus dari iCloud (sekitar 400GB)
    Sebagai gantinya, ada alat command-line open source yang bisa mengambil seluruh foto iCloud

    • Sebenarnya di Mac atau iPhone, Anda bisa mengunduh semuanya dengan memilih ‘Download Originals’ di pengaturan iCloud Photo Library
    • Jika Anda pengguna EU, Anda bisa meminta semua data yang dimiliki Apple tentang Anda di privacy.apple.com
    • Di aplikasi Photos pada Mac, Anda bisa mengekspor file asli dengan Cmd+A > File > Export Unmodified Originals
    • Mungkin ini memang niat Apple agar pengguna tidak pergi. Mempersulit pemindahan foto terlihat seperti strategi lock-in

  • Beberapa hari lalu saya membackup Shared Library, menangani sekitar 10K foto dan video (300GB)
    Pemulihan library iPhoto → ekspor dengan membaginya per tahun → pindah ke HDD eksternal → menetapkan library di HDD eksternal sebagai default lalu sinkronisasi ulang dengan iCloud
    Koneksi Ethernet kabel dan fitur Repair sangat membantu

    • Saya penasaran apakah ada bedanya dengan memindahkan file Photos Library ke HDD eksternal lalu mengarahkan Photos.app ke lokasi itu

  • Saya menyalin file foto langsung dari iPhone dengan kombinasi usbmuxd + ifuse
    Tanpa menunggu upload atau download, saya langsung ambil file asli lewat kabel, bahkan bisa memindahkannya untuk membebaskan ruang

    • Saya penasaran apakah cara ini bisa di semua iPhone. Saya ingin tahu apakah folder DCIM bisa di-mount lewat USB dengan izin tulis juga

  • Saya secara berkala mengunduh foto iCloud dengan skrip shell kecil
    Saya menggunakan container icloudpd/icloudpd:latest untuk menyimpan file asli berdasarkan struktur folder

    • Namun memakai tag latest apa adanya itu berisiko. Tidak baik menyerahkan kredensial iCloud ke image yang belum diverifikasi. Lebih aman mengunci ke versi atau hash tertentu

  • Keluarga kami menghasilkan sekitar 2TB media setiap tahun. Totalnya sekitar 12TB
    Fitur Memories di iCloud memang bagus, tetapi biaya 60 dolar per bulan cukup berat, jadi saya melakukan ini

    • Membackup foto dari beberapa akun ke storage lokal dengan docker-icloudpd
    • Hanya menyisakan 2 tahun terakhir di iCloud, sisanya disimpan lokal
    • Foto lama ditelusuri dan dicari dengan Immich. Self-hosted, tetapi pengalaman aplikasinya sangat bagus
      Disk lokal yang cepat (misalnya OWC 4M2 + M.2 SSD) itu penting. NAS berbasis HDD lambat
      Tautan GitHub docker-icloudpd
    • Saya penasaran apakah ada fitur yang dipakai Photos tetapi belum ada di Immich. Saya pengguna Android, jadi saya sudah cukup puas hanya dengan Immich

  • Di iCloud Photos.app, beberapa foto tidak terlihat, tetapi terlihat di Photometor.app (milik Apple)
    Saya frustrasi karena tidak tahu kenapa foto-foto itu tidak muncul di Photos.app

  • Sayang sekali Apple hampir tidak mengizinkan integrasi pihak ketiga
    Saya ingin menyinkronkan otomatis foto dari album tertentu ke bingkai foto orang tua saya atau Samsung Frame TV, tetapi fungsi seperti ini dibatasi
    Rasanya kalau sedikit lebih terbuka saja, akan mungkin ada pemanfaatan yang inovatif

    • Saya menyelesaikan masalah ini dengan PhotoSync. Saya menetapkan aturan sinkronisasi per album agar dikirim otomatis