All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Added systemd service in
assets/
folder. - Added configuration option
message.delete.style
that can be eitherfolder
(deleted messages are moved to the Trash folder, default style) orflag
(deleted messages receive the Deleted flag). - Added
--debug
as an alias forRUST_LOG=debug
. - Added
--trace
as an alias forRUST_LOG=trace
andRUST_BACKTRACE=1
. - Added notes about
--debug
and--trace
when error occurs.
- Added back the search feature: you can now give an optional filter and sort query at the end of the
envelope list
command. Seeenvelope list --help
or pimalaya.org for more detail on the search API. - Changed the
envelope list
folder argument due to the search query: it became a flag--folder|-f
. - Made the global
--config|-c
option repeatable: the first option is considered the path to the main config, and successive options are considered partial overrides #184. - Refactored error management: error should be more clear, colored and can now contain spantrace and backtrace.
- Made
--help
content wrapping properly thanks to theclap
cargo featurewrap_help
. - Improved
template {new,reply,forward}
command JSON output: they return now a JSON object with 3 properties:content
: the content of the templatecursor.row
: the row at which the cursor should be placed by the interface using the templatecursor.col
: the column at which the cursor should be placed by the interface using the template
- Fixed watch IMAP envelopes when folder was empty [#179].
- Prevented parsing of undefined config options #188.
- Fixed
In-Reply-To
header being skipped from mailto URLs #194. - Fixed error page out of bounds when filtering envelopes returned an empty result #195.
- Added
account check-up
command. - Added wizard warning about google passwords #41.
-
Removed account configurations flatten level in order to improve diagnostic errors, due to a bug in clap. This means that accounts need to be prefixed by
accounts
:[my-account]
becomes[accounts.my-account]
. It also opens doors for interface-specific configurations. -
Rolled back cargo feature additions from the previous release. It was a mistake: the amount of features was too big, the code (both CLI and lib) was too hard to maintain. Cargo features kept:
imap
,maildir
,notmuch
,smtp
,sendmail
,account-sync
,account-discovery
,pgp-gpg
,pgp-commands
andpgp-native
. -
Moved
sync.strategy
tofolder.sync.filter
. -
Changed location of the synchronization data from
$XDG_DATA_HOME/himalaya/<account-name>
to$XDG_DATA_HOME/pimalaya/email/sync/<account-name>-cache
. -
Changed location of the synchronization cache from
sync.dir
to$XDG_CACHE_HOME/pimalaya/email/sync/<hash>/
. -
Replaced id mapping database
SQLite
bysled
, a pure key-val store written in Rust to improve portability of the tool. Therefore, id aliases are reset. -
Improved pre and post edit choices interaction #58.
-
Improved account synchronization performances, making it 50% faster than
mbsync
and 370% faster thanOfflineIMAP
. -
Changed
envelope.watch.{event}.{hook}
: hooks can now be cumulated. For example it is possible to send a system notification and execute a shell command when receiving a new envelope:envelope.watch.received.notify.summary = "New message from {sender}" envelope.watch.received.notify.body = "{subject}" envelope.watch.received.cmd = "echo {id} >> /tmp/new-email-counter"
- Fixed bug that was preventing watch placeholders to be replaced when using shell command hook.
- Fixed watch IMAP envelopes issue preventing events to be triggered.
- Fixed DNS account discovery priority issues.
- Fixed SMTP messages not properly sent to all recipients #172.
- Fixed backend feature badly linked, leading to reply and forward message errors #173.
1.0.0-beta.2 - 2024-01-27
- Added cargo feature
wizard
, enabled by default. - Added one cargo feature per backend feature:
account
includingaccount-configure
,account-list
,account-sync
and theaccount-subcmd
folder
includingfolder-add
,folder-list
,folder-expunge
,folder-purge
,folder-delete
and thefolder-subcmd
envelope
includingenvelope-list
,envelope-watch
,envelope-get
and theenvelope-subcmd
flag
includingflag-add
,flag-set
,flag-remove
and theflag-subcmd
message
includingmessage-read
,message-write
,message-mailto
,message-reply
,message-forward
,message-copy
,message-move
,message-delete
,message-save
,message-send
and themessage-subcmd
attachment
includingattachment-download
and theattachment-subcmd
template
includingtemplate-write
,template-reply
,template-forward
,template-save
,template-send
and thetemplate-subcmd
- Added wizard capability to autodetect IMAP and SMTP configurations, based on the Thunderbird Autoconfiguration standard.
- Added back Notmuch backend features.
- Renamed
folder create
tofolder add
in order to better match types. An alias has been set up, so bothcreate
andadd
still work.
- Fixed default command: running
himalaya
without argument lists envelopes, as it used to be in previous versions. - Fixed bug when listing envelopes with
backend = "imap"
,sync.enable = true
andenvelope.watch.backend = "imap"
led to unwanted IMAP connection creation (which slowed down the listing). - Fixed builds related to enabled cargo features.
1.0.0-beta - 2024-01-01
Few major concepts changed:
- The concept of Backend and Sender changed. The Sender does not exist anymore (it is now a backend feature). A Backend is now a set of features like add folders, list envelopes or send raw message. The backend of every single feature can be customized in the configuration file, which gives users more flexibility. Here the list of backend features that can be customized:
backend
(required): the backend used by default by all backend features (maildir
,imap
ornotmuch
)folder.add.backend
: override the backend used for creating folders (maildir
,imap
ornotmuch
)folder.list.backend
: override the backend used for listing folders (maildir
,imap
ornotmuch
)folder.expunge.backend
: override the backend used for expunging folders (maildir
,imap
ornotmuch
)folder.purge.backend
: override the backend used for purging folders (maildir
,imap
ornotmuch
)folder.delete.backend
: override the backend used for deleting folders (maildir
,imap
ornotmuch
)envelope.list.backend
: override the backend used for listing envelopes (maildir
,imap
ornotmuch
)envelope.get.backend
: override the backend used for getting envelopes (maildir
,imap
ornotmuch
)envelope.watch.backend
: override the backend used for watching envelopes (maildir
,imap
ornotmuch
)flag.add.backend
: override the backend used for adding flags (maildir
,imap
ornotmuch
)flag.set.backend
: override the backend used for setting flags (maildir
,imap
ornotmuch
)flag.remove.backend
: override the backend used for removing flags (maildir
,imap
ornotmuch
)message.send.backend
(required): override the backend used for sending messages (sendmail
orsmtp
)message.read.backend
: override the backend used for reading messages (maildir
,imap
ornotmuch
)message.write.backend
: override the backend used for adding flags (maildir
,imap
ornotmuch
)message.copy.backend
: override the backend used for copying messages (maildir
,imap
ornotmuch
)message.move.backend
: override the backend used for moving messages (maildir
,imap
ornotmuch
)
- The CLI API changed: every command is now prefixed by its domain following the format
himalaya <domain> <action>
. List of domain available by runninghimalaya -h
and list of actions for a domain by runninghimalaya <domain> -h
. - TOML configuration file options use now the dot notation rather than the dash notation. For example,
folder-listing-page-size
becamefolder.list.page-size
. See the changed section below for more details.
- Added cargo feature
maildir
(not plugged yet). - Added cargo feature
sendmail
(not plugged yet). - Added watch hooks
envelope.watch.received
(when a new envelope is received) andenvelope.watch.any
(for any other event related to envelopes). A watch hook can be:-
A shell command:
envelope.watch.any.cmd = "mbsync -a"
-
A system notification:
envelope.watch.received.notify.summary = "📬 New message from {sender}"
: customize the notification summary (title)envelope.watch.received.notify.body = "{subject}"
: customize the notification body (content)
Available placeholders: id, subject, sender, sender.name, sender.address, recipient, recipient.name, recipient.address.
-
- Added watch support for Maildir backend features.
- Renamed cargo feature
imap-backend
→imap
. - Renamed cargo feature
notmuch-backend
→notmuch
. - Renamed cargo feature
smtp-sender
→smtp
. - Changed the goal of the config option
backend
: it is now the default backend used for all backend features. Valid backends:imap
,maildir
,notmuch
. - Moved
folder-aliases
config option tofolder.alias(es)
. - Moved
folder-listing-page-size
config option tofolder.list.page-size
. - Moved
email-listing-page-size
config option toenvelope.list.page-size
. - Moved
email-listing-datetime-fmt
config option toenvelope.list.datetime-fmt
. - Moved
email-listing-datetime-local-tz
config option toenvelope.list.datetime-local-tz
. - Moved
email-reading-headers
config option tomessage.read.headers
. - Moved
email-reading-format
config option tomessage.read.format
. - Moved
email-writing-headers
config option tomessage.write.headers
. - Move
email-sending-save-copy
config option tomessage.send.save-copy
. - Move
email-hooks.pre-send
config option tomessage.send.pre-hook
. - Moved
sync
config option tosync.enable
. - Moved
sync-dir
config option tosync.dir
. - Moved
sync-folders-strategy
config option tosync.strategy
. - Moved
maildir-*
config options tomaildir.*
. - Moved
imap-*
config options toimap.*
. - Moved
notmuch-*
config options tonotmuch.*
. - Moved
sendmail-*
config options tosendmail.*
. - Moved
smtp-*
config options tosmtp.*
. - Replaced options
imap-ssl
,imap-starttls
andimap-insecure
byimap.encryption
:imap.encryption = "tls" | true
: use required encryption (SSL/TLS)imap.encryption = "start-tls"
: use opportunistic encryption (StartTLS)imap.encryption = "none" | false
: do not use any encryption
- Replaced options
smtp-ssl
,smtp-starttls
andsmtp-insecure
bysmtp.encryption
:smtp.encryption = "tls" | true
: use required encryption (SSL/TLS)smtp.encryption = "start-tls"
: use opportunistic encryption (StartTLS)smtp.encryption = "none" | false
: do not use any encryption
- Disabled temporarily the
notmuch
backend because it needs to be refactored using the backend features system (it should be reimplemented soon). - Disabled temporarily the
search
andsort
command because they need to be refactored, see #39. - Removed the
notify
command (replaced by the newwatch
command). - Removed all global options except for
display-name
,signature
,signature-delim
anddownloads-dir
.
0.9.0 - 2023-08-28
- Added 3 new cargo features:
pgp-commands
: enables the commands PGP backend (enabled by default, same behaviour as before)pgp-gpg
: enables the GPG backend (requires thegpgme
lib on the system)pgp-native
: enables the native PGP backend
- Added account configuration
pgp
to configure the way PGP operations are performed.
- Moved
email-writing-encrypt-cmd
topgp.encrypt-cmd
. - Moved
email-reading-decrypt-cmd
topgp-decrypt-cmd
. - Moved
email-writing-sign-cmd
topgp.sign-cmd
. - Moved
email-reading-verify-cmd
topgp.verify-cmd
.
0.8.4 - 2023-07-18
- Fixed windows releases due to cargo deps typo.
0.8.3 - 2023-07-18
- Fixed windows releases due to
coredump
crate compilation error. - Fixed macos releases due to macos 12 System Integrity Protection.
0.8.2 - 2023-07-18
- Made the code async using the tokio async runtime.
- On Linux, made the kernel keyring the default one (the one based on keyutils).
- Fixed the way folder aliases are resolved. In some case, aliases were resolved CLI side and lib side, which led to alias errors #95.
0.8.1 - 2023-06-15
- Implemented OAuth 2.0 refresh token flow for IMAP and SMTP, which means that access tokens are now automatically refreshed and is transparent for users.
- Added
imap-oauth2-redirect-host
andsmtp-oauth2-redirect-host
options to customize the redirect server host name (default:localhost
). - Added
imap-oauth2-redirect-port
andsmtp-oauth2-redirect-port
options to customize the redirect server port (default:9999
). - Added
email-listing-datetime-fmt
to customize envelopes datetime format. See format spec here. - Added
email-listing-local-datetime
to transform envelopes datetime's timezone to the user's local one. For example, if the user's local is set toUTC
, the envelope date2023-06-15T09:00:00+02:00
becomes2023-06-15T07:00:00-00:00
.
- Fixed missing
<
and>
aroundMessage-ID
andIn-Reply-To
headers.
0.8.0 - 2023-06-03
- Added keyring support, which means Himalaya can now use your system's global keyring to get/set sensitive data like passwords or tokens.
- Added required IMAP option
imap-auth
and SMTP optionsmtp-auth
. Possible values:passwd
,oauth2
. - Added OAuth 2.0 support for IMAP and SMTP.
- Added passwords and OAuth 2.0 configuration via the wizard.
- Added
email-sending-save-copy
option to control whenever a copy of any sent email should be saved in thesent
folder defined infolder-aliases
. - Imported id mapper from the lib, which means that the id mapping is now done by the CLI.
- Added
BackendConfig
toAccountConfig::backend
to match sender implementation. - Added support for pipeline commands, which means commands can be either a single command (string) or piped commands (list of strings). It applies for:
email-writing-verify-cmd
email-writing-decrypt-cmd
email-writing-sign-cmd
email-writing-encrypt-cmd
-
Changed release archive extensions from
.tar.gz
to.tgz
. -
Moved
wizard
module into domains (config, account, backend…). -
[BREAKING] Changed the way secrets are managed. A secret is a sensitive data like passwords or tokens. There is 3 possible ways to declare a secret in the config file:
{ raw = <secret> }
for the raw secret as string (unsafe, not recommended),{ cmd = <secret-cmd> }
for command that exposes the secret,{ keyring = <secret-entry> }
for entry in your system's global keyring that contains the secret.
This applies for:
imap-passwd
imap-oauth2-client-secret
imap-oauth2-access-token
imap-oauth2-refresh-token
smtp-passwd
smtp-oauth2-client-secret
smtp-oauth2-access-token
smtp-oauth2-refresh-token
- Fixed Windows releases corrupted archives.
- [BREAKING] Removed
-s|--sanitize
option. It is done by default now, except if the-t|--mime-type html
is set. - [BREAKING] Removed
native-tls
support,rustls-tls
is now the only TLS provider available. Removed in consequencenative-tls
,rustls-tls
andrustls-native-certs
cargo features.
0.7.3 - 2023-05-01
- Fixed Windows releases (due to typo in the github action script).
- Fixed unit tests.
0.7.2 - 2023-05-01
-
Added
create
anddelete
folder commands #54. -
Added generated completions and man pages to releases #43.
-
Added new account config option
sync-folders-strategy
which allows to choose a folders synchronization strategy #59:sync-folders-strategy = "all"
: synchronize all existing folders for the current accountsync-folders-strategy.include = ["folder1", "folder2", …]
: synchronize only the given folders for the current accountsync-folders-strategy.exclude = ["folder1", "folder2", …]
: synchronizes all folders except the given ones for the current account
Also added new
account sync
arguments that override the account config option:-A|--all-folders
: include all folders to the synchronization.-F|--include-folder
: include given folders to the synchronization. They can be repeated-F folder1 folder2
or-F folder1 -F folder2
.-x|--exclude-folder
: exclude given folders from the synchronization. They can be repeated-x folder1 folder2
or-x folder1 -F folder2
.
-
Added cargo features
native-tls
(default),rustls-tls
andrustls-native-certs
.
- Made global options truly global, which means they can be used everywhere (not only before commands but also after) #60.
- Replaced reply all
-a
argument with-A
because it conflicted with the global option-a|--account
. - Replaced
himalaya-lib
bypimalaya-email
. - Renamed feature
vendored
tonative-tls-vendored
. - Removed the
develop
branch, all the development is now done on themaster
branch.
- Fixed config deserialization issue with
email-hooks
andemail-reading-format
. - Fixed flags case sensitivity.
0.7.1 - 2023-02-14
- Added command
folders expunge
that deletes all emails marked for deletion.
- Changed the location of the documentation.
- Fixed broken links in README.md.
- Removed the
maildir-backend
cargo feature, it is now included by default. - Removed issues section on GitHub, now issues need to be opened by sending an email at ~soywod/[email protected].
0.7.0 - 2023-02-08
- Added offline support with the
account sync
command to synchronize a backend to a local Maildir backend. - Added the flag
--disable-cache
to not use the local Maildir backend. - Added the email composer (from its own repository).
- Added Musl builds to releases.
- Added
himalaya man
command to generate man page.
- Made commands
read
,attachments
,flags
,copy
,move
,delete
accept multiple ids. - Flipped arguments
ids
andfolder
for commandscopy
andmove
in order the folder not to be considered as an id.
- Fixed missing folder aliases.
- Removed the
-a|--attachment
argument fromwrite
,reply
andforward
commands. Instead you can attach documents directly from the template using the syntax<#part filename=/path/to/you/document.ext>
. - Removed the
-e|--encrypt
flag fromwrite
,reply
andforward
commands. Instead you can encrypt and sign parts directly from the template using the syntax<#part type=text/plain encrypt=command sign=command>Hello!<#/part>
. - Removed the
-l|--log-level
option, use instead theRUST_LOG
environment variable (see the wiki)
0.6.1 - 2022-10-12
- Added
-s|--sanitize
flag for theread
command.
- Changed the behaviour of the
-t|--mime-type
argument of theread
command. It is less strict now: if no part is found for the given MIME type, it will fallback to the other one. For example, giving-t html
will show in priority HTML parts, but if none of them are found it will show plain parts instead (and vice versa). - Sanitization is not done by default when using the
read
command, the flag-s|--sanitize
needs to be explicitly provided.
- Fixed empty text bodies when reading html part on plain text email.
0.6.0 - 2022-10-10
-
Separated the CLI from the lib module.
The source code has been split into subrepositories:
-
[BREAKING] Renamed
-m|--mailbox
to-f|--folder
-
[BREAKING] Refactored config system.
The configuration has been rethought in order to be more intuitive and structured. Here are the breaking changes for the global config:
name
becomesdisplay-name
and is not mandatory anymoresignature-delimiter
becomessignature-delim
default-page-size
has been moved tofolder-listing-page-size
andemail-listing-page-size
notify-cmd
,notify-query
andwatch-cmds
have been removed from the global config (available in account config only)folder-aliases
has been added to the global config (previously known asmailboxes
from the account config)email-reading-headers
,email-reading-format
,email-reading-decrypt-cmd
,email-writing-encrypt-cmd
andemail-hooks
have been added
The account config inherits the same breaking changes from the global config, plus:
imap-*
requiresbackend = "imap"
maildir-*
requiresbackend = "maildir"
notmuch-*
requiresbackend = "notmuch"
smtp-*
requiressender = "smtp"
sendmail-*
requiressender = "sendmail"
pgp-encrypt-cmd
becomesemail-writing-encrypt-cmd
pgp-decrypt-cmd
becomesemail-reading-decrypt-cmd
mailboxes
becomesfolder-aliases
hooks
becomesemail-hooks
maildir-dir
becomesmaildir-root-dir
notmuch-database-dir
becomesnotmuch-db-path
0.5.10 - 2022-03-20
- Fixed flag commands.
- Fixed Windows build.
0.5.9 - 2022-03-12
- SMTP pre-send hook
- Customize headers to show at the top of a read message
- Improve
attachments
command
In-Reply-To
not set properly when replying to a messageCc
missing or invalid when replying to a message- Notmuch backend hangs
- Maildir e2e tests
- JSON API for listings
0.5.8 - 2022-03-04
- Flowed format support
- List accounts command
- One cargo feature per backend
- Vim doc about mailbox pickers
- Some emojis break the table layout
- Bad sender and date in reply and forward template
0.5.7 - 2022-03-01
- Notmuch support
- Build failure due to
imap
version - No tilde expansion in
maildir-dir
- Unknown command SORT
- [BREAKING] Replace
inbox-folder
,sent-folder
anddraft-folder
by a generic hashmapmailboxes
- Display short envelopes id for
maildir
andnotmuch
backends
0.5.6 - 2022-02-22
- Sort command
- Maildir support
- Suffix to downloaded attachments with same name
0.5.5 - 2022-02-08
- Contributing guide
- Notify query config option
- End-to-end encryption
- Multiple recipients issue
- Cannot parse address
0.5.4 - 2022-02-05
- Add attachments with save and send commands
- Invalid sequence set
0.5.3 - 2022-02-03
- Activate rust-imap logs when trace mode is enabled
- Set up cargo deployment
0.5.2 - 2022-02-02
- Blur in list msg screenshot
- Make inbox, sent and drafts folders customizable
- Vim plugin get focused msg id
- Nix run issue
- Range not displayed when fetch fails
- Blank lines and spaces in
text/plain
parts - Watch command
- Mailbox telescope.nvim preview
- The wiki git submodule
0.5.1 - 2021-10-24
- Disable color feature
--max-width|-w
argument to restrict listing table width
- Error when receiving notification from
notify
command
- Remove error when empty subject
- Vim plugin does not render anymore the msg by itself, it uses the one available from the CLI
0.5.0 - 2021-10-10
- Mailto support
- Remove previous signature when replying/forwarding a message
- Config option
signature-delimiter
to customize the signature delimiter (default to-- \n
) - Expand tilde and env vars for
downloads-dir
andsignature
- [BREAKING] Folder structure, message management, JSON API and Vim plugin
- Pagination for list and search cmd starts from 1 instead of 0
- Errors management with
anyhow
- Panic on flags command
- Make more use of serde
- Write message vim plugin
- Invalid encoding when sending message
- Pagination reset current account
- New/reply/forward from Vim plugin since Tpl refactor
0.4.0 - 2021-06-03
- Add ability to change account in with the Vim plugin
- Add possibility to make Himalaya default email app
- [BREAKING] Short version of reply
--all
arg is now-A
to avoid conflicts with--attachment|-a
- Template management
\Seen
flag when moving a message- Attachments arg for reply and forward commands
- Vim doc
Content-Type
from templates
0.3.2 - 2021-05-08
- Mailbox attributes
- Wiki entry about new messages counter
- Copy/move/delete a message in vim
- Get signature from file
- [BREAKING] Split
idle
command into two commands:notify
: Runsnotify-cmd
when a new message arrives to the serverwatch
: Runswatch-cmds
when any change occurs on the server
.exe
extension from release binaries
0.3.1 - 2021-05-04
- Send message via stdin
- Table with subject containing
\r
,\n
or\t
- Overflow panic when shrink column
- Vim plugin empty mailbox message
0.3.0 - 2021-04-28
- IDLE mode after network interruption
- Output redirected to
stderr
- Refactor table system
- Editon file format on Linux
- Show email address when name not available
--log-level|-l
arg (replaced by defaultRUST_LOG
env var fromenv_logger
)
0.2.7 - 2021-04-24
- Default page size to config
- Custom config path
- Setting idle-hook-cmds
- Plain logger with
env_logger
- Refresh email list on load buffer
- Improve config compatibility on Windows
- Vim table containing emoji
0.2.6 - 2021-04-17
- Insecure TLS option
- Completion subcommands
- Vim flags to enable telescope preview and to choose picker
- Make
install.sh
POSIX compliant
- SMTP port
- Save msg upon error
- Answered flag not set
- Panic when downloads-dir does not exist
- Idle mode incorrect new message notification
0.2.5 - 2021-04-12
- Expunge mbox after
move
anddelete
cmd - JSON output
0.2.4 - 2021-04-09
- Wiki entry for Gmail users
- Info logs for copy/move/delete cmd + silent mode
--raw
arg forread
cmd
- Refactor output system + log levels
0.2.3 - 2021-04-08
- Telescope support
- Unicode chars breaks the view
- Copy/move incomplete (missing parts)
0.2.2 - 2021-04-04
w
alias forwrite
cmd
attachments
cmd logs- Page size arg
search
cmd
0.2.1 - 2021-04-04
- IDLE support
- Improve choice after editing msg
- Flags management
- Copy feature
- Move feature
- Delete feature
- Signature support
- Add attachment(s) to a message (CLI)
- Errors management with
error_chain
- Missing
FLAGS
column in messages table - Subtract with overflow if next page empty
0.2.0 - 2021-03-10
- STARTTLS support
- Flags
- JSON support
0.1.0 - 2021-01-17
- Parse TOML config
- Populate Config struct from TOML
- Set up IMAP connection
- List new emails
- Set up CLI arg parser
- List mailboxes command
- Text and HTML previews
- Set up SMTP connection
- Write new email
- Write new email
- Reply, reply all and forward
- Download attachments
- Merge
Email
withMsg
- List command with pagination
- Icon in table when attachment is present
- Multi-account
- Password from command
- Set up README