2015-03-10 04:01:22 +01:00
|
|
|
[offlineimap]: https://github.com/OfflineIMAP/offlineimap
|
|
|
|
[website]: http://offlineimap.github.io
|
|
|
|
[wiki]: http://github.com/OfflineIMAP/offlineimap/wiki
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
# OfflineImap
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
## Description
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
OfflineIMAP is a software to dispose your e-mail mailbox(es) as a local Maildir.
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
For example, this allows reading the mails while offline without the need for your mail reader (MUA) to support disconnected operations.
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
OfflineIMAP will synchronize both sides via *IMAP*.
|
2012-02-24 11:13:27 +01:00
|
|
|
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
## License
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
GNU General Public License v2.
|
2011-01-15 16:48:30 +01:00
|
|
|
|
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
## Why should I use OfflineIMAP?
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
* It is **fast**.
|
|
|
|
* It is **reliable**.
|
|
|
|
* It is **flexible**.
|
|
|
|
* It is **safe**.
|
2011-01-15 16:48:30 +01:00
|
|
|
|
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
## Downloads
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
You should first check if your distribution already package OfflineIMAP for you.
|
|
|
|
Downloads releases as [tarball or zipball](https://github.com/OfflineIMAP/offlineimap/tags).
|
2011-01-15 16:48:30 +01:00
|
|
|
|
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
## Feedbacks and contributions
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
**The user discussions, development, announces and all the exciting stuff take
|
|
|
|
place in the mailing list.** While not mandatory to send emails, you can
|
|
|
|
[subscribe
|
|
|
|
here](http://lists.alioth.debian.org/mailman/listinfo/offlineimap-project).
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
Bugs, issues and contributions can be requested to both the mailing list or the
|
|
|
|
[official Github project][offlineimap].
|
2011-01-15 16:48:30 +01:00
|
|
|
|
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
## The community
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
* OfflineIMAP's main site is the [project page at Github][offlineimap].
|
|
|
|
* There is the [OfflineIMAP community's website][website].
|
|
|
|
* And finally, [the wiki][wiki].
|
2011-01-15 16:48:30 +01:00
|
|
|
|
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
## Requirements
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
* Python v2.7
|
|
|
|
* Python SQlite (optional while recommended)
|
2011-01-15 16:48:30 +01:00
|
|
|
|
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
## Documentation
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
The documentation is included (in .rst format) in the `docs` directory.
|
|
|
|
Read it directly or generate nice html docs (python-sphinx needed) and/or
|
|
|
|
the man page (python-docutils needed) while being in the `docs` dir via:
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
'make doc' (user docs), 'make man' (man page only) or 'make' (both)
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
(`make html` will simply create html versions of all *.rst files in /docs)
|
2011-01-15 16:48:30 +01:00
|
|
|
|
2015-03-10 04:01:22 +01:00
|
|
|
The resulting user documentation will be in `docs/html`. The full user
|
|
|
|
docs are also at: http://docs.offlineimap.org. Please see there for
|
|
|
|
detailed information on how to install and configure OfflineImap.
|