fastcat / gmail-sync-labels

script to download labels from gmail and apply them on offline copy of your messages (as additional header), and companion script to copy them to from one GMail account to another

How this is supposed to work

This script should download message labels from gmail and apply them on local copy of that messages (made with getmail or other software) as header in messages.

Idea is really simple:

1. prepare index "Message-ID header" => "message file"
2. save index in $MAILDIR/gmail-sync-labels.index
3. Download (message-id, labels) pairs from gmail
4. Apply labels on message with message-id

How to use this

before: make backup of your Maildir. It works for me, but it may destroy mails for you. It was tested with python 3.3, it may or may not work with older releases. Feel free to post patches / pull requests / issues about older versions.

cp config.py.template config_named.py
edit config_named.py
python3 gmail-sync-labels.py config_named

How to use the label restorer

The restorer currently works by copying from one gmail account to another, keying by message ID. Note that this tool is not well tested.

cp config.py.template config_old.py
cp config.py.template config_new.py
edit config_old.py config_new.py
python3 gmail-restore-labels.py config_old config_new

Similar Projects

1. gmail-notmuch
   This project used to have NotMuch support, but it was removed for lack of maintenance.

See Also

• https://github.com/hiciu/gmail-sync-labels
• https://github.com/fastcat/gmail-sync-labels

gmail-sync-labels's Issues

Rename restorer to copier, add a real restorer

The "restorer" script is really a copier -- it copies labels from one account to another, instead of restoring labels from the backup. It should be renamed, and a real label restorer should be written.

Merge common code between label downloader and label restorer

There's a bunch of copy-pasted code between the two main scripts that should be unified into a proper module.

Flag excess and duplicate messages during sync

When downloading labels in the sync script, it should at least have an option to warn about any messages in the maildir that are not in the gmail account. For some cases it might be good to have an option to move them to a different (trash-esque) maildir.