GDataCopier provides two 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
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.
Latest release: gdatacopier-2.0.2
Who made GDataCopier?
Devraj works as the principal consultant for Eternity Technologies, an Open Source solutions company located in regional New South Wales, Australia and developed GDataCopier.
The GDataCopier logo was designed and contributed by Unique Logo Design, we highly recommend their graphic design services.
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.
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.
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
- choose export format using command line parameter (defaults to OpenDocument formats)
Requirements for v2.0
You will need the following components to run GDataCopier v2.0 (to comply with Enterprise Linux distributions we have ported GDataCopier back to Python 2.4)
- Python 2.4
- GData Python API 2.0.4+
Proxy support is provided via the Google GData Python API.
Ubuntu Users: Please note that the Python GData API distributed via apt is not 2.0.2, you may need to download and install this manually from the Google project hosting site. Please donot lodge this as an issue, it is not a defect in GDataCopier.
If you use a Proxy in your environment, please consult the ProxySupport article as GData API requires a few extra environment variables.
v2.0 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
