Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

82 lines (62 sloc) 3.942 kB


Welcome to mu!

Given the enormous amounts of e-mail many people gather, and the importance of e-mail message in our work-flows, it’s essential to quickly deal with all that mail - in particular, to instantly find that one important e-mail you need right now.

mu is a tool for dealing with e-mail messages stored in the Maildir-format. mu’s main purpose is to help you to quickly find the messages you need; in addition, it allows you to view messages, extract attachments, create new maildirs, … See the mu cheatsheet for some examples.

Searching works by first indexing your messages into a Xapian-database, which can then be queried using a custom query language.


  • 2010-04-12 mu 0.9.4: adds the cfind command, to find contacts (name + e-mail), add flag:unread which is a synonym for flag:new OR NOT flag:seen. Updates to the documentation and some internal updates. This is a bèta-version.
  • 2011-02-13: mu 0.9.3; fixes a bunch of minor issues in 0.9.2; updated the web page with pages for mug (the experimental UI) and the mu cheatsheet.
  • 2011-02-02: mu 0.9.2 released, which adds support for matching on message size, and various new output format. See NEWS for all the user-visible changes, also from older releases.
  • Old news


  • fast indexing for Maildir, Maildir+ and Maildir-on-VFAT
  • search for messages based on the sender, receiver, message subject, size, priority, words in the message body, attachments, date range, flags (signed, encrypted, new, replied, …), message-id, maildir
  • known to work on Linux (Ubuntu/Fedora/Debian/GenToo), FreeBSD, MacOS, Solaris, …
  • fully documented (man pages)
  • can be integrated with e-mail clients; documentation has examples for mutt and Wanderlust.
  • output in plain text, xml, json, s-expressions (experimental)
  • extract message parts, attachments, open them using their default application

In addition, there is a toy UI for mu called mug; the plan is to slowly evolve this into a full-featured UI.

Development & download

Some Linux-distributions already provide pre-built mu packages; if there’s no packagage for your distribution, or if you want the latest release, you can download mu source packages from Google Code. In case you find a bug, or have a feature requests, please use the issue tracker.

If you’d like to work with the mu source code, you can find it in Gitorious; also, see the notes on HACKING the mu source code.

There’s also a mailing list.

License & Copyright

mu was designed and implemented by Dirk-Jan C. Binnema, and is Free Software, licensed under the GNU GPLv3

© 2011 Dirk-Jan C. Binnema
Jump to Line
Something went wrong with that request. Please try again.