muyouming/gphotosuploader

G Photos Uploader - Beta

https://travis-ci.org/muyouming/gphotosuploader.svg?branch=master](https://travis-ci.org/muyouming/gphotosuploader)

重要通知： 自2018年9月1日起，本项目将被弃用，因为Google已发布官方Google Photos API。
基于新API的项目包括：

• https://github.com/nmrshll/gphotos-uploader-cli%EF%BC%88%E5%91%BD%E4%BB%A4%E8%A1%8C%E4%B8%8A%E4%BC%A0%E5%B7%A5%E5%85%B7%EF%BC%89
• https://github.com/nmrshll/google-photos-api-client-go%EF%BC%88Go%E5%AE%A2%E6%88%B7%E7%AB%AF%E5%BA%93%EF%BC%89
  新项目目前会占用您的存储配额，一旦客户端压缩功能实现，本项目将正式弃用。

为什么需要这个工具？

Google Photos没有Linux桌面上传器，且（曾经）没有可编程上传照片的API（现在已有https://developers.google.com/photos/%EF%BC%89%E3%80%82
G Photos Uploader允许您从Linux（理论上，任何可编译Go程序的操作系统）上传照片，支持指定文件名或监控目录变化。此外，该项目还可作为库集成到其他Go程序中。

免责声明

G Photos Uploader是一个非官方工具，我（及任何可能的贡献者）不保证任何结果。任何安全或其他类型的问题均由您自行承担风险。

依赖要求

使用该工具需要安装https://golang.org/%E5%92%8CGit%EF%BC%88%E4%BE%9B%60go get`下载依赖）。如果使用认证向导，还需要WebDriver。

安装

sh
go get github.com/muyouming/gphotosuploader

使用方法

独立工具

启动工具的两种方式：

1. 将$GOPATH/bin添加到路径中：这样您只需输入gphotosuploader即可启动程序（若不指定auth.json和uploaded.txt路径，这些文件将在当前工作目录创建）；
2. 进入项目文件夹并执行go run main.go。

使用独立工具前需完成认证。认证通过包含Cookie和用户ID的JSON文件实现。

认证

每次运行工具时，会检查认证文件。若文件不存在或Cookie过期，工具会询问是否运行向导获取新Cookie。

认证向导

认证向导使用WebDriver协议（通常用于自动化测试），允许工具控制浏览器并读取Cookie。需安装WebDriver（如chromedriver）：

• Ubuntu系统：

sh
sudo apt-get install chromium-chromedriver
# 创建链接以便直接输入'chromedriver'启动
sudo ln -s /usr/lib/chromium-browser/chromedriver /usr/bin/chromedriver
# 启动
chromedriver

• macOS系统： 安装Homebrew后执行：

sh
brew install chromedriver
# 启动
chromedriver

• Windows系统：
  1. 从https://sites.google.com/a/chromium.org/chromedriver/downloads%E4%B8%8B%E8%BD%BD%E6%9C%80%E6%96%B0Chrome Web Driver；
  2. 将chromedriver.exe复制到路径中（例如C:\WINDOWS）；
  3. 通过命令提示符或Win键+R输入chromedriver.exe启动。

注意：若在无头机器上运行G Photos Uploader，可在另一台机器上启动chromedriver：

sh
chromedriver --whitelisted-ips="无头机器IP"

Driver启动后会打印监听地址。在工具中输入浏览器名称（参考https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities%E4%B8%AD%E7%9A%84browserName%EF%BC%89%E5%92%8CWebDriver%E5%9C%B0%E5%9D%80%EF%BC%8C%E4%BC%9A%E5%BC%B9%E5%87%BAGoogle Photos登录页面。登录后工具会读取Cookie并保存到认证文件，然后关闭浏览器窗口。此时可停止WebDriver服务器。

通过Chrome扩展认证

您也可通过Chrome扩展获取认证文件，详情见https://github.com/muyouming/gphotosuploader/tree/master/crx-auth%E3%80%82

上传照片或监控目录

完成认证后即可使用工具。例如：

• 上传单张图片：

sh
gphotosuploader --upload ./image.png

• 监控目录：

sh
gphotosuploader --watch path/to/photos --maxConcurrent 4

• 上传旧目录照片并监控新目录：

sh
gphotosuploader --upload /path/to/old/photos --upload /downloads/cat.png --watch path/to/new/photos

• 添加照片到指定现有相册：

sh
gphotosuploader --album albumId --upload ./image.png

其中albumId是打开相册时URL中的字符串（例如：https://photos.google.com/u/2/album/album_id%EF%BC%89%E3%80%82

• 创建新相册并添加照片：

sh
gphotosuploader --albumName foo --upload ./image.png

工具会创建一个文件（默认名称：uploaded.txt）记录已上传文件，避免重复上传。您可通过uploadedList参数指定自定义文件。使用--help查看所有可用参数。

作为库使用

您可查看简单示例此处或获取文档http://godoc.org/github.com/muyouming/gphotosuploader%E3%80%82

开发

若要继续开发此工具/库，请先执行以下脚本：

sh
githooks/create-links

这将链接用于处理工具版本的钩子。

使用的库

• https://github.com/fsnotify/fsnotify%EF%BC%9A%E7%9B%91%E6%8E%A7%E6%96%87%E4%BB%B6%E7%B3%BB%E7%BB%9F%E4%BA%8B%E4%BB%B6%EF%BC%9B
• https://github.com/tebeka/selenium%EF%BC%9A%E9%80%9A%E8%BF%87%E6%B5%8F%E8%A7%88%E5%99%A8%E8%AE%A4%E8%AF%81%E3%80%82

创建者

• https://github.com/muyouming
• https://github.com/alessiofaieta