Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

No project description provided

Project description


(Or, Wayne's Email)

I really love command line tools. Alpine has been a favorite of mine and Mutt is also a rather useful mail client. But I wanted to do some things differently, so I'm working on this project, WEmail.

It's designed for use with my other project Orouboros, a mailserver that cheerfully violates all kinds of standards for MTAs.

To get started, you'll want to create a ~/.wemailrc file. It's a JSON file, because aside from the pesky inability to have trailing commas, it's pretty good otherwise. Here's a sample one to get you started:

    "MAILDIR": "~/mymail/",
    "DEFAULT_FROM": "",
    "": {
        "HEADERS": {
            "From": "",
            "To": "",
            "X-CommonMark": "True",
            "Subject": ""
        "SMTP_HOST": "",
        "SMTP_PORT": 1234,
        "SMTP_USE_TLS": true,
        "SMTP_USERNAME": "person",
        "SMTP_PASSWORD": "this is not a real password",

Oh yeah, you can add "":"" at the end of your blocks, because I don't care about them, and that lets you put commas at the end of everything else.

Anyway, after that you just python3 -m pip install --user wemail and then run wemail.

Now you can run check to check your email, and proc to process your email. While not everything has a help, hopefully there should be enough to get you going. And if you get stuck, feel free to send me an email - you can find my address in Oooh, maybe I should add a command that lets you send me an email for help!

The changelog format is based on Keep a Changelog.


[0.1.11] - 2019-06-06


  • compose now has an address book autocomplete function, using ADDRESS_BOOK in the config file.


  • For messages without any kind of body, now show a list of message parts, if any.


  • Added spacer line between header and body.

[0.1.10] - 2019-06-05


  • Email forwarding.
  • r shortcut for reply.
  • Ability to save and resume drafts, queue messages for later sending, and edit files generally.
  • README for pypi and GitHub.


  • On failure to send, display failure message instead of crash.
  • Properly display recipient headers when doing proc.


  • Default to mistletoe for the CommonMark renderer, because tables are cooler. But fallback to commonmark, if available.
  • Show message body (up to 20 lines) when doing proc.



  • Fix ~-prefixed maildir paths.



  • Ability to do a quick command, e.g. proc reply to quickly reply to the first message.
  • Added On <date> at <time>, <sender> wrote: to reply text.



  • Removed testing To: email and CC: field.



  • Config file! ~/.wemailrc, a JSON file
  • Composing emails! works with c or `compose'
  • Replying to emails! When processing emails now it's possible to reply using reply.



  • Setting WEMAIL_CHECK_FOR_UPDATES env var now allows automagic upgrades.
  • version command now displays WEmail version.



  • body shortcut, to print the message body.



  • p1 shortcut to view the first part of a message, probably text/plain.
  • D shortcut added to delete a message without confirmation.
  • '-v'/ '--version' command to check version.



  • Ability to change directories.
  • headers command (alias h) to (re-)dislpay message headers.

[0.1.1] - 2019.05.14


  • Fixed date header fallback.
  • Fixed subject encoding fallback.

[0.1.0] - 2019.05.12

Minimally useful product released.


  • Ability to process a maildir-style folder.
  • Ability to view parts of messages.
  • Ability to save messages in new directories.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for wemail, version 0.1.11
Filename, size File type Python version Upload date Hashes
Filename, size wemail-0.1.11-py3-none-any.whl (11.1 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page