安装

其他安装命令

macOS

Homebrew已验证 · 100%

brew install gphotos-uploader-cli

local Homebrew formula metadata

概览

软件包摘要

Command-line tool to mass upload media folders to Google Photos

项目链接

命令和别名

gphotos-uploader-cli

历史

项目历史与用法

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.

来源

安全态势

风险级别：blue

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

风险分类器

blue 风险 · 中置信度 · tool

原因

broad file, network, media, or database tool signal

信号

text:upload,media

安装行为

formula 元数据中未记录 Homebrew post-install 钩子。
Homebrew bottle 元数据适用于 6 个平台目标。
构建元数据列出 1 个构建依赖。

建议审查

在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。

local files

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

Config paths the tool may read or write during local use.

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

Credential files

Credential-bearing paths to review before unattended agent runs.

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

可执行文件

已安装的可执行文件

命令	类型	暴露范围	备注
`gphotos-uploader-cli`	cli	全局可执行文件

新鲜度

版本和新鲜度

这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。

页面生成时间2026-07-08

管理器版本5.1.0

管理器更新时间

本地数据OK

上游当前

检测到的最新版本v5.1.0

https://github.com/gphotosuploader/gphotos-uploader-cli

信息No package-manager update timestamp was available.低置信度

安装元数据

软件包元数据

软件包键	brew:gphotos-uploader-cli
版本	5.1.0
软件包管理器	Homebrew
软件包管理器页面	https://formulae.brew.sh/formula/gphotos-uploader-cli
主页	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
构建依赖	go
Bottle	可用 (于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	未定义
服务	未声明

注册表事实

源数据库详情

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

软件包图谱

链接来自本地软件包关系图、补充数据、依赖边、生态匹配和软件包 hub 归属。

来源线索

由仓库数据生成

此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。

Combined YAML source

View the package source record on GitHub.

combined/gphotos-uploader-cli.yml

使用的来源

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

使用 Homebrew 安装 gphotos-uploader-cli