gpup 
A command to upload photos and movies to your Google Photos Library.
Getting Started
Setup
You can install this from brew tap or releases.
brew tap int128/gpup
brew install gpupSetup your API access by the following steps:
- Open https://console.cloud.google.com/apis/library/photoslibrary.googleapis.com/
- Enable Photos Library API.
- Open https://console.cloud.google.com/apis/credentials
- Create an OAuth client ID where the application type is other.
- Run
gpupand follow the instruction as follows.
% gpup
2018/09/13 15:38:13 Skip reading ~/.gpupconfig: Could not open ~/.gpupconfig: open /user/.gpupconfig: no such file or directory
2018/09/13 15:38:13 Setup your API access by the following steps:
1. Open https://console.cloud.google.com/apis/library/photoslibrary.googleapis.com/
1. Enable Photos Library API.
1. Open https://console.cloud.google.com/apis/credentials
1. Create an OAuth client ID where the application type is other.
Enter your OAuth client ID (e.g. xxx.apps.googleusercontent.com): YOUR_CLIENT_ID.apps.googleusercontent.com
Enter your OAuth client secret: YOUR_CLIENT_SECRET
2018/09/13 15:38:22 Saved credentials to ~/.gpupconfig
2018/09/13 15:38:22 Error: Nothing to upload
Upload files to the library
To upload files in a folder to your Google Photos library:
$ gpup my-photos/
2018/06/14 10:28:40 The following 2 files will be uploaded:
1: my-photos/travel.jpg
2: my-photos/lunch.jpg
2018/06/14 10:28:40 Open http://localhost:8000 for authorization
2018/06/14 10:28:43 GET /
2018/06/14 10:28:49 GET /?state=...&code=...
2018/06/14 10:28:49 Saved token to ~/.gpupconfig
2018/06/14 10:28:49 Queued 2 file(s)
2018/06/14 10:28:49 Uploading travel.jpg
2018/06/14 10:28:49 Uploading lunch.jpg
2018/06/14 10:28:52 Adding 2 file(s) to the library
It opens the browser and you can log in to the provider. And then it uploads files concurrently.
You can specify URLs as well.
gpup https://www.example.com/image.jpgUpload files to an album
You can upload files to the album by -a option.
If the album does not exist, it will be created.
gpup -a "My Album" my-photos/You can upload files to a new album by -n option.
gpup -n "My Album" my-photos/Usage
Usage:
gpup [OPTIONS] <FILE | DIRECTORY | URL>...
Application Options:
-a, --album=TITLE Add files to the album or a new album if it does not exist
-n, --new-album=TITLE Add files to a new album
--request-header=KEY:VALUE Add the header on fetching URLs
--request-auth=USER:PASS Add the basic auth header on fetching URLs
--gpupconfig= Path to the config file (default: ~/.gpupconfig) [$GPUPCONFIG]
--debug Enable request and response logging [$DEBUG]
Options read from gpupconfig:
--google-client-id= Google API client ID [$GOOGLE_CLIENT_ID]
--google-client-secret= Google API client secret [$GOOGLE_CLIENT_SECRET]
--google-token= Google API token [$GOOGLE_TOKEN]
Help Options:
-h, --help Show this help message
Known issues
See the Google Issue Tracker for the known issues.
Timestamp
If you upload an photo or movie without timestamp in the header, timestamp of the image will be current time. Google Photos Library API does not provide setting timestamp for now.
Photo storage and quality
By using gpup, files are uploaded in original quality, which consumes user's storage. It's the limitation of Photos Library API, as stated in the offical document.
All media items uploaded to Google Photos using the API are stored in full resolution at original quality. They count toward the user’s storage.
A workaround for this is to use recover storage feature of Google Photos, which lets you free up the storage space by converting all the files uploaded in original quality to high quality.
Contribution
Feel free to open issues or pull requests.