Skip to content

tmpmail 0.3.3

Choose a tag to compare

@github-actions github-actions released this 01 Nov 02:26
· 57 commits to main since this release

tmpmail 0.3.3 fixes a TUI crash in short terminals, stale codes from wait --include-existing, undecoded tempmail.lol headers, duplicate labels, lost addresses when copying fails, and a set of smaller error and output fixes.

Fixed

  • The TUI no longer crashes in a short terminal. A terminal (or tmux pane) 7 rows high or less, at start or after a resize, made tmpmail tui panic. It now draws what fits at any size.
  • wait --include-existing takes the newest match. Among the messages already in the inbox, it returned the oldest matching one, so a code from an earlier sign-up try beat the one just resent. The newest now wins (in each inbox with -a); mail arriving during the wait is still taken oldest first. The MCP server's wait_for_message, get_verification_code and get_links, which include existing mail by default, had the same problem.
  • Encoded subjects and senders are decoded. tempmail.lol passed RFC 2047 headers on as they are, so =?utf-8?q?Zo=C3=AB?= showed instead of Zoë in ls, read, --json, the TUI and the desktop app. Headers are now decoded the same way for every provider, and the preview (intro) has no line break at its end.
  • watch --notify escapes markup. On Linux, <, > and & in the subject reached notification servers that read markup (GNOME Shell, KDE Plasma), so a sender could add bold text, links or images, and a Name <address> sender lost its address. They are now escaped when the server reads markup, as the desktop app does.
  • A label picks one inbox. new -l, login -l, the MCP server's create_inbox, the TUI and the desktop app accepted a label another inbox already had (or that was another inbox's local part), and then -i LABEL matched neither. A taken label is now refused before anything is created (exit 64), an ambiguous -i lists the inboxes it matches, rotate --keep moves the label to the new inbox, and logging in again to a stored address keeps its label.
  • new -c and rotate -c keep the address when the clipboard fails. With a failing or missing clipboard tool, the inbox was created (and for rotate, the old one dropped) but the address was never printed and the exit code was 1. The address is now printed first, the failed copy is a warning, and the exit code is 0. rotate drops the old inbox only after the new address is shown.
  • wait --delete is refused before waiting on providers that can't delete messages (DropMail, tempmail.lol), instead of failing after the wait. With -a those inboxes are skipped with a note. --json now always prints one document: a delete that fails after the message was printed is told on stderr, and the exit code still says so.
  • save keeps going past an attachment the provider won't serve (mail.tm refuses names with a /). The others are saved, each failure is reported (failed in --json), and the exit code is the first failure's.
  • ls -a exits with an error when no inbox could be read (3 when their providers are unreachable), instead of 0.
  • Guerrilla Mail images load with read --html --images. Guerrilla points images at its own proxy, which a page opened from a file can't reach; they now point back at each image's own URL.
  • Clearer errors when creating an inbox: new -d maildrop.cc and new NAME@maildrop.cc ask you to add -p maildrop (Maildrop is public, so it's never picked on its own); new foo@ is a usage error instead of a request to every provider; and an unknown domain with one provider down names that provider instead of saying "all providers: unreachable".
  • TMPMAIL_HTTP_TIMEOUT is checked like http_timeout in the config: 0, x or a negative number is now a usage error instead of timing every request out or being ignored. providers = [] in the config is refused instead of quietly meaning the default order.
  • --json usage errors are JSON. A bad value, an unknown option or conflicting options printed clap's text even with --json; they are now {"error":{"kind":"usage",...}} on stdout (exit 64).
  • Smaller fixes: read's hints (tmpmail save ID, read ID --html) include -i ADDRESS when the inbox isn't the active one; qr --json prints {"address": ...}; a Maildrop login shows the same public-inbox warning as new; the TUI's ? lists every key, G stops at the message's last page, and o no longer fills the status line with a cut-off path; shell completions offer the provider ids after -p; man -o DIR names the folder it couldn't write.

Changed

  • tmpmail providers shows raw for the providers that support read --raw (mail.tm, mail.gw, DropMail, Maildrop), and the docs say which ones do.
  • -p checks the provider id while parsing, so an unknown one is refused with the list of known ones (still exit 64); login -p accepts only providers that can log in.

Known issue

  • A new address whose name part equals another inbox's label (label work, then new work@…) is still accepted, and -i work then matches both and asks you to pick (exit 64, listing the addresses). Use the full address, or a different name. Fixed in the next release.

The desktop app is released separately. gui-v0.1.2 was built before these fixes; the next desktop release picks up the header decoding and the label check from this release's library.

Install

cargo install tmpmail
cargo binstall tmpmail           # prebuilt binary, no compiling
brew install qorvyx/tap/tmpmail  # macOS or Linux

Or download a prebuilt binary below: Linux (x86_64, aarch64, fully static), macOS (Intel, Apple silicon) and Windows (x64, no Visual C++ Redistributable needed). Check it against SHA256SUMS, or verify its build attestation:

gh attestation verify tmpmail-0.3.3-x86_64-unknown-linux-musl.tar.gz --repo qorvyx/tmpmail