README.org

Himalaya Emacs

Emacs front-end for the email client Himalaya CLI.

Installation

himalaya-emacs is available on MELPA.

You can also install it using use-package.

1. Clone the repository using git to your desired location. In this example I’ll use ~/src/github.com/dantecatalfamo/himalaya-emacs.
2. Add the following use-package declaration to your init.el

   (use-package himalaya
     :if (file-exists-p "~/src/github.com/dantecatalfamo/himalaya-emacs")
     :load-path "~/src/github.com/dantecatalfamo/himalaya-emacs")
       

   This will load himalaya-emacs when it’s available, but stop it from throwing errors if you haven’t cloned it.

Customization

Most settings can be customized through the Emacs Easy Customize system. M-x customize-group himalaya

List envelopes

M-x himalaya or M-x himalaya-list-envelopes

Key	Action
n	Move cursor down
p	Move cursor up
m	Mark envelope at cursor
u	Unmark envelope at cursor
DEL	Unmark envelope at cursor (backward)
U	Unmark all envelopes
f	Forward page
b	Backward page
j	Jump to page
C-c C-s	Filter and sort query according to the given query
C-c a	Switch account
C-c f	Switch folder
C-c +	Add flag to marked envelopes (or envelope at point)
C-c -	Remove flag from marked envelopes (or envelope at point)
R	Reply to message at cursor
F	Forward message at cursor
w	Write new message
a	Download marked messages (or message at cursor) attachments
C	Copy marked messages (or message at cursor)
M	Move marked messages (or message at cursor)
D	Delete marked messages (or message at cursor)
e	Expunge current folder
RET	Read message at cursor

Read message

After pressing enter on an envelope, you’ll enter the message viewing mode.

Key	Action
a	Download all attachments
p	Previous message
n	Next message
r	Reply to message
f	Forward message
R	View raw message
q	Kill buffer

Reply all

Pressing the universal argument key (C-u by default) before pressing the reply key will reply all to a message.

Write new message

When writing a new message or a reply, press C-c C-c to send it or C-c C-k to delete it.

Credits

Special thanks to the NLnet foundation and the European Commission that helped the project to receive financial support from various programs:

• NGI Assure in 2022
• NGI Zero Entrust in 2023
• NGI Zero Core in 2024 (still ongoing)