mu/www/index.org

#+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!

  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 [[http://en.wikipedia.org/wiki/Maildir][Maildir]]-format,
  on Unix-like systems. *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 [[file:cheatsheet.org][mu cheatsheet]] for some examples.

  Searching works by first indexing your messages into a [[http://xapian.org/][Xapian]]-database, which
  can then be queried using a custom query language.

** Features

   - fast indexing for 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, extracting
     attachments, exporting address lists, creating maildirs, ...
   - accent/case normalization - so /angstrom/ will match /Å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=
   - [[file:mu-guile.html][mu-guile]]: guile-bindings that allow for scripting, advanced processing of
     your data
   - fully documented (man pages, info pages)

** News

   - 2012-01-07: [[http://code.google.com/p/mu0/downloads/detail?name%3Dmu-0.9.8-alpha3.tar.gz][mu-0.9.8-alpha-3]] is available, with fixes for some =mu4e=
     configuration problems; also, the documentation now contains an example of
     how to set up =mu4e= with Gmail.
   - 2012-01-06: [[http://code.google.com/p/mu0/downloads/detail?name%3Dmu-0.9.8-alpha2.tar.gz&can%3D2&q%3D#makechanges][mu-0.9.8-alpha-2]] is available; updates for =mu4e=, much
     improved guile bindings + documentation. The work-in-progress documentation
     is available here: [[http://www.djcbsoftware.nl/code/mu/mu4e/][mu4e]] and [[http://www.djcbsoftware.nl/code/mu/mu-guile/][mu-guile]].
   - 2011-12-30 [[http://code.google.com/p/mu0/downloads/list][mu-0.9.8-alpha]] is available; it comes with a an emacs-based
     email client (=mu4e=), updated guile bindings, 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.
   - 2011-07-31: mu *0.9.7-pre* is now available with a number of interesting
     new features and fixes, many based on user suggestions. =mu= now supports
 /mail threading/ based on the [[http://www.jwz.org/doc/threading.html][JWZ-algorithm]]; output is now automatically
     converted to the user-locale; =mu view= can output separators between
     messages for easier processing, support for X-Label-tags, and last but not
     least, =mu= now has bindings for the [[http://www.gnu.org/s/guile/][Guile]] (Scheme) programming language -
     there is a new toy (=toys/muile=) that allows you to inspect messages and
     do all kinds of statistics - see the [[https://gitorious.org/mu/mu/blobs/master/toys/muile/README][README]] for more information.

     Note, the repository name has changed, it's now at: https://gitorious.org/mu/mu.


   - 2011-06-02: after quite a bit of testing, *0.9.6* has been promoted to be
     the next release -- forget about the 'bèta'. Development continues for
     the next release.

   - 2011-05-28: *mu-0.9.6* (bèta). A lot of internal changes, but also quite
     some new features, for example:
     - wild-card searching for most fields: mu find 'car*'
     - search for message with certain attachments with 'attach:/a:': mu find
       'attach:resume*'
     - color for =mu find=, =mu cfind=, =mu extract= and =mu view=
     Everything is documented in the man-pages, and there are examples in the [[file:cheatsheet.org][mu
     cheatsheet]].

   - 2011-04-25: *mu-0.9.5* a small, but important, bugfix in maildir-detection,
     some small optimizations.

   - 2011-04-12: *mu 0.9.4* released - 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 [[file:mug.org][mug]] (the experimental UI) and the [[file:cheatsheet.org][mu cheatsheet]].

   - 2011-02-02: *mu 0.9.2* released, which adds support for matching on message
     size, and various new output format. See [[http://gitorious.org/mu/mu/blobs/master/NEWS][NEWS]] for all the user-visible
     changes, also from older releases.

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


** Development & download
   :PROPERTIES:
   :ID:       19324381-696d-4c7e-aff2-528174780fd5
   :END:

   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 [[http://gitorious.org/mu/mu][in Gitorious]];
   also, see the notes on [[http://gitorious.org/mu/mu/blobs/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