Skip to content

Latest commit

 

History

History
67 lines (45 loc) · 3.75 KB

USER_GUIDE.md

File metadata and controls

67 lines (45 loc) · 3.75 KB

Google Photos Upload - User Guide

Read about the Google Photos Upload project here.

Ready to give it a try? Please note that this is a hobby project and comes without any warranty, but seem to work just fine!

If you run into an issue then take a look at the log file found locally on your computer in log/google-photos-upload.log

Step by Step - Windows

  1. Download the latest release for Windows here.
  2. Run google-photos-upload.exe (or run in a terminal using commandline parameters). It will ask for permission on the first run.
  3. Follow the instructions in the application to upload images/videos.

Step by Step - Mac/Linux

dotnet runtime installation required.

  1. Install .NET
  2. Download the latest cross-platform release here.
  3. Open a terminal and run this command: dotnet google-photos-upload.dll (or run in a terminal using commandline parameters). It will ask for permission on the first run.
  4. Follow the instructions in the application to upload images/videos.

Things to note

  • Configuration options in the file google-photos-upload.dll.config:

    • <add key="IMG_UPLOAD_NO_EXIF" value="true"/>: Set this value to true to prevent image upload if EXIF data is missing.

  • The Google Photos Media title will be derived from the first available of these:

    1. EXIF ImageDescription
    2. Filename without file extension

  • Supported file types: mov, avi, jpg, jpeg, gif

  • Ignored file types (other file types will give a warning message): txt, thm

  • Media will be uploaded in uncompressed 'Original Quality'. The Google Photos API does not support uploading in 'High Quality'. To recover storage; Open Google Photos Settings website and Click 'Recover Storage' (will downgrade ALL your photos in Google Photos from Original down to High Quality).

Commandline Parameters

  • Windows: in a terminal execute "dotnet google-photos-upload.exe -h"
  • Mac/Linux: in a terminal execute "dotnet google-photos-upload.dll -h"

Available parameters:

Parameter Comment
-c=
-command=		 Select Upload Command:
-1 - Authentication only
0 - User is asked
1 - List current Google Photos Album
2 - Upload Single Folder into Google Photos as an Album
3 - Upload Multiple Folders from a main Folder into Google Photos as Albums
-d=
-directory=		 Directory path to be processed
-a=
-addifalbumexists=		 Add media to Google Photos album if the album already exists. Value should be 'y'
-h
-help		 Show parameter options and exit

Optional: Obtain a Google Photos API key

The Google Photos API key is required to allow upload. There is a key provided in the source code which has constraints, but sufficient for testing.

  1. Obtain a Google Photos API key (Client ID and Client Secret) by following the instructions on Getting started with Google Photos REST APIs

    • NOTE When selecting your application type in Step 4 of "Request an OAuth 2.0 client ID", please select "Other". There's also no need to carry out step 5 in that section.

  2. Replace YOUR_CLIENT_ID in the client_id.json file with the provided Client ID.

  3. Replace YOUR_CLIENT_SECRET in the client_id.json file wiht the provided Client Secret.

analytics