Read/sync your IMAP mailboxes (python2) [LEGACY: move to offlineimap3] https://www.offlineimap.org/

Nicolas Sebrecht 9887dcb645 Merge tag 'v7.0.14' into maint 7 years ago
.github ddbc1426d5 github template: add system/distribution 8 years ago
bin 85e8aea94f Convert to use OptionParser for command line handling. 13 years ago
contrib c58b035cd1 add documentation about SIGABRT 7 years ago
docs c58b035cd1 add documentation about SIGABRT 7 years ago
offlineimap c883160814 v7.0.14 7 years ago
scripts 23b497d191 scripts/get-repository.sh.rej: remove unused file 7 years ago
test 19c43308b9 Change filter with lambda to list comprehension 8 years ago
.gitignore 4119aeda7d Add tags to gitignore 8 years ago
CODE_OF_CONDUCT.md 3be01d2142 code of conduct: try to clarify what item 3 might mean 8 years ago
CONTRIBUTING.rst feef2b4af2 explain how to submit issues in more files 8 years ago
COPYING c5eb4c9432 COPYING: fix unexpected characters 9 years ago
Changelog.maint.md ecef22a16c v6.7.0.3 8 years ago
Changelog.md c883160814 v7.0.14 7 years ago
MAINTAINERS.rst 04cb32bf9e MAINTAINERS: add new tester 7 years ago
MANIFEST.in 543890e257 MANIFEST: exclude rfcs 8 years ago
Makefile ccb3bc3819 Really execute the recipe of the 'docs' target in top-most Makefile 8 years ago
README.md 4bf15e3ffb README: minor copy edits 8 years ago
TODO.rst 573d55827f update TODO.rst 8 years ago
offlineimap.conf dab5737265 learn repository retrycount configuration option 7 years ago
offlineimap.conf.minimal f5b82ad76d Improve nametrans user documentation 12 years ago
offlineimap.py 1894a8f871 allow to run under python3 without special env 8 years ago
requirements.txt 5e61faac9c move requirements.txt to the root directory 8 years ago
setup.cfg c549af78eb pypi requires a setup.cfg when README is Markdown 8 years ago
setup.py 4dcd676b23 Add offlineimap.utils to the list of our modules 11 years ago

README.md

OfflineIMAP

"Get the emails where you need them."

Official offlineimap.

Description

OfflineIMAP is software that downloads your email mailbox(es) as local Maildirs. OfflineIMAP will synchronize both sides via IMAP.

IMAP's main downside is that you have to trust your email provider to not lose your email. While certainly unlikely, it's not impossible. With OfflineIMAP, you can download your Mailboxes and make you own backups of your Maildir.

This allows reading your email offline without the need for your mail reader (MUA) to support IMAP operations. Need an attachment from a message without internet connection? No problem, the message is still there.

Project status and future

As one of the maintainer of OfflineIMAP, I'd like to put my efforts into imapfw. imapfw is software in development that I intend to replace OfflineIMAP with in the long term.

That's why I'm not going to continue OfflineIMAP development. I'll continue to maintain OfflineIMAP (fixing small bugs, reviewing patches and merging, and rolling out new releases), but that's all.

While I keep tracking issues for OfflineIMAP, you should not expect future support.

You won't be left at the side. OfflineIMAP's community is large enough so that you'll find people for most of your issues.

Get news from the blog.

                             Nicolas Sebrecht. ,-)

License

GNU General Public License v2.

Why should I use OfflineIMAP?

  • It is fast.
  • It is reliable.
  • It is flexible.
  • It is safe.

Downloads

You should first check if your distribution already packages OfflineIMAP for you. Downloads releases as tarball or zipball.

Feedbacks and contributions

The user discussions, development, announcements and all the exciting stuff take place on the mailing list. While not mandatory to send emails, you can subscribe here.

Bugs, issues and contributions can be requested to both the mailing list or the official Github project. Provide the following information:

  • system/distribution (with version)
  • offlineimap version (offlineimap -V)
  • Python version
  • server name or domain
  • CLI options
  • Configuration file (offlineimaprc)
  • pythonfile (if any)
  • Logs, error
  • Steps to reproduce the error

The community

Requirements & dependencies

  • Python v2.7+
  • Python v3.4+ (experimental: see known issues)
  • six (required)
  • imaplib2 >= 2.55 (optional)

Documentation

All current and updated documentation is on the community's website.

Read documentation locally

You might want to read the documentation locally. Get the sources of the website. For the other documentation, run the appropriate make target:

$ ./scripts/get-repository.sh website
$ cd docs
$ make html  # Requires rst2html
$ make man   # Requires a2x (http://asciidoc.org)
$ make api   # Requires sphinx