iCloud Photos Downloader

 (github.com/icloud-photos-downloader)
3 puan yazan GN⁺ 2026-01-12 | 1 yorum | WhatsApp'ta paylaş
  • iCloud hesabındaki fotoğrafları doğrudan komut satırından indirmenizi sağlayan açık kaynaklı bir araç
  • Linux, Windows, macOS gibi başlıca işletim sistemlerinde çalışır ve Docker·PyPI·AUR·npm üzerinden kurulum desteği sunar
  • Copy·Sync·Move olmak üzere üç modda çalışır; Live Photos·RAW görüntüler·EXIF meta verisi işleme özelliklerini içerir
  • Otomatik tekrar edenleri kaldırma, sürekli değişiklik izleme, artımlı çalıştırma optimizasyonu gibi çeşitli seçenekler sunar
  • MIT lisansı ile yayımlanmıştır ve şu anda bir maintainer arıyor

Proje Genel Bakışı

  • iCloud Photos Downloader, iCloud'da depolanan fotoğrafları yerel sisteme indiren komut satırı tabanlı bir araçtır
    • Tüm iCloud fotoğraflarını indirebilir veya yalnızca değişiklikleri senkronize edebilir
    • Gönüllü topluluk tarafından geliştiriliyor ve sürdürülüyor; yeni katkı sunanlar aranıyor
  • MIT lisansı ile dağıtılır; serbest kullanım ve değiştirme imkânı sunar
  • GitHub'da 10 binden fazla yıldız ve 705 fork bulunuyor

Desteklenen Platformlar ve Dağıtım Yöntemleri

  • İşletim sistemi uyumluluğu: Linux, Windows, macOS, NAS ortamları desteklenir
  • Dağıtım kanalları:
    • Docker imajı
    • PyPI paketi
    • Arch Linux AUR
    • npm paketi
  • Çalıştırılabilir dosya doğrudan indirilebilir veya kaynak koddan derlenebilir

Başlıca Özellikler

  • Üç çalışma modu
    • Copy: Yalnızca yeni fotoğrafları indirir (varsayılan mod)
    • Sync: iCloud'dan silinen fotoğrafları yerelde de siler (--auto-delete)
    • Move: İndirdikten sonra fotoğrafları iCloud'dan siler (--keep-icloud-recent-days)
  • Desteklenen formatlar: Live Photos (görüntü ve video ayrı kaydedilir), RAW ve RAW+JPEG
  • Özellik seçenekleri
    • Aynı ada sahip fotoğraflar için otomatik tekrar kaldırma
    • Sürekli izleme modu (--watch-with-interval)
    • Artımlı çalıştırma optimizasyonu (--until-found, --recent)
    • EXIF meta verisini düzenleme (--set-exif-datetime)
  • Tüm seçenekler --help komutuyla görülebilir

Kurulum ve Çalıştırma

  • Kurulum yöntemleri
    1. Çalıştırılabilir dosyayı GitHub sürüm sayfasından indirme
    2. Paket yöneticisiyle (Docker, PyPI, AUR, npm) kurulum
    3. Kaynak kodu doğrudan derleme
  • iCloud ayar gereksinimleri
    • iPhone/iPad üzerinde Access iCloud Data on the Web etkinleştirilmeli
    • Advanced Data Protection devre dışı olmalı
  • Kullanım örnekleri
    • Senkronizasyon çalıştırma: 
      icloudpd --directory /data --username my@email.address --watch-with-interval 3600
    • Kimlik doğrulama oturumu oluşturma: 
      icloudpd --username my@email.address --password my_password --auth-only

Deneysel Özellikler ve Geliştirme Durumu

  • Bazı özellikler önce Experimental Mode olarak ekleniyor, doğrulandıktan sonra resmî olarak dahil ediliyor
  • En güncel sürüm v1.32.2 (2 Eylül 2025)
  • Yeni sürümlerin haftada bir kez (Cuma) yayımlanması hedefleniyor
  • Son commit'lerde çok kullanıcılı yapılandırma desteği, Linux dışı derleme düzeltmeleri, test ortamı iyileştirmeleri gibi değişiklikler yer alıyor

