v1.0.0-beta.4

Added

• Added systemd service in assets/ folder.
• Added configuration option message.delete.style that can be either folder (deleted messages are moved to the Trash folder, default style) or flag (deleted messages receive the Deleted flag).
• Added --debug as an alias for RUST_LOG=debug.
• Added --trace as an alias for RUST_LOG=trace and RUST_BACKTRACE=1.
• Added notes about --debug and --trace when error occurs.

Changed

• Added back the search feature: you can now give an optional filter and sort query at the end of the envelope list command. See envelope 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 the clap cargo feature wrap_help.
• Improved template {new,reply,forward} command JSON output: they return now a JSON object with 3 properties:
  • content: the content of the template
  • cursor.row: the row at which the cursor should be placed by the interface using the template
  • cursor.col: the column at which the cursor should be placed by the interface using the template

Fixed

• 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.

v1.0.0-beta.3

Added

• Added account check-up command.
• Added wizard warning about google passwords [#41].

Changed

• 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 and pgp-native.

• Moved sync.strategy to folder.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 by sled, 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 than OfflineIMAP.

• 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

• 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].

v1.0.0-beta.2

Added

• Added cargo feature wizard, enabled by default.
• Added one cargo feature per backend feature:
  • account including account-configure, account-list, account-sync and the account-subcmd
  • folder including folder-add, folder-list, folder-expunge, folder-purge, folder-delete and the folder-subcmd
  • envelope including envelope-list, envelope-watch, envelope-get and the envelope-subcmd
  • flag including flag-add, flag-set, flag-remove and the flag-subcmd
  • message including message-read, message-write, message-mailto, message-reply, message-forward, message-copy, message-move, message-delete, message-save, message-send and the message-subcmd
  • attachment including attachment-download and the attachment-subcmd
  • template including template-write, template-reply, template-forward, template-save, template-send and the template-subcmd
• Added wizard capability to autodetect IMAP and SMTP configurations, based on the Thunderbird Autoconfiguration standard.
• Added back Notmuch backend features.

Changed

• Renamed folder create to folder add in order to better match types. An alias has been set up, so both create and add still work.

Fixed

• 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 and envelope.watch.backend = "imap" led to unwanted IMAP connection creation (which slowed down the listing).
• Fixed builds related to enabled cargo features.

v1.0.0-beta

The new API of the configuration file contains breaking changes, see config.sample.toml for a documented example of this new API.

You can even test it:

# save the sample config locally
curl https://raw.githubusercontent.com/soywod/himalaya/master/config.sample.toml > config.sample.toml

# spawn a testing IMAP/SMTP server using docker
docker run -it --rm -p 3025:3025 -p 3110:3110 -p 3143:3143 -p 3465:3465 -p 3993:3993 -p 3995:3995 -e GREENMAIL_OPTS='-Dgreenmail.setup.test.all -Dgreenmail.hostname=0.0.0.0 -Dgreenmail.auth.disabled -Dgreenmail.verbose' greenmail/standalone:latest

# test the CLI using the sample config
himalaya -c ./config.sample.toml envelope list

---

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 or notmuch)
  • folder.add.backend: override the backend used for creating folders (maildir, imap or notmuch)
  • folder.list.backend: override the backend used for listing folders (maildir, imap or notmuch)
  • folder.expunge.backend: override the backend used for expunging folders (maildir, imap or notmuch)
  • folder.purge.backend: override the backend used for purging folders (maildir, imap or notmuch)
  • folder.delete.backend: override the backend used for deleting folders (maildir, imap or notmuch)
  • envelope.list.backend: override the backend used for listing envelopes (maildir, imap or notmuch)
  • envelope.get.backend: override the backend used for getting envelopes (maildir, imap or notmuch)
  • envelope.watch.backend: override the backend used for watching envelopes (maildir, imap or notmuch)
  • flag.add.backend: override the backend used for adding flags (maildir, imap or notmuch)
  • flag.set.backend: override the backend used for setting flags (maildir, imap or notmuch)
  • flag.remove.backend: override the backend used for removing flags (maildir, imap or notmuch)
  • message.send.backend (required): override the backend used for sending messages (sendmail or smtp)
  • message.read.backend: override the backend used for reading messages (maildir, imap or notmuch)
  • message.write.backend: override the backend used for adding flags (maildir, imap or notmuch)
  • message.copy.backend: override the backend used for copying messages (maildir, imap or notmuch)
  • message.move.backend: override the backend used for moving messages (maildir, imap or notmuch)
• The CLI API changed: every command is now prefixed by its domain following the format himalaya <domain> <action>. List of domain available by running himalaya -h and list of actions for a domain by running himalaya <domain> -h.
• TOML configuration file options use now the dot notation rather than the dash notation. For example, folder-listing-page-size became folder.list.page-size. See the changed section below for more details.

Added

• 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) and envelope.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.

Changed

• 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 to folder.alias(es).
• Moved folder-listing-page-size config option to folder.list.page-size.
• Moved email-listing-page-size config option to envelope.list.page-size.
• Moved email-listing-datetime-fmt config option to envelope.list.datetime-fmt.
• Moved email-listing-datetime-local-tz config option to envelope.list.datetime-local-tz.
• Moved email-reading-headers config option to message.read.headers.
• Moved email-reading-format config option to message.read.format.
• Moved email-writing-headers config option to message.write.headers.
• Move email-sending-save-copy config option to message.send.save-copy.
• Move email-hooks.pre-send config option to message.send.pre-hook.
• Moved sync config option to sync.enable.
• Moved sync-dir config option to sync.dir.
• Moved sync-folders-strategy config option to sync.strategy.
• Moved maildir-* config options to maildir.*.
• Moved imap-* config options to imap.*.
• Moved notmuch-* config options to notmuch.*.
• Moved sendmail-* config options to sendmail.*.
• Moved smtp-* config options to smtp.*.
• Replaced options imap-ssl, imap-starttls and imap-insecure by imap.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 and smtp-insecure by smtp.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

