icloud_photos_downloader README

The project's README from github.com/icloud-photos-downloader/icloud_photos_downloader. As one markdown file: README.md.

!!!! Looking for MAINTAINER for this project !!!!

iCloud Photos Downloader Quality Checks Build and Package MIT License

See Documentation for more details. Also, check Issues

We aim to release new versions once a week (Friday), if there is something worth delivering.

iCloud Prerequisites

To make iCloud Photo Downloader work, ensure the iCloud account is configured with the following settings, otherwise Apple Servers will return an ACCESS_DENIED error:

Install and Run

There are three ways to run icloudpd:

  1. Download executable for your platform from the GitHub Release and run it
  2. Use package manager to install, update, and, in some cases, run (Docker, PyPI, AUR, npm)
  3. Build and run from the source

See Documentation for more details

Features

Experimental Mode

Some changes are added to the experimental mode before they graduate into the main package. Details

Usage

To keep your iCloud photo collection synchronized to your local system:

icloudpd --directory /data --username [email protected] --watch-with-interval 3600

[!IMPORTANT] It is icloudpd, not icloud executable

[!TIP] Synchronization logic can be adjusted with command-line parameters. Run icloudpd --help to get full list.

To independently create and authorize a session (and complete 2SA/2FA validation if needed) on your local system:

icloudpd --username [email protected] --password my_password --auth-only

[!TIP] This feature can also be used to check and verify that the session is still authenticated.

Contributing

Want to contribute to iCloud Photos Downloader? Awesome! Check out the contributing guidelines to get involved.

icloud_photos_downloader (icloud-photos-downloader/icloud_photos_downloader)

Searching Database…

12.3K ·GitHub
Icloud_photos_downloader
Что это такое?icloud_photos_downloader (icloudpd) — это инструмент командной строки, который скачивает все ваши фотографии и видео из iCloud на локальный компьютер.
Команда действительно называется «icloud»?Нет, исполняемый файл называется icloudpd, а не icloud. Эту распространённую путаницу отдельно отмечает README.
Как это запустить?Можно скачать готовый исполняемый файл для вашей платформы из GitHub Release, установить его через менеджер пакетов (Docker, PyPI, AUR или npm) или собрать и запустить из исходного кода.
Нужно ли что-то менять в настройках iCloud перед использованием?Да, нужно включить «Доступ к данным iCloud в Интернете» (Access iCloud Data on the Web) и отключить «Расширенную защиту данных» (Advanced Data Protection) в настройках iCloud вашего Apple ID, иначе серверы Apple вернут ошибку ACCESSDENIED.
Проект сейчас активно поддерживается?В README сейчас есть баннер о том, что проекту нужен новый мейнтейнер, а значит, дальнейшая разработка, вероятно, замедлится.
Можно запустить это на NAS, а не только на ноутбуке?Да, работает в Linux, Windows и macOS на ноутбуках, настольных компьютерах и NAS, а также доступен официальный Docker-образ.
Чем отличаются режимы Copy, Sync и Move?Copy (по умолчанию) только скачивает новые фотографии из iCloud; Sync также удаляет локальные файлы, которые были удалены в iCloud, с помощью опции --auto-delete; Move скачивает фотографии, а затем удаляет их из iCloud, используя --keep-icloud-recent-days.
Поддерживаются ли Live Photos и RAW?Да: Live Photos сохраняются как отдельные файлы изображения и видео, поддерживаются RAW-изображения (включая RAW+JPEG), а фотографии с одинаковыми именами автоматически проходят дедупликацию.
Может ли он постоянно следить за новыми фото, а не работать один раз?Да, опция --watch-with-interval позволяет icloudpd непрерывно отслеживать изменения в iCloud вместо однократного скачивания.
Может ли он обновлять метаданные фото при скачивании?Да, опция --set-exif-datetime обновляет метаданные EXIF у скачанных фотографий, а также доступны другие опции, перечисленные в выводе icloudpd --help.
What are similar projects?pytube, gallery-dl, yoinks, XHS-Downloader, czkawka, skills-manager, rclone, mackup
Which topics is it in?aur, photos, pypi, sync, image, backup, downloader, apple, video, utility, productivity, command-line-tool
Creator
icloud-photos-downloader
Size
45.7 MB
Stars
12.3K
Updated
CommitMay 30Releasev1.32.3May 30
Age
10y
Commits · 90 Days