mirror of https://github.com/djcb/mu.git synced 2024-07-13 10:04:28 +02:00
Go to file
Dirk-Jan C. Binnema 8419c85f63
Merge pull request #2721 from Tristan02d/info-typos-fix
Mu4e info manual typos fix
2024-06-28 06:46:21 +03:00
.github github: update bug filing template 2024-04-20 11:44:22 +03:00
build-aux build: use best compression when installing info 2023-11-03 21:02:42 +00:00
contrib autotools: remove 2022-08-20 11:19:29 +03:00
guile guile: separate guile load/extensions path 2024-03-10 10:28:11 +02:00
lib logging: reduce debug logging a bit 2024-06-17 21:40:58 +03:00
man mu: add --reindex option for mu index 2024-04-05 19:03:42 +03:00
mu store-worker: temporarily revert 2024-06-05 12:21:24 +03:00
mu4e Correct period misplacement 2024-06-28 10:48:57 +09:00
testdata unit tests: improve 2023-09-12 21:38:57 +03:00
thirdparty thirdparty: use CLI11 v2.4.1 2024-04-01 16:11:30 +03:00
.dir-locals.el build: add -ts- support to dir-locals 2022-12-24 09:29:42 +02:00
.editorconfig tweak coding style / configuration 2022-02-13 14:33:12 +02:00
.gitignore build: use date.py instead of date 2023-10-14 16:25:58 +03:00
.mailmap Add .mailmap file 2020-02-17 14:28:00 +01:00
AUTHORS * initial import of mu - the next generation 2009-11-25 22:55:06 +02:00
autogen.sh build: path improvements 2023-10-14 16:46:05 +03:00
COPYING * initial import of mu - the next generation 2009-11-25 22:55:06 +02:00
IDEAS.org IDEAS.org: update 2024-05-07 23:53:43 +03:00
Makefile build: fix doc generation 2024-02-25 17:11:29 +02:00
meson_options.txt build: add cld2 option 2024-02-25 10:42:22 +00:00
meson.build logging: rework a bit, maybe support syslog 2024-05-07 09:27:50 +03:00
NEWS.org NEWS.org: update 2024-05-11 12:46:27 +03:00
README.org add IDEAS.org with some ideas for implementation 2024-02-06 23:29:58 +02:00

#+TITLE:mu https://img.shields.io/github/license/djcb/mu?logo=gnu&.svg https://img.shields.io/badge/Made%20with-C/CPP-1f425f?logo=c&.svg https://img.shields.io/github/v/release/djcb/mu.svg https://img.shields.io/github/contributors/djcb/mu.svg https://img.shields.io/github/issues/djcb/mu.svg https://img.shields.io/github/issues/djcb/mu/rfe?color=008b8b.svg https://img.shields.io/badge/PRs-welcome-brightgreen.svg
https://img.shields.io/badge/Emacs-26.3-922793?logo=gnu-emacs&logoColor=b39ddb&.svg https://img.shields.io/badge/Platform-Linux-2e8b57?logo=linux&.svg https://img.shields.io/badge/Platform-FreeBSD-8b3a3a?logo=freebsd&logoColor=c32136&.svg https://img.shields.io/badge/Platform-macOS-101010?logo=apple&logoColor=ffffff&.svg

[ Note: you are looking at the development branch, which is where new code is being developed and tested, and which may occasionally break. Distributions and non-adventurous users are instead recommended to use the 1.10 Release Branch or to pick up one of the 1.10 Releases. ]

Welcome to mu!

Latest development news: /emacs/mu/src/branch/master/NEWS.org.

With 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, and quickly file away message for later use.

mu is a tool for dealing with e-mail messages stored in the Maildir-format. mu's purpose in life is to help you to quickly find the messages you need; in addition, it allows you to view messages, extract attachments, create new maildirs, and so on.

After indexing your messages into a Xapian-database, you can search them using a custom query language. You can use various message fields or words in the body text to find the right messages.

Built on top of mu are some extensions (included in this package):

  • mu4e: a full-featured e-mail client that runs inside emacs
  • mu-guile: bindings for the Guile/Scheme programming language (version 3.0 and later)

mu is written in C++; mu4e is written in elisp and mu-guile in a mix of C++ and Scheme.

mu is available in Linux distributions (e.g. Debian/Ubuntu and Fedora) under the name maildir-utils; apparently because they don't like short names. All of the code is distributed under the terms of the GNU General Public License version 3 (or higher).


Note: building from source is an advanced subject, especially if something goes wrong. The below simple examples are a start, but all tools involved have many options; there are differences between systems, versions etc. So if this is all a bit daunting we recommend to wait for someone else to build it for you, such as a Linux distribution. Many have packages available.


To be able to build mu, ensure you have:

  • a C++17 compiler (gcc or clang are known to work)
  • development packages for Xapian and GMime and GLib (see meson.build for thex versions)
  • basic tools such as make, sed, grep
  • meson

For mu4e, you also need emacs.

Note, support for Windows is very much experimental, that is, it works for some people, but we can't really support it due to lack of the specific expertise. Help is welcome!


$ git clone git://github.com/djcb/mu.git
$ cd mu

mu uses meson for building, so you can use that directly, and all the usual commands apply. You can also use it indirectly through the provided Makefile, which provides a number of useful targets.

For instance, using the Makefile, you could install mu using:

$ ./autogen.sh && make
$ sudo make install

Alternatively, you can run meson directly (see the meson documentation for more details):

$ meson setup -C build
$ meson compile -C build
$ meson install -C build


Contributions are welcome! See the Github issue list and /emacs/mu/src/branch/master/IDEAS.org.