# 使用 Homebrew 安装 gphotos-uploader-cli

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

## 安装

```sh
sudo av install brew:gphotos-uploader-cli
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install gphotos-uploader-cli
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:gphotos-uploader-cli
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/gphotos-uploader-cli>
- **版本:** 5.1.0
- **来源摘要:** Command-line tool to mass upload media folders to Google Photos
- **主页:** <https://gphotosuploader.github.io/gphotos-uploader-cli/>
- **仓库:** <https://github.com/gphotosuploader/gphotos-uploader-cli>
- **上游文档:** <https://github.com/gphotosuploader/gphotos-uploader-cli#readme>
- **许可证:** MIT
- **源码归档:** <https://github.com/gphotosuploader/gphotos-uploader-cli/archive/refs/tags/v5.1.0.tar.gz>
- **已生成:** 2026-07-08T18:08:21+00:00

## 可执行文件

- gphotos-uploader-cli (cli)
- gphotos-uploader-cli (别名)

## 构建依赖

- go

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-08
- 管理器版本: 5.1.0
- 本地数据: OK
- 上游仓库: https://github.com/gphotosuploader/gphotos-uploader-cli
- 检测到的最新版本: v5.1.0 (当前)
- 信息: No package-manager update timestamp was available.
## 项目历史与用法

Google Photos uploader CLI is a Go command-line tool for uploading local media folders to Google Photos accounts, with configuration-driven jobs, OAuth credentials, secret backends, album rules, filters, and resumable upload behavior.

### 项目历史

The GitHub README explains the original motivation: Google's own uploader covered macOS and Windows, while this project brought a command-line uploader to Linux and other systems that can compile a Go program.

The changelog records early public packaging work in 2018, concurrent upload support in June 2019, secret backend support, a repository transfer into the GPhotos Uploaders organization, and later major releases adapting to Google Photos API scope and authentication changes.

### 采用历史

The project is packaged in Homebrew and documented for macOS and Linux users who want unattended or repeated uploads rather than a desktop sync tool. Its GitHub metadata shows a medium-sized user base for a niche Google Photos automation client, with hundreds of stars and forks.

Adoption is constrained by Google Photos API behavior and OAuth setup. The configuration documentation asks users to create a Google Cloud project, enable the Google Photos Library API, configure OAuth consent, create desktop app credentials, and place client credentials in the HJSON configuration.

### 使用方式

Users configure `~/.gphotos-uploader-cli/config.hjson` with API app credentials, account email, secret backend choice, and one or more jobs. Jobs identify source folders, album behavior, delete-after-upload behavior, and include or exclude patterns.

The changelog shows the CLI growing around real upload concerns: token refresh, resumable uploads, duplicate album handling, file tracking, album listing, media-item listing, redirect URL configuration, and Google Photos API scope changes.

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

The package is interesting because it turns a cloud-photo workflow into a Unix-style batch command. That makes it useful for NAS boxes, photo ingest scripts, headless machines, and users who want a package-managed tool instead of a GUI uploader.

It also demonstrates the maintenance cost of cloud CLIs: OAuth flows, API scopes, quota avoidance, token storage, and upstream API client changes all show up in package history even when the command's user-facing purpose stays simple.

### 时间线

- 2018-09-20: 0.1.11 added GoReleaser-based binary publishing after releases.
- 2019-06-18: 0.2.0 added support for five concurrent uploads and introduced the changelog.
- 2019: 0.3.0 added multiple secret backends through keyring support.
- 2019: 0.6.0 recorded the repository transfer to the GPhotos Uploaders organization.
- 2023: 4.0.0 added client cache behavior, album and media-item listing commands, and progress bars.
- 2025-06-05: 5.1.0 adjusted OAuth redirect URL handling for the auth command.

### Related projects

- Related projects include the gphotosuploader Google Photos API client for Go, Google Photos Library API tooling, keyring-backed secret storage libraries, GoReleaser, and other backup or upload CLIs.

### 来源

- <https://github.com/gphotosuploader/gphotos-uploader-cli>
- <https://github.com/gphotosuploader/gphotos-uploader-cli/blob/main/CHANGELOG.md>
- <https://github.com/gphotosuploader/gphotos-uploader-cli/blob/main/README.md>
- <https://github.com/gphotosuploader/gphotos-uploader-cli/blob/main/docs/configuration.md>
- <https://github.com/gphotosuploader/gphotos-uploader-cli/releases>
- <https://gphotosuploader.github.io/gphotos-uploader-cli/>


## 安全说明

broad file, network, media, or database tool signal.

- **Geiger 风险:** blue / 中
- broad file, network, media, or database tool signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.gphotos-uploader-cli/config.hjson

## Credential files

- Unix: ~/.gphotos-uploader-cli/config.hjson
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** gphotos-uploader-cli
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## 相关链接

- [Source-control packages](https://www.automicvault.com/zh-hans/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/zh-hans/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Archive and compression packages](https://www.automicvault.com/zh-hans/pkg/archive-compression-tools/) - Matched archive or compression metadata.
- [go](https://www.automicvault.com/zh-hans/pkg/brew/go/) - Build dependency declared by Homebrew.
- [dcraw](https://www.automicvault.com/zh-hans/pkg/brew/dcraw/) - Shares av.db curated category or tags: cli, media, photography.
- [dnglab](https://www.automicvault.com/zh-hans/pkg/brew/dnglab/) - Shares av.db curated category or tags: cli, media, photography.
- [gphoto2](https://www.automicvault.com/zh-hans/pkg/brew/gphoto2/) - Shares av.db curated category or tags: cli, media, photography.
- [immich-cli](https://www.automicvault.com/zh-hans/pkg/brew/immich-cli/) - Shares av.db curated category or tags: backup, cli, media, upload.
- [lensfun](https://www.automicvault.com/zh-hans/pkg/brew/lensfun/) - Shares av.db curated category or tags: cli, media, photography.
- [lux](https://www.automicvault.com/zh-hans/pkg/brew/lux/) - Shares av.db curated category or tags: cli, go, media.
- [caire](https://www.automicvault.com/zh-hans/pkg/brew/caire/) - Shares av.db curated category or tags: cli, go, media.
- [ccextractor](https://www.automicvault.com/zh-hans/pkg/brew/ccextractor/) - Shares av.db curated category or tags: cli, media.

## Combined YAML source

View the package source record on GitHub. [combined/gphotos-uploader-cli.yml](https://github.com/automic-vault/db/blob/main/combined/gphotos-uploader-cli.yml)


## 来源

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph