iCloud Photos Downloader

• Ferramenta de código aberto que permite baixar diretamente pela linha de comando as fotos da conta do iCloud
• Pode ser executada nos principais sistemas operacionais, como Linux, Windows e macOS, com suporte de instalação via Docker, PyPI, AUR e npm
• Opera em três modos: Copy, Sync e Move, incluindo suporte para Live Photos, imagens RAW e metadados EXIF
• Oferece várias opções, como remoção automática de duplicatas, monitoramento contínuo de alterações e otimização de execução incremental
• É distribuída sob a licença MIT e atualmente está procurando um maintainer

---

Visão geral do projeto

• iCloud Photos Downloader é uma ferramenta de linha de comando para baixar para o sistema local as fotos armazenadas no iCloud
  • É possível baixar toda a biblioteca de fotos do iCloud ou sincronizar apenas as alterações
  • É desenvolvida e mantida por uma comunidade de voluntários, que está recrutando novos contribuidores
• Distribuída sob a licença MIT, permitindo uso e modificação livremente
• No GitHub, possui mais de 10 mil estrelas (stars) e 705 forks

Plataformas compatíveis e formas de distribuição

• Compatibilidade com sistemas operacionais: suporte a Linux, Windows, macOS e ambientes NAS
• Canais de distribuição:
  • Imagem Docker
  • Pacote PyPI
  • Arch Linux AUR
  • Pacote npm
• Também é possível baixar diretamente o executável ou compilar a partir do código-fonte

Principais recursos

• Três modos de operação
  • Copy: baixa apenas fotos novas (modo padrão)
  • Sync: remove localmente as fotos apagadas no iCloud (--auto-delete)
  • Move: apaga as fotos do iCloud após o download (--keep-icloud-recent-days)
• Formatos suportados: Live Photos (armazenando imagem e vídeo separadamente), RAW e RAW+JPEG
• Opções de recurso
  • Remoção automática de duplicatas para fotos com o mesmo nome
  • Modo de monitoramento contínuo (--watch-with-interval)
  • Otimização de execução incremental (--until-found, --recent)
  • Ajuste de metadados EXIF (--set-exif-datetime)
• É possível ver todas as opções com o comando --help

Instalação e execução

• Métodos de instalação
  1. Baixar o executável na página de releases do GitHub
  2. Instalar com um gerenciador de pacotes (Docker, PyPI, AUR, npm)
  3. Compilar diretamente do código-fonte
• Requisitos de configuração do iCloud
  • Ativar Access iCloud Data on the Web no iPhone/iPad
  • É necessário desativar Advanced Data Protection
• Exemplos de uso
  • Executar sincronização:

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

  • Criar sessão de autenticação:

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

Recursos experimentais e status de desenvolvimento

• Alguns recursos são adicionados primeiro no Experimental Mode e, após validação, incorporados oficialmente
• A release mais recente é v1.32.2 (2 de setembro de 2025)
• O objetivo é lançar novas versões uma vez por semana (sexta-feira)
• Commits recentes incluem suporte a configuração para múltiplos usuários, correções para builds não Linux e melhorias no ambiente de testes

Contribuição e comunidade

• Desenvolvedores externos podem participar por meio das diretrizes de contribuição (CONTRIBUTING.md)
• 42 contribuidores participaram do código, com uso também de ferramentas de automação como o Dependabot
• O projeto está recrutando publicamente um maintainer
• A documentação oficial e as discussões acontecem no GitHub Discussions

[GN⁺]

Comentários do Hacker News

• Sou o criador do Photos Backup Anywhere. O que me surpreendeu ao analisar o Apple Photos foi que apenas os arquivos no disco não conseguem representar o estado completo
  Álbuns, Live Photos, fotos em sequência, câmera lenta, histórico de edições, alterações na data da captura etc. são gerenciados separadamente, e a maioria das ferramentas de backup não consegue reconstruir isso corretamente na restauração
  Por isso, tratei o próprio Photos como a fonte da verdade (source of truth) e adotei uma abordagem que valida a restauração com base nele
  Essa ferramenta restaura completamente álbuns e todos os tipos de foto, preservando localização, data de criação e data de modificação
  A página do projeto está em photosbackup.app

  • Quando transfiro fotos do iPhone, copio em blocos de 0 a 9999 com o app “Image Capture”. Quando passa de 10 mil fotos, o nome do arquivo volta para 00001(1), o que é bem inconveniente
    O SSD do MacBook é pequeno e eu não quero passar pelo iCloud; queria saber se existe alguma forma de exportar RAW/JPEG/Live/Video originais diretamente para um drive externo
  • Tive uma experiência realmente de pesadelo ao extrair fotos de um celular Android antigo. Se a interface não aparece direito, você acaba dependente de ferramentas que vasculham o drive inteiro
  • Queria saber se há suporte para backup em armazenamento compatível com S3 (ex.: Backblaze B2)
  • Você já deu uma olhada no Parachute Backup? Eles também afirmam conseguir fazer backup até dos dados complexos do iPhotos

