# 使用 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
- **版本:** 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>
- **最后更新:** 2026-07-29T16:05:05+02:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- gphotos-uploader-cli (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

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

## Combined YAML source

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


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph