MCPcopy
hub / github.com/OfflineIMAP/offlineimap

github.com/OfflineIMAP/offlineimap @v7.3.4 sqlite

repository ↗ · DeepWiki ↗ · release v7.3.4 ↗
1,047 symbols 3,725 edges 62 files 468 documented · 45%
README

Financial contributors: Financial Contributors on Open Collective

Links: * Official github code repository: offlineimap * Website: website * Wiki: wiki * Blog: blog

OfflineIMAP

"Get the emails where you need them."

The offlineimap project is about python2 oonly. The support for offlineimap3 is happening in Official offlineimap for python3.

I'll still lazily maintain 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

Core symbols most depended-on inside this repo

join
called by 141
offlineimap/imapserver.py
format
called by 83
offlineimap/ui/TTY.py
append
called by 81
offlineimap/bundled_imaplib2.py
_log
called by 78
offlineimap/bundled_imaplib2.py
debug
called by 77
offlineimap/ui/UIBase.py
warn
called by 57
offlineimap/ui/UIBase.py
getconf
called by 50
offlineimap/CustomConfig.py
info
called by 45
offlineimap/ui/UIBase.py

Shape

Method 890
Class 84
Function 73

Languages

Python100%

Modules by API surface

offlineimap/bundled_imaplib2.py125 symbols
offlineimap/folder/Base.py74 symbols
offlineimap/ui/Curses.py67 symbols
offlineimap/ui/UIBase.py58 symbols
contrib/helpers.py54 symbols
offlineimap/repository/IMAP.py52 symbols
contrib/release.py42 symbols
offlineimap/folder/LocalStatusSQLite.py37 symbols
offlineimap/folder/IMAP.py37 symbols
offlineimap/ui/Machine.py34 symbols
offlineimap/imapserver.py31 symbols
offlineimap/imaputil.py30 symbols

For agents

$ claude mcp add offlineimap \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact