/upload-gphotos

Upload photo to Google Photos (Unofficial).

Primary LanguageTypeScriptMIT LicenseMIT

upload-gphotos

NPM

NPM VERSION GITHUB RELEASE LICENSE Greenkeeper badge

Google Photos にファイルをアップロード.

Upload photos to Google Photos (Unofficial).

Preparation

USE AT YOUR OWN RISK

  1. Turn on "Allowing less secure apps to access your account"
  2. (Optional) Login Google via browser if you haven't login from current IP address.

Installation

npm (Recommended)

$ npm install -g upload-gphotos

Executable file

Download your platform's binary via GitHub Releases.

Usage

$ upload-gphotos [<file>...] [--quiet] [-r <retry>] [-u <username>] [-p <password>] [-a <albumname>]

Library

This is also Node.js library.

(async () => {
  const gphotos = new GPhotos({ username: '', password: '' });
  await gphotos.login();

  const photo = await gphotos.upload(filePath);
  const album = await gphotos.searchOrCreateAlbum('TestAlbum');
  await album.addPhoto(photo);
})();

See Documentation.

FAQ

  • Q. Is it support to login with SMS / 2FA / Application password?
    • A. No. I have no plan to support. See issues#196.
  • Q. I can't login, Why?
    • A. Please try to login via browser, first.
    • Google will ban to login from unknown IP.
  • Q. When uploading large / many files, Uploading was failed.
    • A. It maybe limitations of Google Photos.
    • Limitations is below. (FYI: issues#246, issues#256(comments))
      • 75 MB or 100 megapixels / 1 photo
      • 10 GB / 1 video
      • Total bandwidth maybe 10 GB / 1 day