#+title:
#+style:
#+html:
#+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* 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 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 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-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.
- 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
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:
#+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* 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 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 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-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.
- 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
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: