# Install icloudpd with Homebrew, Nix, chocolatey Tool to download photos from iCloud. Version 1.32.3 via Homebrew; verified 2026-05-30. ## Install ```sh sudo av install brew:icloudpd ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install icloudpd ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#icloudpd ``` Evidence: nixpkgs package indexes: pkgs/by-name/ic/icloudpd/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ### Windows - Chocolatey (92%): ```sh choco install iCloud ``` Evidence: Chocolatey community package catalog: iCloud from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','hexchat' ## Package facts - **Package key:** brew:icloudpd - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.32.3 - **Source summary:** Tool to download photos from iCloud - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-05-30T04:31:46Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - icloud (cli) - icloudpd (cli) - icloud (alias) - icloudpd (alias) ## Dependencies - certifi - python@3.14 ## Build dependencies - gnu-sed ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.32.3 - Package-manager updated: 2026-05-30 - Local data: ok - Upstream repository: https://github.com/icloud-photos-downloader/icloud_photos_downloader - info: No cached GitHub release or tag data was available. ## Project history and usage iCloud Photos Downloader, packaged by Homebrew as icloudpd, is a volunteer-maintained command-line tool for downloading iCloud Photos libraries to local storage on Linux, Windows, macOS, desktop systems, laptops, and NAS setups. ### Project history The Python package name icloudpd appeared on PyPI with a 1.0.0 upload on 2018-07-30. The project later organized around the icloud-photos-downloader GitHub organization and Sphinx documentation site, presenting the tool as a cross-platform command-line downloader for iCloud photos and videos. The README documents three operational modes: copy, sync, and move. That evolution is important because the tool is not just a one-shot exporter; it grew into a repeatable backup/synchronization utility with options for incremental runs, Live Photos, RAW assets, duplicate handling, EXIF timestamp updates, a Web UI, and NAS-oriented operation. ### Adoption history Distribution moved beyond source installs into package-manager ecosystems. The README points users to packaged binaries and package-manager installs through Docker, PyPI, AUR, and npm, while Homebrew packages the same project as icloudpd. The Homebrew formula packages the project from its Git repository and wraps its Python dependencies, making the tool part of the Unix-like backup-tool shelf for users who want iCloud Photos exports without a graphical Apple Photos workflow. ### How it is used The documented command-line pattern is to run icloudpd against a destination directory and Apple account, with watch, sync, or auth-only modes depending on whether the user wants a recurring backup, a mirror-like local copy, or a reusable authenticated session. The docs emphasize Apple-side prerequisites such as iCloud web data access and Advanced Data Protection behavior, so reliable use depends as much on account configuration as on the package installation. ### Why package nerds care Package maintainers care about icloudpd because it bridges a consumer cloud service and scriptable local backup workflows. It also exercises Python packaging, native keyring/authentication dependencies, binary artifacts, Docker images, and multi-platform CLI behavior in one small formula. The formula is a practical example of Homebrew packaging a Python CLI with a fast-moving upstream and nontrivial runtime authentication behavior, rather than a simple stateless text filter. ### Timeline - 2018: icloudpd 1.0.0 appears on PyPI. - 2020s: Project documentation expands around install, authentication, naming, operation modes, asset handling, Web UI, NAS use, and CLI reference. - 2026: The README describes weekly releases when there is something worth delivering and asks for volunteer maintainers. ### Related projects - The project is related to pyicloud-style iCloud automation, Apple Photos export workflows, NAS backup scripts, Dockerized home-lab backup jobs, and package-manager distributions such as PyPI, Docker, AUR, npm, and Homebrew. ### Sources - Homebrew formula metadata documents the brew package name, description, source URL, version, dependencies, and install surface. - Project README and documentation describe purpose, supported platforms, package-manager channels, release cadence, prerequisites, operation modes, and usage examples. - PyPI metadata provides the package publication timeline. ## Security Notes broad file, network, media, or database tool signal. infrastructure mutation or orchestration signal. - **Geiger risk:** orange / medium - broad file, network, media, or database tool signal - infrastructure mutation or orchestration signal ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** icloudpd - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - icloudpd: normalized package name match | nixpkgs package indexes: pkgs/by-name/ic/icloudpd/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Chocolatey - iCloud: installed executable or alias match | Chocolatey community package catalog: iCloud from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','hexchat' ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Archive and compression packages](https://www.automicvault.com/pkg/archive-compression-tools/) - Matched archive or compression metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [gnu-sed](https://www.automicvault.com/pkg/brew/gnu-sed/) - Build dependency declared by Homebrew. - [evernote-backup](https://www.automicvault.com/pkg/brew/evernote-backup/) - Shares av.db curated category or tags: backup, cli, productivity. - [grsync](https://www.automicvault.com/pkg/brew/grsync/) - Shares av.db curated category or tags: backup, cli, productivity. - [gyb](https://www.automicvault.com/pkg/brew/gyb/) - Shares av.db curated category or tags: backup, cli, productivity. - [pinboard-notes-backup](https://www.automicvault.com/pkg/brew/pinboard-notes-backup/) - Shares av.db curated category or tags: backup, cli, productivity. - [mackup](https://www.automicvault.com/pkg/brew/mackup/) - Shares av.db curated category or tags: backup, cli, productivity. - [megatools](https://www.automicvault.com/pkg/brew/megatools/) - Shares av.db curated category or tags: cli, download, productivity. - [neverest](https://www.automicvault.com/pkg/brew/neverest/) - Shares av.db curated category or tags: backup, cli, productivity. - [pytr](https://www.automicvault.com/pkg/brew/pytr/) - Shares av.db curated category or tags: cli, download, productivity. ## Combined YAML source View the package source record on GitHub. [combined/icloudpd.yml](https://github.com/automic-vault/db/blob/main/combined/icloudpd.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph