Command line tool to mass upload media folders to your google photos account(s) (Mac OS / Linux)
Command line tool to mass upload media folders to your Google Photos account(s).
While the official tool only supports Mac OS and Windows, this brings an uploader to Linux too. Lets you upload photos from, in theory, any OS for which you can compile a Go program.
Google Photos imposes a rate limit on all API clients. The quota limit for requests to the Library API is 10,000 requests per project per day. The quota limit for requests to access media bytes (by loading a photo or video from a base URL) is 75,000 requests per project per day.
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.
You can install the pre-compiled binary (in several different ways) or compile from source.
Here are the steps for each of them:
homebrew tap (only on macOS for now):
$ brew install gphotosuploader/tap/gphotos-uploader-cli
Download the pre-compiled binaries from the releases page and copy to the desired location.
This project will maintain compatibility with the last two Go major versions published. It could work with other versions but we can't support it.
You can compile the source code in your system.
$ git clone https://github.com/gphotosuploader/gphotos-uploader-cli $ cd gphotos-uploader-cli $ make build
Or you can use
go getif you prefer it:
$ go get github.com/gphotosuploader/gphotos-uploader-cli
First initialize the config file using this command:
$ gphotos-uploader-cli init
Default configuration folder is~/.gphotos-uploader-clibut you can specify your own folder using--config /my/config/dir. Configuration is kept in theconfig.hjsonfile inside this folder.
You must review the documentation to specify your Google Photos API credentials,
APIAppCredentials. You should tune your
Once it's configured you can start uploading files in this way:
$ gphotos-uploader-cli push
The first time you run
gphotos-uploader-cli, after setting your configuration (Google Photos API credentials), few manual steps are needed:
Visit the following URL in your browser: https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=...
After completing the authorization flow, enter the authorization code here:
gphotos-uploader-clito access to your Google Photos account, click on Go to gphotos-uploader:
After completing the authorization flow, enter the authorization code here: 4/4QFPtCv11dN3a-hVYhHkMryZe5g
All auth configuration is in place.
Help us make
gphotos-uploader-clithe best tool for uploading your local pictures to Google Photos.
If you find a bug while working with
gphotos-uploader-cli, please open an issue on GitHub and let us know what went wrong. We will try to fix it as quickly as we can.
You are more than welcome to open issues in this project to:
This project is mainly written in Golang. If you want to contribute code, see Contributing guide lines for more information.
Use of this source code is governed by an MIT-style license that can be found in the LICENSE MIT file.