Skip to main content

CLI client for Google Drive

Project description


Drive Cli

PyPI version Python version contributions welcome License: MIT HitCount

Get the ability to access Google Drive without leaving your terminal.


  • Google Drive has become a vital part of our day to day life. As much as non-programmers use it, so do programmers in several situations, where we need not use git/github.

  • Drive-CLI is a command-line utility for google drive which helps you access, sync, download, upload, etc. directly to your drive without leaving the command-line. The best part being the commands are similar to git CLI so that you can easily remember them :massage:


  • view-files: list your files; filter them by name, type.
  • clone: download file/folder from drive using sharing link or file ID and get it linked.
  • add_remote: upload existing local file to drive and get it linked.
  • cat: view files contents of text format without actually downloading them.
  • rm: remove particular file or folder.
  • ls: list all the files present in the drive of equivalent current directory.
  • status: list changes made to local files since last pull or pull.
  • pull: get latest changes from drive to local files.
  • push: push the local changes to drive.



  • For Usage
    #install using pip 
    $ pip install drive-cli
  • For Development
    • clone the repo
        $ git clone
    • get your client_secret.json from Oauth. Make sure to enable Drive Api for the project.
    • rename the client secret to oauth.json and place it in the drive_cli directory.
    • install the package:
        # move into package directory
        $ cd drive-cli
        # install package in edit mode
        $ pip install -e . #note the dot



The help for any command in particular, or for the entire list of commands, can be displayed using the help command.

$ drive --help

Usage: drive [OPTIONS] COMMAND [ARGS]...

  --help  Show this message and exit.

  add_remote  upload any existing file or folder to drive.
  clone       download any file using a sharing link or file ID. It will be
              automatically tracked henceforth.
  login       login to your google account and authenticate the service.
  logout      logout from the account logged in with.
  ls          list all the files present in this directory in the drive
              for tracked directories.
  pull        get latest updates from online drive of the file.
  push        push modification from local files to the drive.
  rm          delete a particular file in drive.
  status      list changes committed since last sync.
  view-files  filter search files and file ID for files user has access to.

Add Remote

Existing files or folders that have not been added to drive can be added and get tracked. In case you need to add a particular file, use the file parameter. The file folder can also be added inside particular parent folder in the drive using the file id of the folder.

# adding entire folder named test to drive
$ cd test
$ drive add_remote
Created a tracked directory
uploading .DS_Store
uploading main.js
uploading test.html
uploading style.css

# adding a particular file ( in current directory
$ drive add_remote --file

#adding the file or folder inside particular parent file(test) using its file id
$ drive add_remote --file --pid 1RJOWpW5MuP9RXpgZbp9OdauhaBtJd49g
content added under directory test


Download a file or folder present in drive using its file id or its sharing link. In case it is a folder it gets tracked.

# using file id note: since it is google doc it will be asked for a choice to select from
$ drive clone 1syTNkfXoc3pzpJSL0Z5LDioTFc46_LjzHjDDUvk90ks
Choose type to export to
 (ENTER to select, s to stop):

 => pdf
Preparing: watson script for download
downloading file  [####################################]  100%
completed download of watson script

# using file sharing link
$ drive clone
Choose type to export to
 (ENTER to select, s to stop):

 => pdf
Preparing: watson script for download
downloading file  [####################################]  100%
completed download of watson script


    $ pip uninstall drive-cli


  • We're are open to enhancements & bug-fixes :smile:.
  • Feel free to add issues and submit patches


Chirag Shetty - nurdtechie98

See also the list of contributors who participated in this project.


This project is licensed under the MIT - see the LICENSE file for details.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release. See tutorial on generating distribution archives.

Built Distribution

drive_cli-1.1.1-py3-none-any.whl (16.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page