GDataCopier provides a complete set command line utilities (the syntax of which largely resembles scp) that allow users to

• gls - list documents on the Google document system
• gcp - export and import documents on the Google document system
• gmkdir - make directories on the Google docs system
• grm - remove documents and folders on the Google docs system
• gmv - move documents in and out of folder on the Google docs system

Our target audience are system administrators (on Unix like platforms) who are looking to automate off site backups of their Google documents.

GDataCopier is currently considered stable and is an active project. Please report any issues to us by emailing the authors or posting it on the Google group or issue tracker.

Note: GDataCopier is not affiliated with Google in anyway.

Features

• scp like syntax to list and copy documents
• filter documents based on folders, file names
• supports hosted and gmail accounts
• syncs date stamps with server
• download updated files only (great for offsite backup implementations)
• warn on overwrite (can override with parameters)
• summary of operations
• update document content using gcp
• move, remove, or make directories and organise your documents
• choose export format using command line parameter (defaults to OpenDocument formats)

Who maintains GDataCopier?

Devraj Mukherjee develops and maintains GDataCopier with feedback from it's users. Devraj works as the principal consultant for Eternity Technologies, an Open Source solutions company located in regional New South Wales, Australia.

De Bortoli Wines one of Australia's largest family wine makers, sponsored the initial development of GDataCopier.

Sponsorships

If you found GDataCopier useful and are feeling extremely generous, you might consider donating a small amount to fund the future development of this project. If you willing to fund a specific feature, please write to us to discuss.

You can also buy official merchandise from our Cafepress shop. All prices are listed in Australian Dollars.

• De Bortoli Wines is one of the largest family owned wineries in Australia and is committed to Open Source and Open Standards. Amongst other projects they funded the initial development of GDataCopier. Read their Wikipedia article to learn more. The continue to fund the development of various features in GDataCopier
• Universiteitsbiliotheek Gent for sponsoring the development of the update document feature in gcp (released in 2.1)
• Unique Logo Design designed and contributed the GDataCopier Logo (available for free download as well), we highly recommend their graphic design services.
• Spanning Sync, Inc.
• Antuan Shakhin
• Andrew Pearce

Requirements for v2.x

You will need the following components to run GDataCopier v2.1. If you are using Enterprise Linux distributions and are stuck with Python 2.4 you will need to use GDataCopier 2.0.2 and GData Library 2.0.

• Python 2.5
• GData Python API 2.0.11+

Proxy support is provided via the Google GData Python API.

GData API currently has references to cryptology libraries that have been deprecated in Python 2.6. If you are using Python 2.6 you will receive warning messages.

If you use a Proxy in your environment, please consult the ProxySupport article as GData API requires a few extra environment variables.

v2.x Usage Examples

Here's a quick overview of how you would typically use GDataCopier utilities. The wiki has a detailed manual page for each utility.

gcp

Export all documents for username@gmail that have changed since the last sync, and overwrite them if they already exists on the local system

./gcp.py -o -u username@gmail.com:/sheets /tmp

Export all documents where title matches Over for username@gmail.com as PDF

./gcp.py -f pdf username@gmail.com:/docs/all/Over* /tmp/

Export all presentations for username@gmail.com to /tmp

./gcp.py username@gmail.com:/slides /tmp

Imports all accepted files from /home/devraj to username@gmail.com. All unsupported formats will be ignored. gcp doesn't support recursively reading directories.

./gcp.py /home/devraj/ username@gmail.com:/

Imports Manual.doc to the Documentation folder for username@gmail.com, ensure that the folder exists on the Google document system.

./gcp.py /home/devraj/Manual.doc username@gmail.com:/Documentation

gls

List all documents for username@gmail.com in the Documentation folder

./gls.py username@gmail.com:/docs/Documentation

List all documents for username@gmail.com where the title contains the string GTE

./gls.py username@gmail.com:/docs/Documentation/GTE*

List all objects in the folder Documentation for username@gmail.com

./gls.py username@gmail.com:/all/Documentation

gmkdir

Make a folder called Documentation on the Google docs system

./gmkdir.py username@gmail.com:/Documentation

grm

Remove all documents that match GTE in the title

./grm.py username@gmail.com:/docs/all/GTES*