Google Drive client with support for new Drive REST API and partial sync
Go to file
Vitaliy Filippov 02e0b31f2a DateTime serialization with nanosecs 2016-01-05 20:28:06 +03:00
cmake/Modules Fix finding libbfd on newer Debian 2015-12-09 01:41:04 +03:00
debian Update debian package version 2016-01-03 12:51:38 +03:00
grive Update manpage 2016-01-03 18:24:34 +03:00
icon thanks Chris Goodman for contributing the icons! 2012-04-26 17:26:04 +08:00
libgrive DateTime serialization with nanosecs 2016-01-05 20:28:06 +03:00
package/fedora16 Remove JSON-C json wrappers, use YAJL for everything 2015-05-16 00:37:02 +03:00
.gitignore Add autogenerated stuff to .gitignore 2013-11-24 14:22:49 +02:00
CMakeLists.txt Do not track last_sync at all, clear srv_time's with -f option 2016-01-03 02:01:02 +03:00
COPYING updated the readme file and added GPLv2 license 2012-05-02 23:43:39 +08:00 Note fixed revision support in readme 2016-01-05 20:27:52 +03:00

Grive2 0.5-dev

3 Jan 2016, Vitaliy Filippov

This is the fork of original "Grive" ( Google Drive client with the support for the new Drive REST API and partial sync.

Grive can be considered still beta or pre-beta quality. It simply downloads all the files in your Google Drive into the current directory. After you make some changes to the local files, run grive again and it will upload your changes back to your Google Drive. New files created locally or in Google Drive will be uploaded or downloaded respectively. Deleted files will also be "removed". Currently Grive will NOT destroy any of your files: it will only move the files to a directory named .trash or put them in the Google Drive trash. You can always recover them.

There are a few things that Grive does not do at the moment:

  • continously wait for changes in file system or in Google Drive to occur and upload. A sync is only performed when you run Grive, and it calculates checksums for all files every time.
  • symbolic links support.
  • support for Google documents.

These may be added in the future, possibly the next release.

You need the following libraries:

  • yajl 2.x
  • libcurl
  • libstdc++
  • libgcrypt
  • Boost (Boost filesystem, program_options, regex, unit_test_framework and system are required)
  • expat

There are also some optional dependencies:

  • CppUnit (for unit tests)
  • libbfd (for backtrace)
  • binutils (for libiberty, required for compilation in OpenSUSE, Ubuntu, Arch and etc)

On a Debian/Ubuntu/Linux Mint machine just run the following command to install all these packages:

sudo apt-get install git cmake build-essential libgcrypt11-dev libyajl-dev \
    libboost-all-dev libcurl4-openssl-dev libexpat1-dev libcppunit-dev binutils-dev


pkg install git cmake boost-libs yajl libgcrypt pkgconf cppunit libbfd

Grive uses cmake to build. Basic install sequence is

mkdir build
cd build
cmake ..
make -j4
sudo make install

For the detailed instructions, see

When Grive is run for the first time, you should use the "-a" argument to grant permission to Grive to access to your Google Drive. A URL should be printed. Go to the link. You will need to login to your Google account if you haven't done so. After granting the permission to Grive, the browser will show you an authenication code. Copy-and-paste that to the standard input of Grive.

If everything works fine, Grive will create .grive and .grive_state files in your current directory. It will also start downloading files from your Google Drive to your current directory.


Version History

Grive2 v0.5 (unreleased)

  • Much faster and more correct synchronisation using local modification time and checksum cache (similar to git index)
  • Automatic move/rename detection, -m option removed
  • force option works again
  • Instead of crashing on sync exceptions Grive will give a warning and attempt to sync failed files again during the next run.
  • Revision support works again. Grive 0.4.x always created new revisions for all files during sync, regardless of the absence of the --new-rev option.

Grive2 v0.4.2

  • Option to exclude files by perl regexp
  • Reimplemented HTTP response logging for debug purposes
  • Use multipart uploads (update metadata and contents at the same time) for improved perfomance & stability
  • Bug fixes
  • Simple option to move/rename files and directories, via grive -m oldpath newpath (by Dylan Wulf,

Known issues:

  • force option does not work as documented #51

Grive2 v0.4.1

  • Bug fixes

Grive2 v0.4.0

First fork release, by Vitaliy Filippov / vitalif at mail*ru

  • Support for the new Google Drive REST API (old "Document List" API is shut down by Google 20 April 2015)
  • REAL support for partial sync: syncs only one subdirectory with grive -s subdir
  • Major refactoring - a lot of dead code removed, JSON-C is not used anymore, API-specific code is split from non-API-specific
  • Some stability fixes from Visa Putkinen
  • Slightly reduce number of syscalls when reading local files.

Grive v0.3

Bug fix & minor feature release. Fixed bugs:

  • #93: missing reference count increment in one of the Json constructors
  • #82: retry for HTTP error 500 & 503
  • #77: Fixed a bug where grive crashed on the first run.

New features:

  • #87: support for revisions
  • #86: partial sync (contributed by justin at that's not partial sync, that's only support for specifying local path on command line