Skip to content
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time

gpup CircleCI

A command to upload photos and movies to your Google Photos Library.

Getting Started


You can install this from brew tap or releases.

brew tap int128/gpup
brew install gpup

Setup your API access by the following steps:

  1. Open
  2. Enable Photos Library API.
  3. Open
  4. Create an OAuth client ID where the application type is other.
  5. Run gpup and 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
1. Enable Photos Library API.
1. Open
1. Create an OAuth client ID where the application type is other.

Enter your OAuth client ID (e.g.
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.


Upload 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/



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.


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.


Feel free to open issues or pull requests.


A command to upload photos and movies to Google Photos Library using the official Google Photos Library API





No packages published

Contributors 4

You can’t perform that action at this time.