API and command line program to save Google documents, presentations, and worksheets in a local Google Drive / Backup & Sync directory to local files.

gdoc-down supports several formats:

• CSV (.csv)
• EPUB (.epub)
• Excel workbook (.xlsx)
• HTML (.html)
• Image (.png, .jpg, .svg)
• LaTeX (.tex)
• Open Office document (.odt)
• Open Office presentation (.odp)
• Open Office workbook (.ods)
• Plain text file (.txt)
• Portable document format (.pdf)
• Powerpoint presentation (.pptx)
• Rich text document (.rtf)
• TSV (.tsv)
• Word document (.docx)

gdoc-down also has special features for handling .gdoc files that contain LaTeX:

• gdoc-down ignores all images. This allows the user to place images inside the Google document for convenience and to use \includegraphics to embed images in compile PDF files.
• gdoc-down will convert all Google document comments to PDF comments.
• gdoc-down ignores all page breaks.

The first time gdoc-down is called, gdoc-down will request access to the user's Google account. This will create a client.json file in the users home directory (~/.gdoc_down/client.json).

• Latest release from PyPI

  pip install gdoc_down
  

• Latest revision from GitHub

  pip install git+https://github.com/KarrLab/gdoc_down.git#egg=gdoc_down
  

usage: gdoc-down (sub-commands ...) [options ...] {arguments ...}

Download a Google document, presentation, or workbook to a local file

positional arguments:
  google_file           path to Google document, presentation, or workbook

optional arguments:
  -h, --help            show this help message and exit
  --debug               toggle debug output
  --quiet               suppress all output
  --format FORMAT, -f FORMAT
                        output format (csv, docx, epub, html, jpg, odft, odp,
                        ods, pdf, pptx, png, rtf, svg, tsv, tex, txt, xlsx)
  --out_path OUT_PATH, -o OUT_PATH
                        path where Google document, presentation, or workbook
                        should be downloaded
  --extension EXTENSION, -e EXTENSION
                        output extension

gdoc-down -f docx /path/to/Google \Drive/file.gdoc
gdoc-down -f pptx /path/to/Google \Drive/file.gslides
gdoc-down -f xlsx /path/to/Google \Drive/file.gsheet

Please see the documentation at Read the Docs.

pytest can be used to run the tests:

pytest tests

Please note that several additional packages are required for testing (see tests/requirements.txt).

The example model is released under the MIT license.

gdoc-down was developed by Jonathan Karr at the Icahn School of Medicine at Mount Sinai in New York, USA.

Please contact the Jonathan Karr with any questions or comments.