A python tool for syncing files between google drive and local file-system (both ways).

NOTE: This is the development branch. No commits have been made to the main/master branch yet.

You will need three credentials: client_id, client_secret, and refresh_token, to use this tool. To get these, you need to:

1. Create a poject in google cloud console.
2. Confiugure the consent screen.
3. Obtain the client_id and client_secret.
4. Authorize to google drive via OAuth 2.0 Playground and get a refresh_token.

Now, export these secrets as CLIENT_ID, CLIENT_SECRET, and REFRESH_TOKEN environment variables.

git clone https://github.com/px86/gsync
cd gsync
pipenv install
pipenv run python gsync.py --help

gsync syncs file based on source and destination folders. For example, the below command will initialize a local copy of your google drive, into the local-drive/ folder. Here the source is gd:/ and local-drive/ is the destination. -r means recursively.

gsync gd:/  local-drive/ -r

Note that all google drive paths start with gd: prefix. gd:/ refers to the My Drive folder in your google drive, gd:/Documents/ will refer to My Drive/Documents/ and so on.

You can switch the source and destination to sync in the reverse direction.

It is also possible to sync a given subdirectory only. For example, the below command will make sure that all files in the local-drive/Documents/Work/ folder are present and up-to-date in the drive in My Drive/Documents/ folder.

gsync  local-drive/Documents/Work/  gd:/Documents/

usage: gsync.py [-h] [-r] [-c] [--dry-run] [--max-size SIZE] sourcedir destinationdir

positional arguments:
  sourcedir
  destinationdir

options:
  -h, --help       show this help message and exit
  -r, --recursive  sync source recursively
  -c, --checksum   use checksum instead of modified time and size to compare files
  --dry-run        only print the updates, do not do anything
  --max-size SIZE  skip files which are greater than SIZE bytes