Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
a maildir client and library
Python Emacs Lisp

This branch is 127 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


md - a maildir client and library

md is a foundation for handling mail directly with maildirs. It allows you to circumvent IMAP servers and clients and deal directly with the underlying storage.

md is designed to be a little like MH. A command line tool (which can also be a shell) provides stateless access to your mail.

Folders are fully supported.

Some examples:

$ export MAILDIR=~/Maildir
$ md ls
INBOX#1278373500.V801Ie8c29aM925471  2010-07-06 01:12:43  <> [] [GitHub] someone commented on a commit
INBOX#1278377415.V801Ie8c29bM873637  2010-07-06 02:18:04  <> [] [GitHub] somebody commented on a commit
INBOX#1278408713.V801Ie8c328M715195  2010-07-06 10:59:47  <> [] [GitHub] someoneelse commented on a commit

$ md text INBOX#1278408713.V801Ie8c328M715195
return-path: <>
received: from ( [])
	by (Postfix) with ESMTPS id 71DF442096

Cool, ok. I see it the same way. If you find a working solution it is
fine and one learns something by doing it. I didn't want you to change
your solution, you see mine is simple enough to do it in five
minutes. Well, have fun!

md is nowhere near complete yet, and not at all usable for most people as any kind of mail tool. If you are interested in the approach however, here it is, ready for you to hack on.

Building md

md requires my simple filesystem abstraction library. If you're hacking on md you may want to use veh for building the dependancies into a virtualenv. md provides the veh config file for making it work, just do:

veh refresh

to make sure you have the latest dependancies.

Something went wrong with that request. Please try again.