# 使用 Homebrew, Nix, chocolatey 安装 icloudpd

查看 icloudpd 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:icloudpd
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install icloudpd
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#icloudpd
```

  证据: 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
```

  证据: Chocolatey community package catalog: iCloud from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','i2pd'

## 软件包事实

- **软件包键:** brew:icloudpd
- **软件包管理器:** Homebrew
- **版本:** 1.32.3
- **来源摘要:** Tool to download photos from iCloud
- **主页:** <https://github.com/icloud-photos-downloader/icloud_photos_downloader>
- **仓库:** <https://github.com/icloud-photos-downloader/icloud_photos_downloader>
- **最后更新:** 2026-05-30T04:31:46Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- icloud (别名)
- icloudpd (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 1.32.3
## 项目历史与用法

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.

### 项目历史

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.

### 采用历史

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.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- 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.


## 安全说明

broad file, network, media, or database tool signal. infrastructure mutation or orchestration signal.

- **Geiger 风险:** orange / 中
- broad file, network, media, or database tool signal
- infrastructure mutation or orchestration signal

## 其他软件包管理器记录

- 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','i2pd'


## Combined YAML source

View the package source record on GitHub. [combined/icloudpd.yml](https://github.com/mxcl/pkgdb/blob/main/combined/icloudpd.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph