2016-01-09 20:12:00 +00:00
|
|
|
## Mails {#sec:modules:mails}
|
|
|
|
|
2018-07-23 05:08:51 +00:00
|
|
|
The Mails module implements a commandline email client. Emails can be written
|
|
|
|
(via `$EDITOR`) and viewed, also in threads. Emails can be crawled for creating
|
|
|
|
new contacts.
|
2017-08-11 22:12:43 +00:00
|
|
|
|
|
|
|
A Text User Interface is not planned, but might be there at some point.
|
|
|
|
|
2018-07-23 05:08:51 +00:00
|
|
|
The mail module implements a minimal Email client. It does not handle IMAP
|
|
|
|
syncing or SMTP things, it is just a _viewer_ for emails (a MUA).
|
2017-08-11 22:12:43 +00:00
|
|
|
|
2018-07-23 05:08:51 +00:00
|
|
|
The goal of the initial implementation is only a CLI, not a TUI like mutt
|
|
|
|
offers, for example (but that might be implemented later). As this is an imag
|
|
|
|
module, it also creates references to mails inside the imag store which can be
|
|
|
|
used by other tools then (for example `imag-link` to link an entry with a mail -
|
|
|
|
or the imag entry representing that mail).
|
2017-08-11 22:12:43 +00:00
|
|
|
|
2018-07-23 05:08:51 +00:00
|
|
|
So this module offers functionality to read (Maildir) mailboxes, search for and
|
|
|
|
list mails and mail-threads and reply to mails (by spawning the `$EDITOR`).
|
2016-01-09 20:12:00 +00:00
|
|
|
|
2018-07-23 05:08:51 +00:00
|
|
|
Outgoing mails are pushed to a special directory and can later on be send via
|
|
|
|
`imag-mail` which calls a MTA (for example msmtp) and also creates store entries
|
|
|
|
for the outgoing mails.
|
2017-08-12 21:26:26 +00:00
|
|
|
|
2017-08-20 23:03:22 +00:00
|
|
|
### CLI
|
|
|
|
|
|
|
|
The CLI of the imag-mail module is planned as follows:
|
|
|
|
|
2018-07-23 05:15:05 +00:00
|
|
|
imag mail track <path> [opts...] # track a new mail, mail file passed as path
|
|
|
|
imag mail scan <path> [opts...] # scan a maildir and track all untracked mails
|
|
|
|
imag mail box <name|path> # work with the mailbox specified by <name|path>, name mappings from config
|
|
|
|
imag mail list <args...> # list mails in a given mailbox for a given account or the default account
|
|
|
|
imag mail show <args...> # open new mails in the pager
|
|
|
|
imag mail thread list <args...> # list mails from a thread
|
|
|
|
imag mail thread show <args...> # open new mails from a thread in the pager or call a script with them
|
|
|
|
imag mail new <args...> # craft a new mail and safe it in the <outgoing> folder
|
|
|
|
imag mail compose <args...> # same as 'new'
|
|
|
|
imag mail send <args...> # send emails from the outgoing folder, optionally also move them to archive boxes
|
|
|
|
imag mail mv <src mail> <dstbox> # move a mail to another mailbox
|
|
|
|
imag mail mv thread <src mail> <dstbox> # move the thread of the mail to another mailbox
|
|
|
|
imag mail find <args...> # search for a mail (by header field (msgid, from, to, cc, subject, date, date-range), body, ...)
|
2017-08-20 23:03:22 +00:00
|
|
|
|