Go to file
Dirk-Jan C. Binnema 88f5f92b72 build: fix macos/clang build (disable guile)
error: invalid argument '-std=gnu11' not allowed with 'C++'
2021-10-18 22:31:44 +03:00
.github build: fix macos/clang build (disable guile) 2021-10-18 22:31:44 +03:00
build-aux build: add dummy config.rpath 2018-05-29 10:59:20 +03:00
contrib mu: use g_strerror instead of strerror 2021-07-29 00:02:30 +03:00
guile guile: Fix and re-enable unit test 2021-03-17 18:33:05 +02:00
lib lib: replace CATCH_BLOCK macros with template magic 2021-10-18 21:52:37 +03:00
m4 build: require c++17 2021-08-28 09:54:05 +03:00
man guile: fix user script path detection 2021-10-18 21:52:37 +03:00
mu guile: fix user script path detection 2021-10-18 21:52:37 +03:00
mu4e mu4e: fix some compiler warnings 2021-10-18 21:52:37 +03:00
toys toys/mug: Fix some compiler warnings 2021-03-16 17:44:41 +02:00
www Fix typos 2020-05-12 23:56:55 +02:00
.clang-format .clang-format: update 2021-10-18 21:52:37 +03:00
.editorconfig build: update coding-style settings 2021-08-29 20:30:29 +03:00
.gitignore contacts: remove some dead code 2021-01-22 22:53:35 +02: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 build: remove some obsolete files 2021-08-29 20:30:29 +03:00
Makefile.meson build: Extend makefile targets 2021-09-04 10:41:07 +03:00
NEWS Add the missing NEWS 2015-06-09 21:08:02 +03:00
NEWS.org NEWS.org: update build instructions 2021-09-05 11:28:16 +03:00
README.org Merge pull request #2059 from japhir/patch-1 2021-07-28 17:09:08 +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 Add Emacs v29 support for enabling mu4e 2021-10-11 08:38:01 -04:00
gtest.mk mu: allow for code-coverage reports 2020-01-01 15:56:48 +02:00
meson.build meson.build: Improve guile detection 2021-10-16 11:15:12 +03:00
meson_options.txt build: experimental support for the meson build system 2021-02-12 00:49:35 +02: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 https://img.shields.io/badge/Platform-Windows-00bfff?logo=windows&logoColor=00bfff&.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.6.x Release Branch or to pick up one of the 1.6.x 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. See the mu cheatsheet for some examples. 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 2.2 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).