• Esse projeto é realmente incrível. Talvez consiga substituir o app do iCloud para Windows
  Eu também tenho cerca de 2 TB de dados no iCloud, mas o MacBook não tem espaço suficiente e mantenho uma Photo Library separada em um drive externo
  O app do iCloud para Windows está sempre baixando a 50 MB/s, mas quando abro a pasta, a maioria dos itens aparece como “disponível somente online”
  No momento, já baixou cerca de 944 GB, mas parece que ainda vai demorar para terminar totalmente
  Queria saber se existe algum visualizador de fotos alternativo no Windows que mostre corretamente HEIC e Live Photo

• Existe o Parachute, um programa pago, embora seja só para macOS. Ele consegue baixar todas as fotos e arquivos da biblioteca do iCloud
  Link da App Store

  • No iOS, o PhotoSync também é bom. Ele consegue enviar fotos para NAS ou serviços remotos como o B2
  • O Parachute é estável na versão desktop, mas a versão para iOS não consegue concluir durante a noite o backup incremental de uma biblioteca de 1 TB
    Ele exporta os originais, mas não inclui os arquivos AAE. Já o PhotoSync deixa a desejar por não ter função de restauração
  • Perguntei se ele é compatível com contas com ADP, mas não recebi resposta. Também queria saber se existe alguma solução de download decente para contas com ADP
  • Também gostaria de saber se dá para verificar a segurança em termos de privacidade e se existe alguma alternativa para Windows

• Surpreendentemente, não existe um método oficial para baixar de uma vez todas as fotos do iCloud (cerca de 400 GB)
  Em vez disso, dá para receber todas as fotos do iCloud com uma ferramenta de linha de comando open source

  • Na verdade, no Mac ou no iPhone, é possível baixar tudo escolhendo “Baixar originais” nas configurações da Biblioteca de Fotos do iCloud
  • Se você for usuário da UE, pode solicitar todos os dados que a Apple mantém sobre você em privacy.apple.com
  • No app Photos do Mac, dá para exportar os originais com Cmd+A > File > Export Unmodified Originals
  • Talvez seja intencional da Apple para dificultar a saída do usuário. Tornar a migração de fotos difícil parece uma estratégia de lock-in

• Há alguns dias fiz backup de uma biblioteca compartilhada, lidando com cerca de 10 mil fotos e vídeos (300 GB)
  Recuperar a biblioteca do iPhoto → exportar separando por ano → mover para um HDD externo → definir a biblioteca do HDD externo como padrão e resincronizar com o iCloud
  Uma conexão Ethernet cabeada e o recurso de Repair ajudaram bastante

  • Gostaria de saber se há diferença em relação a simplesmente mover o arquivo da Photos Library para o HDD externo e apontar o Photos.app para esse caminho

• Eu copio os arquivos de foto diretamente do iPhone com a combinação usbmuxd + ifuse
  Sem esperar upload ou download: conecto por cabo, pego os originais e até movo os arquivos para liberar espaço

  • Queria saber se isso funciona em todos os iPhones. Dá para montar a pasta DCIM via USB e ainda obter permissão de escrita?

• Eu baixo periodicamente as fotos do iCloud com um pequeno script shell
  Uso o contêiner icloudpd/icloudpd:latest para salvar os originais organizados por estrutura de pastas

  • Mas usar a tag latest desse jeito é arriscado. Não é uma boa ideia entregar suas credenciais do iCloud para uma imagem não verificada. É mais seguro fixar em uma versão específica ou hash

• Nossa família gera cerca de 2 TB de mídia por ano. No total, isso dá algo em torno de 12 TB
  O recurso de memórias do iCloud é bom, mas 60 dólares por mês pesa, então fazemos o seguinte

  • Fazemos backup das fotos de várias contas para armazenamento local com docker-icloudpd
  • Mantemos no iCloud apenas os 2 anos mais recentes, e o restante fica armazenado localmente
  • Para navegar e pesquisar fotos antigas, usamos o Immich. É self-hosted, mas a experiência do app é excelente
    Um disco local rápido (ex.: OWC 4M2 + SSD M.2) é importante. NAS com HDD é lento
    Link do GitHub do docker-icloudpd
  • Queria saber se há algum recurso do Photos que você usa e que não existe no Immich. Eu uso Android, então o Immich sozinho já me satisfaz totalmente

• No iCloud Photos.app, algumas fotos não aparecem, mas no Photometor.app (da Apple) elas aparecem
  Não consigo entender por que elas não aparecem no Photos.app, e isso é frustrante

• É uma pena que a Apple praticamente não permita integração de terceiros
  Eu queria sincronizar automaticamente as fotos de um álbum específico com a moldura digital dos meus pais ou com uma Samsung Frame TV, mas esse tipo de recurso é bloqueado
  Com só um pouco mais de abertura, parece que daria para criar usos inovadores

  • Eu resolvo esse problema com o PhotoSync. Defino regras de sincronização por álbum e ele faz a transferência automática