{"id":13468520,"url":"https://github.com/gaubert/gmvault","last_synced_at":"2025-05-15T01:04:18.427Z","repository":{"id":2057329,"uuid":"2995473","full_name":"gaubert/gmvault","owner":"gaubert","description":"gmail backup software","archived":false,"fork":false,"pushed_at":"2022-05-01T19:28:47.000Z","size":7197,"stargazers_count":3598,"open_issues_count":145,"forks_count":286,"subscribers_count":79,"default_branch":"master","last_synced_at":"2025-04-06T17:09:29.211Z","etag":null,"topics":["backup","gmail","gmvault","oauth2","python","restore","sync"],"latest_commit_sha":null,"homepage":"http://www.gmvault.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gaubert.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-12-16T15:24:27.000Z","updated_at":"2025-04-06T03:19:15.000Z","dependencies_parsed_at":"2022-08-29T02:41:00.178Z","dependency_job_id":null,"html_url":"https://github.com/gaubert/gmvault","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaubert%2Fgmvault","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaubert%2Fgmvault/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaubert%2Fgmvault/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaubert%2Fgmvault/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gaubert","download_url":"https://codeload.github.com/gaubert/gmvault/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248784788,"owners_count":21161179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backup","gmail","gmvault","oauth2","python","restore","sync"],"created_at":"2024-07-31T15:01:12.774Z","updated_at":"2025-04-13T21:28:39.287Z","avatar_url":"https://github.com/gaubert.png","language":"Python","readme":"# Gmvault: Backup and restore your gmail account\n\n\n\nGmvault is a tool for backing up your gmail account and never lose email correspondence.\nGmvault is open source and under GNU-AGPL-3.0.\n\nFor further info go [gmvault.org] (http://gmvault.org)\n\n# Contribute\n\n[![Bountysource](https://www.bountysource.com/badge/tracker?tracker_id=56851)](https://www.bountysource.com/trackers/56851-gaubert-gmvault?utm_source=56851\u0026utm_medium=shield\u0026utm_campaign=TRACKER_BADGE)\n\n- 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.\n- Fork the reporsitory on Github to start making your changes to the **master** branch (or branch off of it).\n- Write a test which shows that the bug was fixed or that the feature works as expected.\n- Send a pull request and bug the maintainer until it gets merged and published. :) Make sure to add yourself to AUTHOR.\n\n# Quick Start\n\n## Installation\n\nYou can download one of the \"binary\" distribution from (http://gmvault.org/download.html) for the platform of your choice.\nYou can also install the software from the source from (github.com/gaubert/gmvault).\n\n## Windows install\n\nOnce installed launch gmvault-shell.bat (there should be a shortcut on your desktop).\nThe shell sets the environment so you can seamlessly launch gmvault.\n\nGo to the gmvault 2 mins start to learn how to pilot gmvault.\n\n## Linux and Mac OS X install\n\nUntar the binary tarball distribution and go to the GMVAULT_HOME/bin dir to launch gmvault.\n\n## Install from the sources\n\npython setup.py install\n\n## Install from PyPi\n\n    pip install gmvault\n\nor\n\n    easy_install gmvault\n\n## gmvault 2 mins start \n\nGmvault is a user-frendly command-line tool. It tries to set all the necessary defaults to be self explanatory.\n\n### Authentication\n\nGmvault allow users to use a XOAuth token or your gmail login password. The XOAuth authentication is the recommended way to access your account. \nThis 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. \n\nThe following example uses XOAuth to access foo.bar@gmail.com\n$\u003egmvault sync foo.bar@gmail.com\n\nWith the --passwd option, you can use your gmail login and password for a quick test or if you cannot use XOAuth. \nYou 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.\n\n### Backup your emails\n\nFull sync:\n\n$\u003egmvault sync foo.bar@gmail.com\n\nIncremental sync:\n\n$\u003egmvault sync -t quick foo.bar@gmail.com\n\nEmails are backed up in $HOME/gmvault-db (or %HOME%/gmvault-db for Win) by default. Use -d DB_DIR, --db-dir DB_DIR to change the location of your local email repository\n\n### Restore your emails in a Gmail account\n\n$\u003egmvault restore newfoo.bar@gmail.com\n\nWill restore $HOME/gmvault-db (or %HOME%/gmvault-db for Win) in newfoo.bar@gmail.com\n\n$\u003egmvault restore newfoo.bar@gmail.com -d /backup/emails-db\n\nWill restore /backup/emails-db in newfoo.bar@gmail.com\n\nUse --resume or --restart to restart from the last fatal error and not reupload once more the already treated emails.\n\n$\u003egmvault restore newfoo.bar@gmail.com --restart\n\n\n\n\n\n\n","funding_links":[],"categories":["Python","\u003ca id=\"tag-productivity\" href=\"#tag-productivity\"\u003eProductivity\u003c/a\u003e"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgaubert%2Fgmvault","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgaubert%2Fgmvault","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgaubert%2Fgmvault/lists"}