gphotos-uploader-cli配置详解从零配置到高级过滤技巧【免费下载链接】gphotos-uploader-cliCommand line tool to mass upload media folders to your google photos account(s) (Mac OS / Linux)项目地址: https://gitcode.com/gh_mirrors/gp/gphotos-uploader-cli想要高效管理你的Google Photos相册吗gphotos-uploader-cli是一个强大的命令行工具可以让你批量上传媒体文件夹到Google Photos账户。本文将为你提供完整的配置指南从基础设置到高级过滤技巧助你轻松掌握这个实用的Google Photos上传工具。 快速入门安装与基础配置首先你需要克隆仓库并安装gphotos-uploader-cligit clone https://gitcode.com/gh_mirrors/gp/gphotos-uploader-cli cd gphotos-uploader-cli安装完成后运行初始化命令创建配置文件gphotos-uploader-cli init这会生成默认的配置文件~/.gphotos-uploader-cli/config.hjson。让我们来看看基本配置结构{ APIAppCredentials: { ClientID: YOUR_APP_CLIENT_ID ClientSecret: YOUR_APP_CLIENT_SECRET } Account: YOUR_GOOGLE_PHOTOS_ACCOUNT SecretsBackendType: auto Jobs: [] } 获取Google API凭证要使用gphotos-uploader-cli你需要获取Google API凭证。这是配置的关键步骤访问Google Cloud Console创建新项目启用Google Photos Library API配置OAuth同意屏幕创建桌面应用类型的OAuth客户端ID获取Client ID和Client Secret后将它们填入配置文件的APIAppCredentials部分。 配置文件详解基本配置选项Account: 指定要上传的Google账户邮箱地址。SecretsBackendType: 选择凭证存储方式推荐使用auto自动选择auto: 根据操作系统自动选择secret-service: GNOME Keyring (Linux)keychain: macOS Keychainfile: 加密文件存储工作配置JobsJobs部分是配置的核心定义了要上传的文件夹和上传规则Jobs: [ { SourceFolder: /path/to/your/photos Album: template:%_directory% DeleteAfterUpload: false IncludePatterns: [ **/*.jpg, **/*.png ] ExcludePatterns: [ **/ScreenShot* ] } ] 高级过滤技巧1. 智能文件过滤模式gphotos-uploader-cli支持强大的模式匹配语法让你精确控制上传内容基础模式示例IncludePatterns: [ **/*.jpg, **/*.jpeg, **/*.png, **/*.gif ] ExcludePatterns: [ **/thumbnails/**, **/*.tmp ]特殊模式_ALL_FILES_: 匹配所有文件_IMAGE_EXTENSIONS_: Google Photos支持的所有图片格式_RAW_EXTENSIONS_: 支持的RAW格式_ALL_VIDEO_FILES_: 支持的视频格式2. 复杂过滤规则排除特定目录IncludePatterns: [ _ALL_FILES_ ] ExcludePatterns: [ **/Temp/**, **/.trash/** ]按日期过滤IncludePatterns: [ **/2024-*/**/* ] ExcludePatterns: [ **/old/** ]大小写敏感过滤IncludePatterns: [ **/[Pp]hoto*/**/*.jpg ]3. 模式语法详解*: 匹配任意非路径分隔符序列**: 匹配任意序列包括路径分隔符?: 匹配单个非路径分隔符[abc]: 匹配a、b或c中的任意一个字符[a-z]: 匹配a到z范围内的任意字符{jpg,png,gif}: 匹配jpg、png或gif 相册管理策略固定相册名称Album: name:我的假期照片动态模板相册使用模板创建智能相册名称Album: template:%_directory% - %_year%-%_month%可用占位符%_directory%: 文件夹名称%_parent_directory%: 父文件夹名称%_folderpath%: 完整文件夹路径%_day%: 文件创建日DD格式%_month%: 文件创建月MM格式%_year%: 文件创建年YYYY格式模板函数示例Album: template:$title(%_directory%) - %_month%.%_day%.$cutLeft(%_year%,2) 实用配置示例示例1家庭照片备份Jobs: [ { SourceFolder: ~/Pictures/Family Album: template:家庭照片 - %_year%年%_month%月 DeleteAfterUpload: false IncludePatterns: [ _IMAGE_EXTENSIONS_, _ALL_VIDEO_FILES_ ] ExcludePatterns: [ **/.*, **/thumbnails/** ] } ]示例2工作截图整理Jobs: [ { SourceFolder: ~/Desktop/Screenshots Album: name:工作截图 DeleteAfterUpload: true IncludePatterns: [ **/*.png, **/*.jpg ] ExcludePatterns: [ **/personal/** ] } ]示例3多文件夹批量上传Jobs: [ { SourceFolder: ~/Camera/DCIM Album: template:相机照片 - %_month%月 DeleteAfterUpload: false IncludePatterns: [ _IMAGE_EXTENSIONS_ ] }, { SourceFolder: ~/Phone/Photos Album: template:手机照片 - %_month%月 DeleteAfterUpload: false IncludePatterns: [ _IMAGE_EXTENSIONS_, _ALL_VIDEO_FILES_ ] } ]⚙️ 高级配置技巧1. 环境变量配置对于无头服务器运行可以使用环境变量export GPHOTOS_CLI_TOKENSTORE_KEYyour-secret-key gphotos-uploader-cli push2. 自定义配置路径gphotos-uploader-cli --config /custom/path push3. 安全配置检查使用安全打印功能查看配置隐藏敏感信息gphotos-uploader-cli config show --safe 常见问题解决配置验证错误如果遇到配置错误检查以下常见问题API凭证是否正确文件夹路径是否存在模式语法是否正确上传失败排查检查网络连接验证Google账户权限查看日志输出gphotos-uploader-cli push --verbose性能优化建议对于大量文件分批配置多个Jobs使用排除模式过滤不需要的文件类型定期清理已上传的临时文件 最佳实践测试配置先在小文件夹上测试配置增量上传设置DeleteAfterUpload: false直到确认上传成功定期备份重要照片本地备份后再上传监控日志使用--verbose参数查看详细上传过程 开始使用现在你已经掌握了gphotos-uploader-cli的完整配置方法。从基础设置到高级过滤技巧这个强大的命令行工具能够帮助你高效管理Google Photos相册。记住良好的配置是成功的一半。花时间设置合适的过滤规则和相册模板将大大提升你的照片管理效率。开始你的Google Photos自动化上传之旅吧【免费下载链接】gphotos-uploader-cliCommand line tool to mass upload media folders to your google photos account(s) (Mac OS / Linux)项目地址: https://gitcode.com/gh_mirrors/gp/gphotos-uploader-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考