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

Chris Coleman ffbace51a2 Update BACKERS.md 1 year ago
.github c53664544e introduce FUNDING.yml for opencollective 4 years ago
bin 0f65469ce1 bin/offlineimap: fix shebang to env python2 6 years ago
contrib fdb9974ab7 contrib/release..py: the version information has moved to offlineimap.version 4 years ago
docs 3d918ff7fe make docs: ensure py2 when running sphinx 5 years ago
offlineimap 6e837c614d v7.3.4 3 years ago
scripts 23b497d191 scripts/get-repository.sh.rej: remove unused file 7 years ago
test fc52034ea8 Autmomated testing using Travis and CodeCov.io! 6 years ago
tests fc52034ea8 Autmomated testing using Travis and CodeCov.io! 6 years ago
.coveragerc fc52034ea8 Autmomated testing using Travis and CodeCov.io! 6 years ago
.gitignore cf3a6ecde2 gitignore: re-introduce *.css 6 years ago
.travis.yml 8406ba3bb4 travis: remove python3.6 5 years ago
BACKERS.md ffbace51a2 Update BACKERS.md 1 year 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 99a7f74805 Changelog: fix version 3 years ago
MAINTAINERS.rst 88197a7e90 Add self to maintainers. Update email address. 6 years ago
MANIFEST.in 543890e257 MANIFEST: exclude rfcs 8 years ago
Makefile 0b18cb5e73 ensure python2 in the release workflow 5 years ago
README.md e70d3992a0 README: rewording and typo fix 3 years ago
TODO.rst 573d55827f update TODO.rst 8 years ago
offlineimap.conf 698ec64319 offlineimap.conf: minor fixes 5 years ago
offlineimap.conf.minimal f5b82ad76d Improve nametrans user documentation 12 years ago
offlineimap.py 8a7946e338 Update FSF postal address. 5 years ago
requirements.txt c13e0135a7 Require the minimal dependencies in python package 4 years ago
setup.cfg c549af78eb pypi requires a setup.cfg when README is Markdown 8 years ago
setup.py fdb9974ab7 contrib/release..py: the version information has moved to offlineimap.version 4 years ago
snapcraft.yaml e8b31af4c2 Initial commit of snapcraft.yaml 6 years ago

README.md

Financial contributors: Financial Contributors on Open Collective

Links:

OfflineIMAP

"Get the emails where you need them."

IMPORTANT NOTE: This repository is for python2 only. The support for offlineimap3 is happening in Official offlineimap for python3.

I'll still lazily maintain this legacy offlineimap but users should definitely go with offlineimap3.

Description

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

Why should I use OfflineIMAP?

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

The offlineimap project was forked to offlineimap3 to support python3. Contributions are welcome to this project.

Contributors

Code Contributors

This project exists thanks to all the people who contribute. [Contribute].

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]

Individuals

Organizations

Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]

License

GNU General Public License v2.

Downloads

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

If you are running Linux Os, you can install offlineimap with:

  • openSUSE zypper in offlineimap
  • Arch Linux pacman -S offlineimap
  • fedora dnf install offlineimap

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.x
  • six (required)
  • rfc6555 (required)
  • imaplib2 >= 2.57 (optional)
  • gssapi (optional), for Kerberos authentication
  • portalocker (optional), if you need to run offlineimap in Cygwin for Windows

  • Python v3: See the offlineimap3 fork of offlineimap.

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