FAQ
Why don’t I see images in email previews?
Section titled “Why don’t I see images in email previews?”Inline images are visible in full-screen preview when your terminal supports a raster image protocol. Herald supports iTerm2’s inline image protocol and the Kitty graphics protocol, which is also used by terminals such as Kitty and Ghostty.
Run Herald in a compatible terminal, open a message with inline images, and press z for full-screen preview. You can also force a protocol when testing:
herald --demo -image-protocol=kittyherald --demo -image-protocol=iterm2If your terminal does not support inline graphics, Herald falls back to safe placeholders or local open image links when available. Remote HTML images are shown as links and are not fetched automatically.
Does Herald support multiple accounts?
Section titled “Does Herald support multiple accounts?”Not in a single Herald session yet. Today, each running Herald instance uses one config file, one IMAP/SMTP account, and its own cache path.
You can work around this by running multiple Herald instances with different configs:
herald -config ~/.herald/personal.yamlherald -config ~/.herald/work.yamlKeep the account names and cache paths separate so each instance syncs and sends mail through the intended account.