Comments:"NoPriv.py - Easy IMAP email backup to HTML archive"
URL:https://raymii.org/s/software/Nopriv.py.html/
NoPriv.py - Easy IMAP email backup to HTML archive.
Author: Remy Van Elst Date: 19-01-2013NoPriv.py is a python script to backup any IMAP capable email account to a HTML archive, nicely browsable, instead of weird folders (Maildir), one huge file (mbox), only needing a web browser to view (thunderbird) and no propritary code, so you can make sure I won't steal your password.
Demo
Screenshots
Running the program
Index page
Folder Overview page
Email itself
Attachments
Command Line Client (links2):
Features
- Works with any IMAP/IMAPS account
- Supports multiple IMAP folders
- Supports HTML email
- Supports TEXT email
- Supports MULTIPART email
- Saves attachments
- Supports incremental backups
- Backups to HTML files for easy browsing
- Small HTML files can be backed up to external medium more easily, and can be sent over the internet more easily.
- Also backs up to Maildir for easy restoring
Changelog
New in version 3:
- Supports incremental backups
- If you stop the backup while running, it will now continue were it left off
- Unread mails stay unread, but are backed up (before they were marked as read)
- Restoring possible because it also creates a Maildir
- Better unicode support
- Attachment page is now also styled
New in version 2:
- Support for multiple IMAP folders
- Index page is generated
- Pages have menu now.
- On running it shows all available IMAP folders.
Usage
Clone the repository: git clone git://github.com/RaymiiOrg/NoPriv.git Set up your login details, imap server and ssl:Open nopriv.py in a text editor and edit the following variables (example filled in for gmail):
IMAPSERVER = "imap.gmail.com"
IMAPLOGIN = "janeway@gmail.com"
IMAPPASSWORD = "Voyager1"
IMAPFOLDER = ["[Gmail]/Sent Mail", "INBOX", "[Gmail]/Starred", "Captains_Log", "Important"]
ssl = True
incremental_backup = True(Mind the capital on ssl/incremental_backup, True/False, not true/false).
If you use gmail and want to backup all your email, use the "[Gmail]/All Mail" folder. It might be named different if you use another locale, for me with a Dutch gmail account it is named "[Gmail]/Alle Berichten".
If you only want to backup one folder, use something like this: IMAPFOLDER = ["Folder"].
Open the file index.html in your browser. There are all your folders and emails.
If you only have a console, it works just fine in Links2 (see above screenshot):
links2 ./index.htmlRequirements
Python 2.7
Running debian 6 which has python 2.6.6? See here how to install python 2.7 on debian 6.
Known issues
- Does not work with python3 (Feel free to port/fix it.)
- Does not handle all charsets. Works best with utf-8 and ascii.
- No search function.
- Not able to change default sorting (latest first).
Info on incremental backups
If you disable incremental backups, the script will run over the folders, create a maildir, create the pages and then move the maildir to $maildir.date where date is a timestamp.
If you enable incremental backup, it will create a text file nopriv.txt with the mail ID's of the folder, so that it know which ID it needs to continue on the next time it is ran. If you delete emails from the folder, the incremental function will not work as expected because of differing ID's.
Info on restoring
Nopriv creates a Maildir folder, which houses all your email. You can restore this maildir folder to an IMAP account either by using the script linked at the top on this page, or use a mail client like Mutt or Evolution and transport it to an imap account via there.
More Info:
https://raymii.org/s/software/Nopriv.py.html
https://github.com/RaymiiOrg/NoPriv