Need help with gmvault?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

gaubert
3.4K Stars 259 Forks GNU Affero General Public License v3.0 1.1K Commits 130 Opened issues

Description

gmail backup software

Services available

!
?

Need anything else?

Contributors list

# 19,357
Python
HTML
restore
gmail
986 commits
# 140,509
Rust
OCaml
restore
gmail
13 commits
# 111,251
XML
s3
testing...
search-...
3 commits
# 224,579
HTML
CSS
sample-...
playfra...
3 commits
# 94,134
Go
hugo
Bootstr...
coredns
2 commits
# 116,283
C
golang
vuejs
chromiu...
2 commits
# 154,750
plainte...
plain-t...
python-...
cython
2 commits
# 79,458
france
doh
alfred
ruby-on...
2 commits
# 15,291
Python
Ansible
garbage...
C#
1 commit
# 68,536
Python
C
paypal
Django
1 commit
# 133,558
aws-clo...
C++
C
file-ma...
1 commit
# 190,775
ncurses
C++
restore
gmail
1 commit
# 105,898
Ruby
Rails
HTML
test-co...
1 commit
# 151,733
devops-...
HTML
PHP
restore
1 commit
# 110,969
C++
torrent...
sickbea...
plex
1 commit

Gmvault: Backup and restore your gmail account

Gmvault is a tool for backing up your gmail account and never lose email correspondence. Gmvault is open source and under GNU-AGPL-3.0.

For further info go gmvault.org

Contribute

Bountysource

  • Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug. There will be a Contributor Friendly tag for issues that should be ideal for people who are not very familiar with the codebase yet.
  • Fork the reporsitory on Github to start making your changes to the master branch (or branch off of it).
  • Write a test which shows that the bug was fixed or that the feature works as expected.
  • Send a pull request and bug the maintainer until it gets merged and published. :) Make sure to add yourself to AUTHOR.

Quick Start

Installation

You can download one of the "binary" distribution from (http://gmvault.org/download.html) for the platform of your choice. You can also install the software from the source from (github.com/gaubert/gmvault).

Windows install

Once installed launch gmvault-shell.bat (there should be a shortcut on your desktop). The shell sets the environment so you can seamlessly launch gmvault.

Go to the gmvault 2 mins start to learn how to pilot gmvault.

Linux and Mac OS X install

Untar the binary tarball distribution and go to the GMVAULT_HOME/bin dir to launch gmvault.

Install from the sources

python setup.py install

Install from PyPi

pip install gmvault

or

easy_install gmvault

gmvault 2 mins start

Gmvault is a user-frendly command-line tool. It tries to set all the necessary defaults to be self explanatory.

Authentication

Gmvault allow users to use a XOAuth token or your gmail login password. The XOAuth authentication is the recommended way to access your account. This method is activated by default. After the first authentication for a given account, the XOAuth token is stored in $HOME/.gmvault and will be used for subsequent authentications.

The following example uses XOAuth to access [email protected] $>gmvault sync [email protected]

With the --passwd option, you can use your gmail login and password for a quick test or if you cannot use XOAuth. You will then enter an interactive session to enter your password. By default your password is not saved, but you can use the option to do it. Your password will be stored encrypted but please avoid using this option if possible.

Backup your emails

Full sync:

$>gmvault sync [email protected]

Incremental sync:

$>gmvault sync -t quick [email protected]

Emails are backed up in $HOME/gmvault-db (or %HOME%/gmvault-db for Win) by default. Use -d DBDIR, --db-dir DBDIR to change the location of your local email repository

Restore your emails in a Gmail account

$>gmvault restore [email protected]

Will restore $HOME/gmvault-db (or %HOME%/gmvault-db for Win) in [email protected]

$>gmvault restore [email protected] -d /backup/emails-db

Will restore /backup/emails-db in [email protected]

Use --resume or --restart to restart from the last fatal error and not reupload once more the already treated emails.

$>gmvault restore [email protected] --restart

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.