https://github.com/WeeJeWel/node-google-backup

Skip to content

Navigation Menu

Toggle navigation
 
Sign in

  * Product
      +  
        Actions
        Automate any workflow
      +  
        Packages
        Host and manage packages
      +  
        Security
        Find and fix vulnerabilities
      +  
        Codespaces
        Instant dev environments
      +  
        GitHub Copilot
        Write better code with AI
      +  
        Code review
        Manage code changes
      +  
        Issues
        Plan and track work
      +  
        Discussions
        Collaborate outside of code
    Explore
      + All features
      + Documentation
      + GitHub Skills
      + Blog
  * Solutions
    By size
      + Enterprise
      + Teams
      + Startups
    By industry
      + Healthcare
      + Financial services
      + Manufacturing
    By use case
      + CI/CD & Automation
      + DevOps
      + DevSecOps
  * Resources
    Topics
      + AI
      + DevOps
      + Security
      + Software Development
    Explore
      + Learning Pathways
      + White papers, Ebooks, Webinars
      + Customer Stories
      + Partners
  * Open Source
      +  
        GitHub Sponsors
        Fund open source developers
      +  
        The ReadME Project
        GitHub community articles
    Repositories
      + Topics
      + Trending
      + Collections
  * Enterprise
      +  
        Enterprise platform
        AI-powered developer platform
    Available add-ons
      +  
        Advanced Security
        Enterprise-grade security features
      +  
        GitHub Copilot
        Enterprise-grade AI features
      +  
        Premium Support
        Enterprise-grade 24/7 support
  * Pricing

Search or jump to...

Search code, repositories, users, issues, pull requests...

Search
[                    ]
Clear

Search syntax tips

Provide feedback

We read every piece of feedback, and take your input very seriously.

[                    ] [ ] Include my email address so I can be
contacted
Cancel Submit feedback

Saved searches

Use saved searches to filter your results more quickly

Name [                    ] 
Query [                    ]

To see all available qualifiers, see our documentation.

Cancel Create saved search
Sign in
Sign up Reseting focus
You signed in with another tab or window. Reload to refresh your
session. You signed out in another tab or window. Reload to refresh
your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert
{{ message }}
WeeJeWel / node-google-backup Public

  * Notifications You must be signed in to change notification
    settings
  * Fork 0
  * Star 63

A Command-Line Utility to automatically backup Google Mail, Calendar
& Contacts to local files.

63 stars 0 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

  * Code
  * Issues 0
  * Pull requests 0
  * Actions
  * Projects 0
  * Security
  * Insights

Additional navigation options

  * Code
  * Issues
  * Pull requests
  * Actions
  * Projects
  * Security
  * Insights

WeeJeWel/node-google-backup

This commit does not belong to any branch on this repository, and may
belong to a fork outside of the repository.
 main
BranchesTags
  
Go to file
Code

Folders and files

       Name                Name          Last commit     Last commit
                                           message          date
Latest commit

 

History

18 Commits
 
.github/workflows   .github/workflows                    
bin                 bin                                  
lib                 lib                                  
.gitignore          .gitignore                           
Dockerfile          Dockerfile                           
README.md           README.md                            
docker-compose.yml  docker-compose.yml                   
index.mjs           index.mjs                            
package-lock.json   package-lock.json                    
package.json        package.json                         
View all files

Repository files navigation

  * README

Google Backup

 

This module automatically downloads your Google Mail, Contacts &
Calendar to separate files. It'll sync only new Mails, Contacts &
Events.

This tool will output the following directory structue:

.
+-- contacts/
|   +-- *.vcf
+-- calendar/
|   +-- *.ical
+-- mail/
    +-- received/
    |   +-- *.eml
    +-- sent/
        +-- *.eml

Why?

 

Google makes great services, but there are many horror stories of
people locked out of their accounts. So be safe, and keep your data
backed up!

Usage

 

1. Create a Google App Password

 

Create a Google App Password at https://myaccount.google.com/
apppasswords.

2. Run

 

Node.js

 

If you have Node.js already installed, run:

$ npx -y google-backup \
  --username "john.doe@gmail.com" \
  --password "abcd efgh ijkl mnop" \
  --filepath "~/Backups/Google/"

    Hint: You can schedule this in a cronjob for automated backups.

Docker

 

If you prefer Docker, this is an example how to run:

$ docker run \
  --env GOOGLE_BACKUP_USERNAME="john.doe@gmail.com" \
  --env GOOGLE_BACKUP_PASSWORD="abcd efgh ijkl mnop" \
  --env GOOGLE_BACKUP_FILEPATH="/backups" \
  --volume="/home/john/backups:/backups/" \
  ghcr.io/weejewel/google-backup

About

A Command-Line Utility to automatically backup Google Mail, Calendar
& Contacts to local files.

Resources

Readme
Activity

Stars

63 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases 3

 
v1.1.0 Latest
Jul 31, 2024
+ 2 releases

Packages 0

 
 
 

Languages

  * JavaScript 98.4%
  * Dockerfile 1.6%

Footer

 (c) 2024 GitHub, Inc.

Footer navigation

  * Terms
  * Privacy
  * Security
  * Status
  * Docs
  * Contact
  * Manage cookies
  * Do not share my personal information

You can't perform that action at this time.