Removed

• 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 and sort command because they need to be refactored, see #39.
• Removed the notify command (replaced by the new watch command).
• Removed all global options except for display-name, signature, signature-delim and downloads-dir.

---

See config.sample.toml for a documented configuration example with the new API.

v0.9.0

This version should be the last before the v1.0.0-beta!

Added

• 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 the gpgme lib on the system)
  • pgp-native: enables the native PGP backend
• Added account configuration pgp to configure the way PGP operations are performed.

Changed

• Moved email-writing-encrypt-cmdto pgp.encrypt-cmd.
• Moved email-reading-decrypt-cmd to pgp-decrypt-cmd.
• Moved email-writing-sign-cmd to pgp.sign-cmd.
• Moved email-reading-verify-cmd to pgp.verify-cmd.

v0.8.4

Fixed

• Fixed windows releases due to cargo deps typo.

v0.8.3

Fixed

• Fixed windows releases due to coredump crate compilation error.
• Fixed macos releases due to macos 12 System Integrity Protection.

v0.8.2

Changed

• Made the code async using the tokio async runtime.
• On Linux, made the kernel keyring the default one (the one based on keyutils).

Fixed

• Fixed the way folder aliases are resolved. In some case, aliases were resolved CLI side and lib side, which led to alias errors [sourcehut#95].

pimalaya-email-tpl

Fixed

• Fixed default PGP verify command that was using invalid option --recipient.

pimalaya-email

Changed

• Changed the way folder aliases are resolved. They are now resolved directly from backend implementations, which frees interfaces from this responsibility [#95].
• Bumped [email protected].

Fixed

• Fixed absolute folder aliases for the maildir backend [#94].
• Fixed notmuch virtual folder [#92].

v0.8.1

Added

• 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 and smtp-oauth2-redirect-host options to customize the redirect server host name (default: localhost).
• Added imap-oauth2-redirect-port and smtp-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 to UTC, the envelope date 2023-06-15T09:00:00+02:00 becomes 2023-06-15T07:00:00-00:00.

Fixed

• Fixed missing < and > around Message-ID and In-Reply-To headers.

v0.8.0

Added

• 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 option smtp-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 the sent folder defined in folder-aliases.
• Imported id mapper from the lib, which means that the id mapping is now done by the CLI.
• Added BackendConfig to AccountConfig::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

• 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 recommanded),
  • { 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

• Fixed Windows releases corrupted archives.

Removed

• [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 consequence native-tls, rustls-tls and rustls-native-certs cargo features.

pimalaya-email

Added

• Added IP support using rustls v0.21 [#80].
• Added AccountConfig::generate_tpl_interpreter function to generate a template interpreter with default options based on the config (pgp encrypt, pgp verify and attachments dir).

Changed

• Changed AccountConfig::addr return type from lettre::Mailbox to mail_builder::Address.
• Changed AccountConfig::email_reading_headers default values to ["From", "To", "Cc", "Subject"].
• Changed AccountConfig::email_writing_headers default values to ["From", "To", "In-Reply-To", "Cc", "Subject"].
• Removed noise around signature by trimming it.
• Changed Email::parsed return type from mailparse::ParsedMail to mail_parser::Message.
• Changed Email::new_tpl_builder return type from Result<TplBuilder> to NewTplBuilder.
• Renamed Email::to_read_tpl_builder to Email::to_read_tpl which returns now a Result<Tpl> directly.
• Changed Email::to_reply_tpl_builder return type from Result<TplBuilder> to ReplyTplBuilder.
• Changed Email::to_forward_tpl_builder return type from Result<TplBuilder> to ForwardTplBuilder.
• Renamed backend::imap::Error::ListEnvelopesOutOfBounds by BuildPageRangeOutOfBoundsError.
• Replaced [lettre] by [mail-send], [mailparse] by [mail-parser] and [maildir] by [maildirpp].
• Removed native-tls support, rustls-tls is now the only TLS provider available. Removed in consequence native-tls, rustls-tls and rustls-native-certs cargo features.

Fixed

• Fixed notmuch path not being expanded correctly.
• Fixed .notmuch folder created by notmuch new command being treated as a folder. Because it is a folder starting by a dot, it was considered as a Maildir++ folder (which is not).
• Fixed IMAP pagination error when listing envelopes [#76].

pimalaya-email-tpl

Added

• Added parsing template from raw message support. Parsing is done via the TplInterpreter builder, and functions TplInterpreter::interpret_* return the parsed template.

Changed

• Replaced [lettre] by [mail-builder] and [mail-parser].
• Use crate [nanohtml2text] instead of manual html to plain transform using ammonia, html-escape and regex.
• Moved MML stuff in its own mml module, to be as close as what provides the Emacs MML module. The tpl module contains stuff related to template. A template is just an email composed of headers and one unique plain text part. This plain text part can be written in MML.
• Compiler options are now attached to the Tpl structure.