mirror of
https://github.com/soywod/himalaya.git
synced 2024-07-19 22:51:13 +00:00
216 lines
6.2 KiB
Markdown
216 lines
6.2 KiB
Markdown
# 📫 Himalaya [WIP] [](https://github.com/soywod/himalaya/actions?query=workflow%3Adeployment)
|
|
|
|
Minimalist CLI email client, written in Rust.
|
|
|
|
|
|
|
|
## Table of contents
|
|
|
|
* [Motivation](#motivation)
|
|
* [Installation](#installation)
|
|
* [Configuration](#configuration)
|
|
* [Usage](#usage)
|
|
* [List mailboxes](#list-mailboxes)
|
|
* [List messages](#list-messages)
|
|
* [Search messages](#search-messages)
|
|
* [Download attachments](#download-attachments)
|
|
* [Read a message](#read-a-message)
|
|
* [Write a new message](#write-a-new-message)
|
|
* [Reply to a message](#reply-to-a-message)
|
|
* [Forward a message](#forward-a-message)
|
|
* [License](https://github.com/soywod/himalaya/blob/master/LICENSE)
|
|
* [Changelog](https://github.com/soywod/himalaya/blob/master/CHANGELOG.md)
|
|
* [Credits](#credits)
|
|
|
|
## Motivation
|
|
|
|
Bringing emails to the terminal is a pain. The mainstream TUI, (neo)mutt, takes
|
|
time to configure. The default mapping is not intuitive when coming from the
|
|
Vim environment. It is even scary to use at the beginning, since you are
|
|
dealing with sensitive data!
|
|
|
|
The aim of Himalaya is to extract the email logic into a simple CLI API that
|
|
can be used either directly from the terminal or from interfaces. It gives
|
|
users more flexibility.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
curl -sSL https://raw.githubusercontent.com/soywod/himalaya/master/install.sh | bash
|
|
```
|
|
|
|
*See [wiki section](https://github.com/soywod/himalaya/wiki/Installation) for
|
|
more information.*
|
|
|
|
## Configuration
|
|
|
|
```toml
|
|
# ~/.config/himalaya/config.toml
|
|
|
|
name = "Your full name"
|
|
downloads-dir = "/abs/path/to/downloads"
|
|
|
|
# Himalaya supports the multi-account
|
|
# Each account should be inside a TOML section
|
|
[gmail]
|
|
default = true
|
|
email = "my.email@gmail.com"
|
|
|
|
imap-host = "imap.gmail.com"
|
|
imap-port = 993
|
|
imap-login = "test@gmail.com"
|
|
imap-passwd_cmd = "pass show gmail"
|
|
|
|
smtp-host = "smtp.gmail.com"
|
|
smtp-port = 487
|
|
smtp-login = "test@gmail.com"
|
|
smtp-passwd_cmd = "pass show gmail"
|
|
|
|
[posteo]
|
|
name = "Your overriden full name"
|
|
downloads-dir = "/abs/path/to/overriden/downloads"
|
|
email = "test@posteo.net"
|
|
|
|
imap-host = "posteo.de"
|
|
imap-port = 993
|
|
imap-login = "test@posteo.net"
|
|
imap-passwd_cmd = "security find-internet-password -gs posteo -w"
|
|
|
|
smtp-host = "posteo.de"
|
|
smtp-port = 487
|
|
smtp-login = "test@posteo.net"
|
|
smtp-passwd_cmd = "security find-internet-password -gs posteo -w"
|
|
|
|
# [other accounts]
|
|
# ...
|
|
```
|
|
|
|
*See [wiki section](https://github.com/soywod/himalaya/wiki/Configuration) for
|
|
more information.*
|
|
|
|
## Usage
|
|
|
|
```
|
|
Himalaya 0.1.0
|
|
soywod <clement.douin@posteo.net>
|
|
📫 Minimalist CLI email client
|
|
|
|
USAGE:
|
|
himalaya [OPTIONS] [SUBCOMMAND]
|
|
|
|
FLAGS:
|
|
-h, --help Prints help information
|
|
-V, --version Prints version information
|
|
|
|
OPTIONS:
|
|
-a, --account <STRING> Name of the account to use
|
|
-o, --output <STRING> Format of the output to print [default: text] [possible values: text, json]
|
|
|
|
SUBCOMMANDS:
|
|
attachments Downloads all attachments from an email
|
|
forward Forwards an email
|
|
help Prints this message or the help of the given subcommand(s)
|
|
list Lists emails sorted by arrival date
|
|
mailboxes Lists all available mailboxes
|
|
read Reads text bodies of an email
|
|
reply Answers to an email
|
|
save Saves a raw message in the given mailbox
|
|
search Lists emails matching the given IMAP query
|
|
send Sends a raw message
|
|
template Generates a message template
|
|
write Writes a new email
|
|
```
|
|
|
|
*See [wiki section](https://github.com/soywod/himalaya/wiki/Usage) for more
|
|
information.*
|
|
|
|
### List mailboxes
|
|
|
|
Shows mailboxes in a basic table.
|
|
|
|
|
|
|
|
*See [wiki section](https://github.com/soywod/himalaya/wiki/Usage:mailboxes)
|
|
for more information.*
|
|
|
|
### List messages
|
|
|
|
Shows messages in a basic table.
|
|
|
|
|
|
|
|
*See [wiki section](https://github.com/soywod/himalaya/wiki/Usage:list) for
|
|
more information.*
|
|
|
|
### Search messages
|
|
|
|
Shows filtered messages in a basic table. The query should follow the
|
|
[RFC-3501](https://tools.ietf.org/html/rfc3501#section-6.4.4).
|
|
|
|
|
|
|
|
*See [wiki section](https://github.com/soywod/himalaya/wiki/Usage:search) for
|
|
more information.*
|
|
|
|
### Download attachments
|
|
|
|
Downloads attachments in the [`downloads-dir`](#configuration).
|
|
|
|
|
|
|
|
*See [wiki section](https://github.com/soywod/himalaya/wiki/Usage:attachments)
|
|
for more information.*
|
|
|
|
### Read a message
|
|
|
|
Shows the text content of a message (`text/plain` if exists, otherwise
|
|
`text/html`).
|
|
|
|
|
|
|
|
*See [wiki section](https://github.com/soywod/himalaya/wiki/Usage:read) for
|
|
more information.*
|
|
|
|
### Write a new message
|
|
|
|
Opens your default editor (from the `$EDITOR` environment variable) to compose
|
|
a new message.
|
|
|
|
```bash
|
|
himalaya write
|
|
```
|
|
|
|
*See [wiki section](https://github.com/soywod/himalaya/wiki/Usage:write) for
|
|
more information.*
|
|
|
|
### Reply to a message
|
|
|
|
Opens your default editor to reply to a message.
|
|
|
|
```bash
|
|
himalaya reply --all 5123
|
|
```
|
|
|
|
*See [wiki section](https://github.com/soywod/himalaya/wiki/Usage:reply) for
|
|
more information.*
|
|
|
|
### Forward a message
|
|
|
|
Opens your default editor to forward a message.
|
|
|
|
```bash
|
|
himalaya forward 5123
|
|
```
|
|
|
|
*See [wiki section](https://github.com/soywod/himalaya/wiki/Usage:forward) for
|
|
more information.*
|
|
|
|
## Credits
|
|
|
|
- [IMAP RFC3501](https://tools.ietf.org/html/rfc3501)
|
|
- [Iris](https://github.com/soywod/iris.vim), the himalaya predecessor
|
|
- [Neomutt](https://neomutt.org/)
|
|
- [mutt-wizard](https://github.com/LukeSmithxyz/mutt-wizard)
|
|
- [Alpine](http://alpine.x10host.com/alpine/alpine-info/)
|
|
- [rust-imap](https://github.com/jonhoo/rust-imap)
|