#+title:
#+style: <link rel="stylesheet" type="text/css" href="mu.css">
#+html:<img src="mu.jpg" align="right" margin="10px"/>
#+options: skip t

* Welcome to mu!

  With the /enormous/ amounts of e-mail many people gather and the importance of
  e-mail messages in our daily work-flow, it is very important to be able to
  quickly deal with all that - in particular, to instantly find that one
  important e-mail you need right now.

  For that, *mu* was created.  *mu* is a tool for dealing with e-mail messages
  stored in the [[http://en.wikipedia.org/wiki/Maildir][Maildir]]-format, on Unix-like systems. *mu*'s main purpose is to
  help you to find the messages you need, quickly; in addition, it allows you to
  view messages, extract attachments, create new maildirs, ... See the [[file:cheatsheet.org][mu
  cheatsheet]] for some examples. Mu's source code is available [[https://github.com/djcb/mu][in github]], and
  there is the [[http://groups.google.com/group/mu-discuss][mu-discuss]] mailing list.

  *mu* now comes with an emacs-based e-mail client (=mu4e=), a simple GUI
  (=mug=) and bindings for the Guile/Scheme programming language.

** Features

   - fast indexing for [[http://en.wikipedia.org/wiki/Maildir][Maildir]], Maildir+ and Maildir-on-VFAT
   - search for messages based on the sender, receiver, subject, date-range,
     size, priority, words in message, flags (signed, encrypted, new, replied,
     has-attachment,...), message-id, maildir, tags, attachment (name,
     mime-type, text) and more
   - command-line tools for indexing, searching, viewing, adding/removing
     messages, extracting attachments, exporting/searching address lists,
     creating maildirs, ...
   - accent/case normalization - so /angstrom/  matches /Ångström/
   - can be integrated with other e-mail clients such as [[http://www.mutt.org/][mutt]] and [[http://www.emacswiki.org/emacs/WanderLust][Wanderlust]].
   - [[file:mu4e.html][mu4e]], an emacs-based e-mail client based on =mu= (see screenshot).
   - [[file:mu-guile.html][mu-guile]]: [[http://www.gnu.org/software/guile/][guile 2.0]] bindings that allow for scripting, advanced processing
     of your data, and doing all kinds of statistics
   - fully documented (man pages, info pages)


** News
   
   - 2012-07-01: released [[http://code.google.com/p/mu0/downloads/detail?name%3Dmu-0.9.8.5.tar.gz][mu-0.9.8.5]]; more fixes, improvements (see the link).
   - 2012-05-08: released [[http://code.google.com/p/mu0/downloads/detail?name%3Dmu-0.9.8.4.tar.gz][mu-0.9.8.4]] with even more improvements (the link has
     all the details) 
   - 2012-04-06: released [[http://code.google.com/p/mu0/downloads/detail?name%3Dmu-0.9.8.3.tar.gz][mu-0.9.8.3]], with many improvements, fixes. See the
     link for details. *NOTE*: existing =mu= and =mu4e= users are recommended to
     execute =mu index --rebuild= after installation.
   - 2012-03-11: released [[http://code.google.com/p/mu0/downloads/detail?name=mu-0.9.8.2.tar.gz][mu-0.9.8.2]], with a number of fixes and improvements,
     see the link for the details.
   - 2012-02-17: released [[http://code.google.com/p/mu0/downloads/detail?name%3Dmu-0.9.8.1.tar.gz][mu-0.9.8.1]], which has a number of improvements to the
     0.9.8 release: add mark as read/unread, colorize cited message parts,
     better handling of text-based message parts, documentation fixes,
     documentation updates and a few fixes here and there
   - 2012-02-09: moved the mu source code repository [[https://github.com/djcb/mu][to Github]].
   - 2012-01-31: finally, [[http://mu0.googlecode.com/files/mu-0.9.8.tar.gz][mu-0.9.8]] is available. It comes with an emacs-based
     e-mail client, [[file:mu4e.html][mu4e]], and much improved [[file:mu-guile.html][guile bindings]]. Furthermore, It adds
     search for attachment mime type and search inside any text part of a
     message, more tests, improvements in many parts of the code.
   - 2011-09-03: mu 0.9.7 is now available; compared to the -pre version there
     are a few small changes; the most important one is a fix specifically for
     running mu on MacOS.

   - [[file:old-news.org][Old news]]

** Development & download

#+html:<a href="mu4e-splitview.png" border="0"><img src="mu4e-splitview-small.png" align="right" margin="10px"/></a>

   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
   [[http://code.google.com/p/mu0/downloads/list][download mu source packages]] from Google Code. In case you find a bug, or have
   a feature requests, please use the [[http://code.google.com/p/mu0/issues/list][issue tracker]].

   If you'd like to work with the mu source code, you can find it [[https://github.com/djcb/mu][in Github]];
   also, see the notes on [[https://github.com/djcb/mu/blob/master/HACKING][HACKING]] the mu source code.

   There's also a [[http://groups.google.com/group/mu-discuss][mailing list]].

** License & Copyright

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

#+html:<hr/><div align="center">&copy; 2011-2012 Dirk-Jan C. Binnema</div>
#+begin_html
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
var pageTracker = _gat._getTracker("UA-578531-1");
pageTracker._trackPageview();
</script>
#+end_html
