Go to file
Dirk-Jan C. Binnema b64e0b3194 build: bump version to 1.8.6 2022-07-14 08:16:01 +03:00
.github github: update bug template 2022-07-06 01:05:08 +03:00
build-aux build: don't install-info with DESTDIR 2022-07-06 01:05:22 +03:00
contrib tests: move to subdir, move to meson 2021-11-08 23:58:05 +02:00
guile build: use install-info when installing mu4e/guile 2022-07-01 08:31:00 +03:00
lib test-mu-store-query: add more contact-matching tests 2022-07-14 08:10:15 +03:00
m4 autotools: improve build 2022-05-19 23:38:49 +03:00
man man/mu-index.1: update 2022-06-07 23:06:25 +03:00
mu config: remove help_enabled flag 2022-06-30 07:44:03 +03:00
mu4e mu4e: add mu4e-copy-thing-at-point 2022-07-13 23:35:16 +03:00
.editorconfig tweak coding style / configuration 2022-02-13 14:33:12 +02:00
.gitignore mu4e: use mu4e-config instead of mu4e-meta 2022-05-29 11:10: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
COPYING * initial import of mu - the next generation 2009-11-25 22:55:06 +02:00
ChangeLog Fix incorrect ChangeLog. 2015-08-08 08:54:33 +07:00
Makefile.am autotools: improve build 2022-05-19 23:38:49 +03:00
Makefile.meson meson: improve coverage target 2022-06-29 22:20:44 +03:00
NEWS Add the missing NEWS 2015-06-09 21:08:02 +03:00
NEWS.org NEWS.org: update 2022-06-26 11:25:11 +03:00
README.org README.org: update 2022-07-02 12:22:48 +03:00
TODO * update TODO 2012-12-02 22:57:47 +02:00
autogen.sh build: fix macos/clang build (disable guile) 2021-10-18 22:31:44 +03:00
configure.ac build: bump version to 1.8.6 2022-07-14 08:16:01 +03:00
gtest.mk mu: allow for code-coverage reports 2020-01-01 15:56:48 +02:00
meson.build build: bump version to 1.8.6 2022-07-14 08:16:01 +03:00
meson_options.txt build: add 'lispdir' option 2022-07-02 12:18:51 +03:00
version.texi.in meson: Generate version.texi for guile, mu4e 2021-03-17 00:16:49 +02:00

README.org

#+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-25.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

Welcome to mu!

Note: you are looking at the development branch, which is where new code is being developed and tested, and which may occasionally break.

Distribution and non-adventurous users are instead recommended to use the 1.8 Release Branch or to pick up one of the 1.8 Releases.

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, 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. mu is fully documented.

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 and C++; mu4e is written in elisp and mu-guile in a mix of C++ and Scheme.

Note, 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).

Installation

Note: building from source is an advanced subject; esp. 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.

Requirements

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 the versions)
  • basic tools such as make, sed, grep
  • meson

For mu4e, you also need emacs.

Building

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

Now, you have a choice. mu uses meson for building, but includes a good-old Makefile with some useful targets, which should work for typical cases.

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

Alternatively, for more control, you can run meson directly:

$ meson build && ninja -C build
$ ninja -C build install

This allows for passing various meson options, such as --prefix. Consult the meson documentation for details.