Astroid is a lightweight and fast Mail User Agent that provides a graphical interface to searching, displaying and composing email, organized in threads and tags. Astroid uses the notmuch backend for blazingly fast searches through tons of email. Astroid searches, displays and composes emails - and rely on other programs for fetching, syncing and sending email. Check out Astroid in your general mail setup for a suggested complete e-mail solution.
lightweight and fast!
fully operable by keyboard.
graphical interface. buffers can be placed in separate windows.
display html mail and common attachments inline.
built-in crypto (PGP/MIME) support.
editors: embedded or external vim or emacs (or your favourite editor).
syntax highlighting of patches and code segments.
and much more...
Get astroid through git by:
$ git clone https://github.com/astroidmail/astroid.git
Installation and Usage
$ cd astroid $ cmake -H. -Bbuild -GNinja # to use the ninja backend $ cmake --build build
cmake -DOPTION=VALUE .. from
build/ to set any build options (list with
cmake -L). Subsequent builds can be done by running
make if you are using that) from the build directory.
And to run the tests do:
$ cd build $ ctest
Configure with a prefix and install:
$ cmake -H. -Bbuild -GNinja -DCMAKE_INSTALL_PREFIX=/usr/local $ cmake --build build --target install
This will install the
astroid binary into
/usr/local/bin/, and data files into
/usr/local/share/astroid/. Refer to the installing section in the wiki for more information.
The configuration of
astroid is kept in the directory
~/.config/astroid/). Refer to the configuration section in the wiki for how to configure astroid. You can use
astroid --new-config to create a configuration file filled with the default values. If no file exists, the default values are used.
Execution and Usage
$ ./build/astroid # to run from source repository
? to get a list of available key bindings in the current mode, navigate up and down using
k. Refer to the usage section in the wiki for more information on usage and customization.
Patches, Help, Comments and Bugs
Contributions to Astroid in the form of patches, documentation and testing are very welcome. Information on how to contribute to astroid can be found in the wiki.
This project adheres to Contributor Covenant Code of Conduct v1.4.
Some parts of the user interface and layout has been inspired by the Geary mail client. Also, some inspiration and code stems from ner (another notmuch email client).
See LICENSE.md for licensing information.