Katkı ve Topluluk

  • Harici geliştiriciler katkı yönergeleri (CONTRIBUTING.md) üzerinden katılabilir
  • Koda 42 katkıda bulunan kişi katılmış durumda; Dependabot gibi otomasyon araçları da kullanılıyor
  • Proje şu anda açık şekilde bir bakım sorumlusu arıyor
  • Resmî belgeler ve tartışmalar GitHub Discussions üzerinden yürütülüyor

İlgili okumalar

1 yorum

 
GN⁺ 2026-01-12
Hacker News yorumları

  • Ben Photos Backup Anywhere'in geliştiricisiyim. Apple Photos'u incelerken beni şaşırtan şey, yalnızca diskteki dosyalarla tüm durumu temsil etmenin mümkün olmamasıydı
    Albümler, Live Photos, seri çekim, ağır çekim, düzenleme geçmişi, çekim tarihindeki değişiklikler vb. ayrı yönetiliyor ve çoğu yedekleme aracı geri yükleme sırasında bunları düzgün şekilde yeniden oluşturamıyor
    Bu yüzden ben Photos'un kendisini gerçeğin kaynağı (source of truth) olarak görüyor ve geri yükleme sırasında buna göre doğrulama yapan bir yaklaşım benimsiyorum
    Bu araç, konum, oluşturulma tarihi ve değiştirilme tarihini koruyarak albümleri ve tüm fotoğraf türlerini eksiksiz biçimde geri yüklüyor
    Proje sayfası burada: photosbackup.app

    • Fotoğrafları iPhone'dan taşırken 'Image Capture' uygulamasıyla 0~9999 aralıklarında kopyalıyorum. 10 bin dosyayı geçince dosya adı tekrar 00001(1) olarak dönüyor ve bu can sıkıcı oluyor
      MacBook SSD kapasitem küçük ve iCloud üzerinden geçmek istemiyorum; orijinal RAW/JPEG/Live/Video dosyalarını doğrudan harici sürücüye aktarmanın bir yolu olup olmadığını merak ediyorum
    • Eski bir Android telefondan fotoğraf çıkarmak gerçekten kâbus gibi bir deneyimdi. Arayüz düzgün gelmezse tüm sürücüyü tarayan araçlara bel bağlamak gerekiyor
    • Acaba S3 uyumlu depolamaya (ör. Backblaze B2) yedeklemeyi destekliyor mu?
    • Hiç Parachute Backup'a baktın mı? Onlar da iPhotos'un karmaşık verilerine kadar yedekleme yapabildiğini iddia ediyor

  • Bu proje gerçekten harika. Windows için iCloud uygulamasının yerini alabilir gibi görünüyor
    Bende de yaklaşık 2TB iCloud verisi var, ama MacBook'un kapasitesi yetmiyor ve harici sürücüde ayrı bir Photo Library tutuyorum
    Windows için iCloud uygulaması sürekli 50MB/s hızla indiriyor gibi görünüyor ama klasörü açınca çoğu dosya hâlâ 'yalnızca çevrimiçi kullanılabilir' durumunda
    Şu anda yaklaşık 944GB indirdi, ama tamamen bitmesi zaman alacak gibi
    Windows'ta HEIC ve Live Photo'yu düzgün gösterebilen bir alternatif fotoğraf görüntüleyici olup olmadığını merak ediyorum

  • Sadece macOS için olsa da ücretli Parachute adlı bir uygulama var. iCloud kütüphanesindeki fotoğrafları ve dosyaları tamamen indirebiliyor
    App Store bağlantısı

    • iOS'ta PhotoSync de fena değil. Fotoğrafları NAS veya B2 gibi uzak servislere gönderebiliyor
    • Parachute'un masaüstü sürümü stabil, ama iOS sürümü 1TB'lık kütüphanenin artımlı yedeğini bir gece boyunca tamamlayamadı
      Orijinalleri dışa aktarıyor ama AAE dosyalarını dahil etmiyor. Öte yandan PhotoSync'in geri yükleme özelliğinin olmaması da can sıkıcı
    • ADP hesabıyla uyumlu olup olmadığını sordum ama yanıt alamadım. ADP hesapları için işe yarar bir indirme çözümü olup olmadığını da merak ediyorum
    • Gizlilik açısından güvenlik doğrulamasının yapılıp yapılamayacağını ve Windows için bir alternatif olup olmadığını da bilmek isterim

  • Şaşırtıcı biçimde, iCloud'dan tüm fotoğrafları (yaklaşık 400GB) tek seferde indirmenin resmî bir yolu yok
    Bunun yerine tüm iCloud fotoğraflarını alabilen açık kaynaklı bir komut satırı aracı var

    • Aslında Mac veya iPhone'da iCloud Photo Library ayarlarında 'orijinalleri indir' seçilirse hepsini indirmek mümkün
    • AB kullanıcısıysanız privacy.apple.com üzerinden Apple'ın elinde bulunan tüm verilerinizi talep edebilirsiniz
    • Mac'teki Photos uygulamasında Cmd+A > File > Export Unmodified Originals ile orijinalleri dışa aktarabilirsiniz
    • Apple'ın kullanıcıların ayrılmasını zorlaştırmak istemesi de mümkün. Fotoğrafları taşımayı zorlaştırması bir kilitleme stratejisi gibi görünüyor

  • Birkaç gün önce paylaşılan bir kütüphaneyi yedekledim; yaklaşık 10 bin fotoğraf ve video (300GB) vardı
    iPhoto kütüphanesini kurtarma → yıllara göre bölüp dışa aktarma → harici HDD'ye taşıma → harici HDD'deki kütüphaneyi varsayılan olarak seçip iCloud ile yeniden eşzamanlama
    Kablolu Ethernet bağlantısı ve Repair özelliği çok yardımcı oldu

    • Photos Library dosyasını harici HDD'ye taşıyıp Photos.app içinde o yolu göstermenin bundan farkı olup olmadığını merak ediyorum

  • Ben iPhone'dan fotoğraf dosyalarını doğrudan usbmuxd + ifuse kombinasyonuyla kopyalıyorum
    Yükleme veya indirme beklemeden kabloyla doğrudan bağlanıp orijinalleri alabiliyorum, hatta taşıyarak alan da açabiliyorum

    • Bunun tüm iPhone'larda mümkün olup olmadığını merak ediyorum. DCIM klasörünü USB ile mount edip yazma izni alabiliyor musunuz?

  • Ben küçük bir shell script ile düzenli olarak iCloud fotoğraflarını indiriyorum
    Klasör yapısına göre orijinalleri saklamak için icloudpd/icloudpd:latest container'ını kullanıyorum

    • Ama latest etiketini olduğu gibi kullanmak riskli. Doğrulanmamış bir imaja iCloud kimlik bilgilerini vermek iyi fikir değil. Belirli bir sürüme ya da hash'e sabitlemek daha güvenli

  • Ailem her yıl yaklaşık 2TB medya üretiyor. Toplamda yaklaşık 12TB oldu
    iCloud'un anılar özelliği güzel ama aylık 60 dolar fazla geldiği için şunu yapıyoruz

    • Birden fazla hesabın fotoğraflarını yerel depolamaya yedeklemek için docker-icloudpd kullanıyoruz
    • Yalnızca son 2 yılı iCloud'da bırakıp daha eski olanları yerelde tutuyoruz
    • Eski fotoğrafları gezmek ve aramak için Immich kullanıyoruz. Kendi kendine barındırılıyor ama uygulama deneyimi mükemmel
      Hızlı yerel diskler (ör. OWC 4M2 + M.2 SSD) önemli. HDD tabanlı NAS yavaş kalıyor
      docker-icloudpd GitHub bağlantısı
    • Photos'ta kullandığınız ama Immich'te olmayan özellikler var mı diye merak ediyorum. Ben Android kullanıyorum, Immich tek başına bana fazlasıyla yetiyor

  • iCloud Photos.app içinde bazı fotoğraflar görünmüyor ama Photometor.app'te (Apple'a ait) görünüyor
    Photos.app'te neden görünmediklerini anlayamadığım için sinir bozucu oluyor

  • Apple'ın üçüncü taraf entegrasyonlarına neredeyse hiç izin vermemesi üzücü
    Belirli bir albümdeki fotoğrafları ebeveynlerimin dijital çerçevesiyle ya da Samsung Frame TV ile otomatik eşzamanlamak istiyorum ama bu tür şeyler engellenmiş durumda
    Biraz daha açık olsa yenilikçi kullanım senaryoları mümkün olabilirdi

    • Ben bu sorunu PhotoSync ile çözüyorum. Albüm bazında eşzamanlama kuralları tanımlayıp otomatik aktarım yapıyor