Go to the Download Page to download the binary package for the platform of your choice. You can then refer to your platform (Win/Linux or Mac OSX) installation instructions to perform the Gmvault installation.
For the Windows, MacOSX standard distributions and Linux binary packages, the target machine doesn't need to have pre-installed a compliant Python distribution as these packages embed a working Python distribution. Only the source distribution will need a pre-installed Python distribution. Gmvault has been heavily tested with Python 2.6.x and Python 2.7.x versions. Please use one of these versions to run Gmvault. Note that Gmvault might work with an older (v2.5) or newer (3.x) Python version but it has not been tested.
Double click on gmvault_setup.exe to launch it. You should see the follow screens when installing:
Note that Gmvault is installed with standard user privileges.
This means that you will not be able to install it in areas necessitating
Gmvault-shell can be launched via a Desktop shortcut. Alternatively, you can also find it in the Gmvault folder of the Windows start-up menu.
Double click on the Desktop shortcut to launch the Gmvault-shell that will set all variables in order to easily operate Gmvault.
Type gmvault -h to start using Gmvault.
Go to Gmail Setup to configure Gmail before starting to use Gmvault. Go to Quick Start to quickly understand how to use Gmvault. Go to In Depth to understand all the Gmvault capabilities.
Download and untar the Mac OSX binary tarball. Go to the GMVAULT_HOME/bin dir to launch Gmvault.
$ tar zxvf gmvault-v1.7-beta-macosx-intel.tar.gz $ cd gmvault-v1.7-beta/bin $./gmvault sync myuser@gmail.com
The current Mac OS X distribution has been tested with OSX 10.7 and 10.6. If you have older Intel MAC OSX version try to use this binary distribution. Please go to the Report a problem page to signal any issues. Another alternative is to download and install the source distribution or to install Gmvault from Pypi.
On Linux, it is recommended to install Gmvault using the source distribution or Pypi. There is an experimental 64bits binary tarball distribution. If you encounter a problem please report it here. Download and untar the binary tarball for Linux 64bits. Go to the GMVAULT_HOME/bin dir to launch Gmvault.
$ tar zxvf gmvault-v1.7-beta-linux-i686.tar.gz $ cd gmvault-v1.7-beta/bin $ ./gmvault sync myuser@gmail.com
It is also possible to install Gmvault using the standard Python package installation method from Pypi. This is working for all platforms.
You would need to have the setup tools or pip installed in your Python distribution.
I would also recommend using gmvault in a virtualenv isolated sandbox.
Below is described an installation under a virtualenv sandbox.
$ virtualenv --no-site-packages gmvault-1.7-beta New python executable in gmvault-1.7-beta/bin/python Installing setuptools............done. $ cd gmvault-1.7-beta/bin $./pip install gmvault Downloading/unpacking gmvault Downloading gmvault-1.7-beta.tar.gz (47Kb): 47Kb downloaded Running setup.py egg_info for package gmvault Downloading/unpacking Logbook==0.3 (from gmvault) Downloading Logbook-0.3.tar.gz (89Kb): 89Kb downloaded Running setup.py egg_info for package Logbook Downloading/unpacking IMAPClient==0.8.1 (from gmvault) Downloading IMAPClient-0.9.zip (107Kb): 107Kb downloaded Running setup.py egg_info for package IMAPClient Downloading http://pypi.python.org/packages/source/d/distribute/distribute-0.6.24.tar.gz Extracting in /tmp/tmp2kCczm Now working in /tmp/tmp2kCczm/distribute-0.6.24 Building a Distribute egg in /tmp/gmvault-1.0-beta/build/IMAPClient warning: no files found matching 'Makefile' under directory 'docs' warning: no files found matching 'indexsidebar.html' under directory 'docs' /tmp/gmvault-1.0-beta/build/IMAPClient/distribute-0.6.24-py2.7.egg no previously-included directories found matching 'doc/doctrees' Downloading/unpacking gdata==2.0.17 (from gmvault) Downloading gdata-2.0.17.tar.gz (2.4Mb): 2.4Mb downloaded Running setup.py egg_info for package gdata Installing collected packages: gdata, gmvault, IMAPClient, Logbook Running setup.py install for gdata Running setup.py install for gmvault changing mode of build/scripts-2.7/gmvault from 644 to 755 changing mode of /tmp/gmvault-1.7-beta/bin/gmvault to 755 Running setup.py install for IMAPClient no previously-included directories found matching 'doc/doctrees' Running setup.py install for Logbook building 'logbook._speedups' extension gcc -pthread -fno-strict-aliasing -g -O2 -DNDEBUG -g -fwrapv -O3 -Wall -Wstrict-prototypes -fPIC -I/homespace/gaubert/python2.7/include/python2.7 -c logbook/_speedups.c -o build/temp.linux-i686-2.7/logbook/_speedups.o gcc -pthread -shared build/temp.linux-i686-2.7/logbook/_speedups.o -o build/lib.linux-i686-2.7/logbook/_speedups.so Successfully installed gdata gmvault IMAPClient Logbook Cleaning up... $
Alternatively to pip, easy_install could also be used but we recommend using pip.
The Source distribution is a standard python distribution installation. It is very similar to the installation from Pypi and working on all platforms. It is also recommended to use Gmvault within a virtualenv (see here for info). Untar the downloaded source distribution and run:
$> cd gmvault-1.7-beta $> ~/virtualenv-test/bin/python setup.py install PATH = ./src/gmv/gmv_cmd.py 1.7-beta Gmvault version = 1.7-beta running install running bdist_egg running egg_info writing requirements to gmvault.egg-info/requires.txt writing gmvault.egg-info/PKG-INFO writing top-level names to gmvault.egg-info/top_level.txt writing dependency_links to gmvault.egg-info/dependency_links.txt reading manifest file 'gmvault.egg-info/SOURCES.txt' reading manifest template 'MANIFEST.in' writing manifest file 'gmvault.egg-info/SOURCES.txt' installing library code to build/bdist.macosx-10.7-intel/egg .... running build_scripts creating build/scripts-2.7 copying ./etc/scripts/gmvault -> build/scripts-2.7 ... Installing gmvault script to /Users/xxxx/virtualenv-test/bin Installed /Users/xxxx/virtualenv-test/lib/python2.7/site-packages/gmvault-1.7_beta-py2.7.egg Processing dependencies for gmvault==1.7-beta Searching for gdata==2.0.17 Reading http://pypi.python.org/simple/gdata/ Reading http://code.google.com/p/gdata-python-client/ Best match: gdata 2.0.17 Downloading http://gdata-python-client.googlecode.com/files/gdata-2.0.17.zip Processing gdata-2.0.17.zip Running gdata-2.0.17/setup.py -q bdist_egg --dist-dir /var/folders/w3/kzry2_2537bbjd9_pwyjsnlw0000gn/T/easy_install-Zg1PBK/gdata-2.0.17/egg-dist-tmp-_kskLT zip_safe flag not set; analyzing archive contents... Adding gdata 2.0.17 to easy-install.pth file ... Finished processing dependencies for gmvault==1.6-beta >$
Please report any problems using "Report a problem" page.
Once you have installed Gmvault (see Install), please go to Gmail Setup to configure Gmail to working optimally with Gmvault. You can alternatively go to Quick Start to start using Gmvault in 2 mins.