Skip to content

Releases

tmpmail 0.3.5

Choose a tag to compare

@github-actions github-actions released this 13 Nov 12:05

tmpmail 0.3.5 fixes the command-line tool and the shared core: cleaner sender text, read --html with the Firefox snap, inline images from mail.tm, image addresses listed as links, and long mail cut by the provider without a word. It also brings the fixes of a full security review of the code, and waits through provider rate limits.

Fixed

  • Stronger cleaning of the sender's words. Terminal escape sequences are now removed whole (ESC[31mRED printed as [31mRED before; now RED), and besides control characters and bidi overrides, the other invisible format characters go too (U+061C, zero-width spaces, word joiners, the BOM). Zero-width joiners and the tags of emoji flags stay, so emoji still draw as one. A stray ESC goes alone, without the letter after it. This is render::clean and render::clean_line, used by ls, read, watch, the TUI and the desktop app.

  • read --html works with the Firefox snap on KDE. With the Firefox snap, Firefox showed "Access to the file was denied": the copy was written under ~/.local/state/tmpmail/view/, and a snap can't read hidden folders in your home (GNOME got around it by handing the file over through the document portal; KDE doesn't). When the browser that opens the copy is a snap (by --browser, $BROWSER, or the desktop's default for HTML files), tmpmail now writes it to ~/snap/NAME/common/tmpmail-view/, which the snap can always read, still private (0600 in a 0700 folder) and deleted after a day. A snap that has never run has no such folder yet, and tmpmail creates none for it: the copy then goes to the state folder and is handed to the snap with gio launch and its desktop file, which passes it through the document portal, with a warning to start the browser once and run the command again if it still refuses the copy. Without gio or the snap's desktop file the copy is opened from the state folder as before, and the warning says so (and why) instead of naming the portal. The TUI's o does the same.

  • Inline images show in read --html. The copy kept cid: references, which a browser can't load, so inline images (logos, pictures in the text) showed as their alt text. They are now put in the copy as data: URLs: the attachment the provider lists under that name, else the part with that Content-ID in the raw message, where the provider has one (mail.tm, mail.gw, DropMail, Maildrop). mail.tm and mail.gw rewrite an inline image's cid: address in the HTML they hand out to attachment:ID, the id of the attachment they list for it, which no browser knows: tmpmail now reads an image's src="attachment:ID" as the message's own image attachment with that id (only that scheme, only that message's attachments, under the same limits), and --json read shows it as cid:ID. The raw message of mail.tm also leaves out the line break after each part's opening boundary, which the MIME reader now accepts (a boundary followed at once by a Content- header and its colon; nothing else is loosened). Raster images only, up to 10 MiB each. The TUI's o puts them in its copy too, fetched on a thread of their own (the status line says "loading the message's inline images...", and says when some couldn't be loaded), so neither the screen nor the inbox checks wait on them.

  • Image addresses aren't links. A mail's remote images (<img src>, srcset, background=, CSS url(...)) were listed by links, and could be "the best link" of wait --link or the first link of the TUI's L/O and the desktop app: a mail with images and no link at all offered a Google logo. An address the HTML only loads is now left out, also when the text part repeats it, unless the mail also links to it.

  • Long mail from mail.tm isn't cut short. mail.tm and mail.gw cut a message's text and HTML at 100 KiB, mid-line and without a word, so read showed part of a long mail, and a code or link past the cut wasn't found. A body that long is now checked against the raw source, which is whole, and the source's is used. If the source can't be read, the text ends with a note that it may be cut and that read --raw has all of it.

  • wait waits through a rate limit. With the desktop app or the TUI checking the same mail.tm inbox, wait --link exited 3 with "rate limited, try again later" when its first listing was refused. wait, otp --wait and watch now say so once and keep waiting: they ask again after the provider's Retry-After (at most 2 minutes), else after one or two poll intervals, until their own timeout (exit 2), and push wake-ups wait too. Mail that arrives while the first listing is refused counts as new by its date. The desktop app's and the TUI's checks hold back after a rate limit the same way, so they don't keep the provider refusing a wait on the same inbox.

  • In-page links in read --html find their target. href="#section" was kept, but the sanitizer dropped the id and <a name> it points at, so only #top worked. They are kept now, prefixed with mail- so a mail can't reuse a name of the page's own, and the mail's # links are rewritten to match (# stays, and so does #top unless the mail has its own top). The same sanitizer (render::sanitize_mail_html) serves the desktop app.

  • Headers labelled ISO-8859-1 are read as Windows-1252, as browsers do (tempmail.lol's encoded names and subjects): curly quotes and dashes in mislabelled mail show instead of being dropped as control characters.

Security fixes

From a full security review of the code at 0.3.4 (2026-11-01). None was critical or high.

  • A "link" must be a real web address (medium). A mail could put href="http\..\..\Windows\System32\calc.exe" or href="http/../Downloads/verify.html" in a message: the link check only looked at the first four letters, the word "verify" ranked it first, and links --open or the TUI's O handed it to the system opener, which took it for a file path (GNOME's gio open resolves it against the current folder; Explorer starts an executable it is given). A link is now read as a browser reads it (character references decoded, line breaks dropped, spaces and invisible characters escaped) and must then be a whole absolute http:// or https:// URL with a host, without backslashes; links --open and O refuse anything else whatever the list holds. So the TUI's L no longer copies a link with a line break in it, which would run as a second command when pasted in a shell. A link written with &#38; instead of &amp; now works, and an invisible mark right after a link in right-to-left text ends it. The MCP server's get_links and the desktop app take the same list.

  • A snap can't make read --html delete or write files elsewhere (medium). The copies for a snap browser go to ~/snap/NAME/common/tmpmail-view/, which the snap may write in. tmpmail checked that no folder on the way was a link and then worked by path, so a snap swapping its folder for a link at the right moment could make tmpmail delete a file of the same name in another folder (a race the review won in a few views), or create the copy where the link pointed. The folder is now opened one level at a time inside the one before it, refusing links, and the copy is written, listed and deleted inside the open folder only, so a link put there afterwards leads nowhere. If a folder on the way is a link, the copy goes to the state folder with a warning. Copies are now named tmpmail-ID.html, and in a snap's folder only such files (and the ID.html copies of the first builds that wrote there) are pruned, in every snap's tmpmail-view folder through the same open-folder walk, so an earlier browser's copies go too.

  • Dependencies with published advisories updated (medium). rustls 0.23.46 and rustls-webpki 0.103.16 (a certificate chain through the distrusted emSign intermediates, whose keys are public, was accepted where the system still trusts their roots; an unauthenticated ServerHello could downgrade later connections' key exchange), ammonia 4.2.4 (CSS url matched case-sensitively; not reachable with tmpmail's settings), tokio 1.53.3, rustix 1.1.6 (its extended-attribute functions, which tmpmail doesn't call, could mark unwritten bytes as read). A new audit workflow checks Cargo.lock against the RustSec database on every push and every week; the advisories without a fix within semver are listed in deny.toml with their reasons (lru 0.12 through ratatui 0.29, and unmaintained helper crates).

  • Inline images are capped per message (medium, in the desktop app; the same in read --html). A mail with one 9 MB image and a thousand <img src="cid:big.png@N"> tags made the app download the image a thousand times and keep a copy for each name (about 9 GB). Images are now kept by the attachment they resolve to, so any number of names for one attachment fetch it once; at most 64 distinct cid: names are looked up per message, and at most 25 MiB of images are shown for it (64 is far more inline images than real mail carries; 25 MiB is the usual limit of a whole mail at the big mail services). read --html fetches each attachment once too, and its copy holds at most 25 MiB of images however often the mail repeats one.

  • The release workflow is locked down (medium). release.yml, which builds the CLI's archives and pushes the Homebrew formula, used actions by tag (and dtolnay/rust-toolchain by branch) while holding write, attestation and tap-token rights; a moved tag upstream could have attested or published a different binary. Every action in every workflow is now pinned by commit SHA, checkouts keep no credentials, the jobs that compile have a read-only token, and the attestations (of each archive and of SHA256SUMS) are made in the release job, which compiles nothing. The Homebrew tap token is given to the git push alone. A manual run of the workflow, even on a tag, now only builds (before, it published the release and pushed th...

Read more

tmpmail desktop 0.1.4

Choose a tag to compare

@github-actions github-actions released this 13 Nov 12:25

tmpmail desktop 0.1.4 is the first release that is no longer a preview. It fixes dragging
attachments out on X11, inline images in mail.tm mail, a blank window in the AppImage with color
emoji, and a narrow message pane, and it brings the security fixes of a full review of the code.
It is built on the same core as the tmpmail command-line tool 0.3.5, so that release's
fixes reach the app too (cleaner sender text, waiting through provider rate limits, headers
labelled ISO-8859-1 read as Windows-1252), and it shares the tool's inboxes and config.toml.

It works on Fedora, Debian, Ubuntu, Arch and other Linux, on macOS and on Windows. Please report
what breaks: https://github.com/qorvyx/tmpmail/issues.

What's new in 0.1.4

  • Dragging an attachment out works on X11. On Xfce (and other X11 desktops) the drag
    started and the file manager lit up, but nothing landed: the drag code stopped answering
    for the file as soon as the drop was sent, and on X11 the drop target asks for it only
    then. The app now runs the drag with GTK itself and answers until the drag ends; the
    file's address is also properly escaped now (names with spaces or accents).
  • In-page links work in the message. A mail's links to its own sections (#section, a
    table of contents) went nowhere: the sanitizer dropped the id and name they point at,
    and the frame opened every link as a popup. Those are kept now, prefixed so a mail can't
    reuse one of the page's own, and an in-page link moves within the mail.
  • The message list can't be turned around by a sender. A sender name or subject with a
    right-to-left override (U+202E) reversed the rest of its row in the list and in the "New
    mail" notice, so a row could read as another address, and terminal escapes showed as box
    glyphs. The list, the notice, attachment names, links, the code (and the tray's "Copy
    code") and the domain picker are now cleaned in Rust the way the message header and
    notifications already were.
  • Inline images show for mail.tm mail. mail.tm and mail.gw rewrite an inline image's
    cid: address in the HTML they hand out to attachment:ID, the id of the attachment
    they list for it, which no browser knows, so the image showed as its alt text. The app
    now reads an image's attachment:ID as that image attachment of the same message (only
    that scheme, only the message's own attachments, with the usual limits on inline
    images). Where the listing doesn't name a cid: image, the app finds the part with that Content-ID in the
    raw message (mail.tm, mail.gw, DropMail and Maildrop have one), and now also reads
    mail.tm's raw message, which leaves out the line break after each part's boundary.
  • Images aren't offered as links. A mail's remote images were listed under Links, and a
    mail with no link at all showed a Google logo as "the likeliest verification link". An address
    the mail only loads isn't listed now, unless the mail also links to it.
  • The notice about an unknown config.toml key shows. It was sent before the window
    listened, so only the terminal saw it; and a save that changed none of the form's fields
    didn't read the file again, so a key added by hand went unnoticed. Notices are now held
    until the window is ready, and every save reads the file again. Polling restarts only
    when the poll interval, push or the timeout changed. A notice with a long text (a file's
    path) stays up longer, up to 30 s, or until its × closes it.
  • j/k keep the open message in view. Past the last visible row the message opened
    but the list stayed put; it now scrolls just enough to show it. [/] do the same in
    the inbox list.
  • Long mail from mail.tm shows whole. mail.tm cuts a message's text at 100 KiB without
    a word; the app (through the core of CLI 0.3.5) now reads the rest from the raw message,
    or says the text may be cut and that Source has all of it.
  • AppImage: notifications show the logo. Without an installed desktop file they showed
    a generic icon; they now name the logo by a file in the cache folder, which servers that
    go by app_icon show. GNOME takes the header's icon from an installed desktop entry only,
    so there the app hands it the logo as the notification's image instead (the desktop file
    inside the AppImage itself no longer counts as installed, which kept GNOME from getting
    it), and the header shows the logo once the AppImage is integrated. An integrated
    AppImage names its icon as the packages do, so KDE shows the logo once, not twice.
    The window's icon on Wayland also needs the AppImage integrated (AppImageLauncher, Gear
    Lever, or by hand): the README says how.
  • AppImage: color emoji no longer blank the window. The WebKitGTK the AppImage
    carries crashed on COLRv1 color emoji (Fedora's emoji font): an emoji in a subject
    turned the window blank, on every start while that mail was listed. The AppImage now
    leaves COLRv1 fonts out of its own font setup, so those emoji show in black and white
    (or from another color emoji font) instead. The deb and rpm aren't affected.
  • The tray's "Copy code" works right after a start. It offered only codes that arrived
    while the app ran, so after a restart it was greyed out although a code had come minutes
    before. It now also offers the newest code of the last 15 minutes already in an inbox.
  • Documented: what stays on disk after uninstalling, on each system, and how to remove
    it; and the /tmp/appimage_extracted_* folder --appimage-extract-and-run leaves
    behind (the AppImage runtime's doing).
  • A narrow message pane stays readable. With the window tiled to half the screen, the
    sender's name ran over the date and the links were cut to a letter or two. The message
    list now gives way (down to 280 px) so the open message keeps 340 px where it can, the
    sender's address and the date move to their own lines, and a link's address gets up to two
    lines with its buttons under it. The message's header (its buttons, the code, the links,
    the attachments) is no longer squeezed into a short box of its own that hid the Link
    row's buttons: a short pane scrolls as a whole, the body keeps at least half of it, and
    in a narrow pane the view buttons show only their icons.
  • A refused label's reason is in view. In a 1280×800 window the new inbox dialog
    scrolls, and the reason under the label field sat below its visible part; the dialog now
    scrolls to it.
  • Security: a "link" must be a real web address. A mail's href="http\..\setup.exe"
    only started with http, so it was listed as a link; the app's Open already refused it,
    but the list now leaves it out (core of CLI 0.3.5), and the app's opener takes only a
    whole absolute http(s) URL with a host.
  • Security: dependencies with published advisories updated. The TLS stack (rustls
    0.23.46, rustls-webpki 0.103.16, webpki-root-certs 1.0.11: certificates through the
    distrusted emSign intermediates are refused), the HTML sanitizer (ammonia 4.2.4), tokio,
    time 0.3.55 (cookie parsing), quick-xml 0.42 (through plist 1.10) and serde_with 3.21.
    glib 0.18's advisory stays: Tauri 2 needs the GTK 3 bindings, and the app doesn't use the
    affected iterator. Two build tools' advisories stay too (deepmerge has no fixed version;
    minimatch's fix is a new major version a few days old); neither ends up in the app.
  • Security: inline images are capped per message. A mail could name one big
    attachment under a thousand cid: names and make the app fetch and keep it a thousand
    times. Images are now kept by the attachment they are (fetched once), at most 64 names
    are looked up per message, and at most 25 MiB of images are shown for it. An image found
    too big isn't downloaded again when the theme or a view option changes.
  • Security: safer saved names. A suggested name that is a Windows device name (CON,
    NUL, COM1.pdf...) gets a _ in front, a leading - becomes _, trailing dots and
    spaces go, and a long name is cut at 240 bytes keeping its extension. Drag-out files are
    created new, never written through anything already in their place.
  • Security: a mail can't turn its whole body into one link. A link styled
    position:fixed over the whole frame opened the sender's address on any click; inline
    styles now keep only look-and-layout properties (no position, z-index, transform,
    scale...). Relative and
    //host addresses are dropped (with "Load images" on they reached the app's own mail
    scheme), a style loads only https: (and inline) images, and data: stays only as an
    inline picture.
  • Security: hostile mail can't stall the app. HTML past 4 MiB or nested deeper than
    1000 elements (as the HTML parser nests them) is shown as its plain text, under a note,
    instead of being parsed, and codes and links are found in linear time.
  • Security: size limits on provider answers. Raw messages and attachments are read up
    to 64 MiB (JSON answers a little more), and an attachment's download address is used only
    on the provider's own site, so a hostile answer can't fill the memory or send the
    account's token elsewhere.
  • Security: smaller hardening of the app. A mailto: link from a mail is
    rebuilt from its address, subject and body only, so attach= can't prefill a file from
    the disk in mail clients that honored it. A sender's name in a Linux notification's
    title can't carry markup (< and > show as ‹ and ›) for servers that format it.
    The mail and source documents carry their own sandbox and frame-ancestors policy, so
    they are sandboxed wherever they are loaded. Drag-out files left by a crashed run are
    deleted at the next start, never those of another instance still running.
  • Security: saved attachments are marked as downloaded on Windows (Zone.Identifier)
    and macOS (com.apple.quarantine), so the system checks them as it does a browser's.

What's new ...

Read more

tmpmail 0.3.4

Choose a tag to compare

@github-actions github-actions released this 01 Nov 03:27

tmpmail 0.3.4 fixes the small issues the retest of 0.3.3 found: an address named after another inbox's label, a few TUI and error-message details, and MCP tools that ignored misspelled arguments.

Fixed

  • A label keeps picking its inbox. A new or logged-in address whose name part equals another inbox's label (label work, then new -u work, new work@… or login work@…) was accepted, and -i work then matched both. It is now refused before any provider is asked (exit 64, naming the labelled inbox), in new, login, the MCP server's create_inbox, the TUI and the desktop app. A label also wins over a local part in -i, use and drop, so if a provider hands out such a name by chance (a random address, or rotate), the label still picks its own inbox and a warning says how to reach the new one. new ADDRESS for an address that is already stored now keeps its label, as login does.
  • The unknown-domain error reads right. With one provider down, new -d DOMAIN put the other providers' answers inside the unreachable provider's parenthesis (mailgw: unreachable (connection failed: …; the other providers don't offer …)). It now reads mailgw: unreachable (connection failed: …); the other providers don't offer "DOMAIN": …. The exit code (3) and the --json kind (unreachable) are unchanged.
  • The TUI's ? scrolls in a short terminal. At 7 rows it showed the first 5 keys and closed on any key, so the rest couldn't be read. ↑ ↓ (j k), PgUp PgDn and g G now scroll it, its bottom line says which rows are shown (1-5 of 18), and any other key closes it (any key, as before, when every key fits).
  • The TUI's status message no longer runs into the key hints (Ocopied the first link). A hint that doesn't fit next to the message is now left out whole, with at least one space before the message, and ? help is kept as long as it fits.
  • MCP tools refuse arguments they don't know. create_inbox with username instead of user quietly made a random address; every tool ignored unknown arguments. They are now a tool error (isError, kind usage) that names the argument and lists the ones the tool takes, and each tool's schema says "additionalProperties": false. Every argument a tool accepts is listed in its schema, so clients that build calls from it are unaffected.

For library users

  • The unknown-domain error with a provider down is now an Error::Other whose kind() is still unreachable and whose exit_code() is still 3, instead of an Error::Unreachable. Code that matches on Error::Unreachable won't see that one case; match on kind() instead.
  • New: watcher::CreateField and Watcher::refused, used by the desktop app to show which field of the new-inbox dialog was refused.

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.4-x86_64-unknown-linux-musl.tar.gz --repo qorvyx/tmpmail

tmpmail 0.3.3

Choose a tag to compare

@github-actions github-actions released this 01 Nov 02:26

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

tmpmail desktop 0.1.3

Choose a tag to compare

@github-actions github-actions released this 01 Nov 03:35

tmpmail desktop 0.1.3 brings the library fixes of the tmpmail command-line tool 0.3.3 and
0.3.4 that show in the app: decoded sender names and subjects, labels that always pick one
inbox, and a clearer error when a domain isn't offered. (Their TUI and MCP fixes don't apply
to the app.) It is built on the same core as the tmpmail command-line tool (0.3.4) and
shares its inboxes and config.toml.

It works on Fedora, Debian, Ubuntu, Arch and other Linux, on macOS and on Windows. Please
report what breaks: https://github.com/qorvyx/tmpmail/issues.

What's new in 0.1.3

  • Names and subjects show decoded. Mail from tempmail.lol showed encoded sender names
    and subjects such as =?utf-8?q?Zo=C3=AB?= in the message list, the message header and
    notifications; they now read Zoë, as with the other providers (from CLI 0.3.3's core).
  • A label picks one inbox. The new inbox dialog accepted a label another inbox already
    had, or a username that was another inbox's label, and then the CLI's -i LABEL matched
    neither or both. These are now refused before anything is created, with the reason under
    the label or username field; the dialog stays open so you can change it.
  • A clearer error when a domain isn't offered while one provider is down: the
    unreachable provider is named first, then what the others answered.

What's new in 0.1.2

  • Linux: the window shows the tmpmail icon in the title bar and the task switcher. KDE
    on Wayland showed its generic "W" icon, since the window's app ID (tmpmail-gui)
    matched no desktop file; it is now tmpmail, like the desktop file.
  • Linux: clicking a notification brings the window to the front on KDE. The message
    opened, but KWin only flashed the taskbar entry; the app now passes on the activation
    token the notification server sends with the click.
  • Keyboard shortcuts keep working after a click inside the mail. They stopped until
    you clicked elsewhere in the app. Selected mail text is now copied with right-click →
    Copy, since Ctrl+C goes to the app.
  • Linux: notifications are labeled "tmpmail", not "tmpmail-gui", and KDE and GNOME
    list them under the app's notification settings.
  • Linux: in KDE's notification history, use the "View" button to open a message;
    clicking the entry's text does nothing there (Plasma's behavior). The click action is
    now named "Open" for servers that list actions.
  • No more "New mail" notice for the message a notification click just opened: the
    in-app notice for it now goes away; notices about other new mail stay.
  • Linux on Wayland: the window fits the screen. It opened at 1240×780 whatever the
    screen, so on a 1280×800 screen its bottom (Settings' Save button, the toasts) was behind
    KDE's panel: GTK can't read the work area there. It now leaves room for the panels.

What's new in 0.1.1

  • Windows: clicking a notification opens the message, also from the notification
    center after the toast is gone. The installed app shows its own toasts, which launch a
    tmpmail-desktop: link the installer registers; the app restores its window (or starts)
    and opens that inbox and message. Starting the app a second time now brings back the
    one that runs.
  • Opening a message marks it read: the unread dot and the sidebar count update at once,
    and the mark is saved with the inbox, so tmpmail ls and the TUI agree (with CLI 0.3.2).
  • Small screens: the window opens within the screen's work area (it was 1240×780
    whatever the screen), and every dialog keeps its title and buttons in view with a
    scrolling body. Settings' Save button was off-screen on a 720-pixel-high screen.
  • "Live" stays on for mail.tm: the push connection was dropped and redone every 75
    seconds, so "Live" blinked off (after new mail, among other times). It now stays up, and
    a quick reconnect doesn't hide it.
  • Delete confirmations open on "Keep it", not on the red button, so a stray Enter or
    Space right after d or D cancels instead of deleting. Press y (as in the TUI) or
    click the red button to delete.
  • The Windows installer shows the tmpmail icon, header and sidebar instead of NSIS's.

What it does

  • Inboxes at mail.tm, mail.gw, DropMail, Guerrilla Mail, tempmail.lol and Maildrop: create
    one (the first provider that works, or one you pick, with a username and domain where the
    provider allows it, and a label), copy the address, make it the CLI's active inbox, delete
    it.
  • Live mail on the same worker as tmpmail tui (polling, plus push on mail.tm and
    DropMail). New mail is marked New.
  • The verification code in a banner with a Copy button, and the likeliest verification link
    first, each with Open and Copy.
  • A safe HTML preview, in light or dark (mail with its own colors is inverted, with an
    "Original colors" switch). Remote images load only on request, over https only.
  • Attachments: Save, or drag them out on Linux and macOS.
  • Notifications for new mail while the window is in the background, with the code when
    there is one. A click opens the message.
  • An opt-in tray icon (New address, Copy code, Quit) that keeps checking with the window
    closed.
  • A settings screen for the provider order, poll interval, push, request timeout and the
    desktop options.
  • The TUI's keyboard shortcuts (? lists them).

Download

System File
Windows 10/11 (x64) tmpmail-desktop-0.1.3-x64-setup.exe
macOS 10.15+ (Apple silicon and Intel) tmpmail-desktop-0.1.3-universal.dmg
Debian, Ubuntu (x86_64) tmpmail-desktop-0.1.3-amd64.deb
Fedora and other RPM-based (x86_64) tmpmail-desktop-0.1.3-x86_64.rpm
Other Linux (x86_64) tmpmail-desktop-0.1.3-x86_64.AppImage

Check a download against SHA256SUMS, or its build attestation:

gh attestation verify tmpmail-desktop-0.1.3-x86_64.AppImage --repo qorvyx/tmpmail

Installing an unsigned app

The app isn't signed with a paid certificate, so each system warns once.

  • macOS: open the DMG and drag tmpmail to Applications. Open it once: macOS refuses.
    Then go to System Settings → Privacy & Security, click Open Anyway next to the
    message about tmpmail, and enter your password. On macOS 15 (Sequoia) and later,
    Control-click → Open no longer skips this. If you trust the download, xattr -dr com.apple.quarantine /Applications/tmpmail.app does the same from a terminal.
  • Windows: SmartScreen says "Windows protected your PC": click More info, then
    Run anyway. The installer installs for your user only, with no admin prompt, and
    fetches WebView2 if it's missing. If Smart App Control is on, it blocks the installer
    outright with no way past; it can only be turned off as a whole (Windows Security → App &
    browser control).
  • Linux: sudo apt install ./tmpmail-desktop-0.1.3-amd64.deb, or sudo dnf install ./tmpmail-desktop-0.1.3-x86_64.rpm; both pull in WebKitGTK 4.1. The AppImage runs
    as is after chmod +x (it may need libfuse2; without FUSE, run it with
    --appimage-extract-and-run). On NVIDIA, if the window stays blank, start it with
    WEBKIT_DISABLE_DMABUF_RENDERER=1.

Use tmpmail CLI 0.3.2 or later alongside the app. The settings screen can write the
http_timeout key to config.toml, which tmpmail 0.2.0 refuses, and a CLI older than 0.3.2
drops the app's read marks when it rewrites an inbox.

Known limits

  • No auto-update yet: watch the releases page.
  • Windows: no dragging attachments out (a drag can hang the app there); Save works.
  • Linux: the tray needs a StatusNotifier host (stock GNOME needs the AppIndicator
    extension), and clicks on the tray icon itself aren't reported, so everything is in its
    menu. Copying on pure Wayland needs a compositor with clipboard data-control support.
  • macOS: the notification permission prompt and the tray have not been tried on a real
    Mac. An ad-hoc signed app may be asked for permissions again after each update.
  • x86_64 only on Linux and Windows for now.

tmpmail 0.3.2

Choose a tag to compare

@github-actions github-actions released this 31 Oct 12:30

tmpmail 0.3.2 fixes Windows problems, keeps mail.tm's live push connection up, and remembers which messages you've read.

Fixed

  • Windows: colors in the classic console. cmd.exe and the old conhost printed raw escape codes (←[2m … ←[0m). tmpmail now turns on the console's escape-code processing at start, and prints without colors if it can't. Windows Terminal, other terminals and other systems are unchanged.
  • Windows: read --html > out.txt no longer locks out.txt. Explorer (and a browser, the clipboard tool or the notification) inherited tmpmail's redirected output handle, so the next write to that file failed. Children now get only their own standard handles.
  • mail.tm push stayed "live" only 75 seconds at a time. The request timeout ended the push stream 75 s after it started, however busy it was, so it reconnected every 75 s and watch, the TUI and the desktop app showed it as down in between. The stream now stays open as long as mail.tm keeps it (75 s of silence still counts as dead), is renewed every 30 minutes with the inbox's current token, and a stream that was up for a minute or more and drops reconnects after 4 s while the inbox still shows as live.

Changed

  • Opened messages count as read everywhere. read (and read --raw, and the MCP server's read_message), the TUI and the desktop app remember in state.json which messages you opened, so ls (* for unread, seen in --json), the TUI and the app agree, with every provider. In the TUI a message counts as read when you move to it or into its preview, not when the preview opens by itself. Older tmpmail versions ignore the new read list in state.json and drop it when they rewrite an inbox (a token refresh), so the marks of that inbox come back unread.

The desktop app (gui-v0.1.1) is released separately.

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.2-x86_64-unknown-linux-musl.tar.gz --repo qorvyx/tmpmail

tmpmail 0.3.1

Choose a tag to compare

@github-actions github-actions released this 31 Oct 06:11

tmpmail 0.3.1 fixes the Windows binary, which didn't start on a Windows without the Visual C++ runtime.

Fixed

  • Windows: the binary no longer needs the Visual C++ runtime installed. Earlier Windows builds (0.1.x to 0.3.0) stopped at start with "VCRUNTIME140.dll was not found" unless the Visual C++ Redistributable was installed. tmpmail.exe now links the C runtime in, and CI and the release fail if it imports the runtime DLLs again. Other platforms and cargo install are unchanged.

The desktop app in gui/ is not part of this release.

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.1-x86_64-unknown-linux-musl.tar.gz --repo qorvyx/tmpmail

tmpmail 0.3.0

Choose a tag to compare

@github-actions github-actions released this 31 Oct 04:40

tmpmail 0.3.0 no longer refuses to start over a config key it doesn't know, and lets you set the per-request timeout in the config file. One change breaks library users who build Config themselves; the CLI works as before.

Breaking (library only)

  • tmpmail::config::Config is #[non_exhaustive] and has new fields (http_timeout, and private ones for the unknown keys and the file it was read from), so it can no longer be built with a struct literal. Use Config::load() or Config::parse(), or Config::default() and then set fields. CLI users aren't affected.

Changed

  • Unknown config keys are a warning, not an error: a key in config.toml that this version doesn't know (a typo, or one from a newer tmpmail) is ignored with a tmpmail: unknown key … warning on stderr. -q and --json silence it. tmpmail 0.2.0 and earlier refuse such a file. Known keys are still checked strictly: a bad value is an error.

New

  • http_timeout config key: seconds before a single request to a provider gives up (default 20). TMPMAIL_HTTP_TIMEOUT still overrides it.
  • Library: the watcher loop can switch to a new config while it runs (Watcher::set_config); it reports only unknown keys the previous config didn't have.

The desktop app in gui/ is not part of this release.

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. Check it against SHA256SUMS, or verify its build attestation:

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

tmpmail 0.2.0

Choose a tag to compare

@github-actions github-actions released this 31 Oct 03:13

tmpmail 0.2.0 picks a provider from the TUI, works properly on Windows, and is now tested on Linux, macOS and Windows in CI. The crate can also be used as a library.

New

  • Provider picker in the TUI: press N to choose a provider from a list and create an inbox there (no fallback, like tmpmail new -p). Maildrop is marked public. n still creates one with the usual fallback order.
  • Library crate: tmpmail's core (providers, stored inboxes, the watcher loop, mail sanitizing) is available as tmpmail::…. Use tmpmail = { version = "0.2", default-features = false } to leave out the CLI's dependencies (clap, ratatui, qrcode). The API isn't stable yet.

Windows

  • read --html and links --open open the browser through Explorer's default handler when $BROWSER isn't set.
  • watch --notify shows a PowerShell toast notification.
  • Tools such as less and clip.exe are found through PATHEXT (less.exe etc.).
  • The terminal size comes from crossterm, which also works in the Windows console, so long messages open in the pager.
  • With no pager in the config, no $PAGER and no less installed, read prints the message instead of failing.

Under the hood

  • CI runs the tests and an offline run of the release binary on Linux, macOS and Windows, and the daily provider check creates inboxes from all three.
  • The provider check (and scripts/smoke.sh) fails only when every provider is down, since tmpmail falls back to the next one.
  • The crate is split into a core library and the tmpmail binary, behind a default cli feature.
  • The TUI's background polling and push now run on a shared watcher loop (src/watcher.rs), which the upcoming desktop app also uses.
  • The crates.io badge in the README is static, and CI checks that it matches Cargo.toml.

A desktop app is in development in gui/. It is not part of this release.

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. Check it against SHA256SUMS, or verify its build attestation:

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

tmpmail desktop 0.1.2

Choose a tag to compare

@github-actions github-actions released this 31 Oct 22:27

tmpmail desktop 0.1.2 fixes Linux desktop problems found in 0.1.1.
It is built on the same core as the tmpmail command-line tool (0.3.2) and shares its
inboxes and config.toml.

It works on Fedora, Debian, Ubuntu, Arch and other Linux, on macOS and on Windows. Please
report what breaks: https://github.com/qorvyx/tmpmail/issues.

What's new in 0.1.2

  • Linux: the window shows the tmpmail icon in the title bar and the task switcher. KDE
    on Wayland showed its generic "W" icon, since the window's app ID (tmpmail-gui)
    matched no desktop file; it is now tmpmail, like the desktop file.
  • Linux: clicking a notification brings the window to the front on KDE. The message
    opened, but KWin only flashed the taskbar entry; the app now passes on the activation
    token the notification server sends with the click.
  • Keyboard shortcuts keep working after a click inside the mail. They stopped until
    you clicked elsewhere in the app. Selected mail text is now copied with right-click →
    Copy, since Ctrl+C goes to the app.
  • Linux: notifications are labeled "tmpmail", not "tmpmail-gui", and KDE and GNOME
    list them under the app's notification settings.
  • Linux: in KDE's notification history, use the "View" button to open a message;
    clicking the entry's text does nothing there (Plasma's behavior). The click action is
    now named "Open" for servers that list actions.
  • No more "New mail" notice for the message a notification click just opened: the
    in-app notice for it now goes away; notices about other new mail stay.
  • Linux on Wayland: the window fits the screen. It opened at 1240×780 whatever the
    screen, so on a 1280×800 screen its bottom (Settings' Save button, the toasts) was behind
    KDE's panel: GTK can't read the work area there. It now leaves room for the panels.

What's new in 0.1.1

  • Windows: clicking a notification opens the message, also from the notification
    center after the toast is gone. The installed app shows its own toasts, which launch a
    tmpmail-desktop: link the installer registers; the app restores its window (or starts)
    and opens that inbox and message. Starting the app a second time now brings back the
    one that runs.
  • Opening a message marks it read: the unread dot and the sidebar count update at once,
    and the mark is saved with the inbox, so tmpmail ls and the TUI agree (with CLI 0.3.2).
  • Small screens: the window opens within the screen's work area (it was 1240×780
    whatever the screen), and every dialog keeps its title and buttons in view with a
    scrolling body. Settings' Save button was off-screen on a 720-pixel-high screen.
  • "Live" stays on for mail.tm: the push connection was dropped and redone every 75
    seconds, so "Live" blinked off (after new mail, among other times). It now stays up, and
    a quick reconnect doesn't hide it.
  • Delete confirmations open on "Keep it", not on the red button, so a stray Enter or
    Space right after d or D cancels instead of deleting. Press y (as in the TUI) or
    click the red button to delete.
  • The Windows installer shows the tmpmail icon, header and sidebar instead of NSIS's.

What it does

  • Inboxes at mail.tm, mail.gw, DropMail, Guerrilla Mail, tempmail.lol and Maildrop: create
    one (the first provider that works, or one you pick, with a username and domain where the
    provider allows it, and a label), copy the address, make it the CLI's active inbox, delete
    it.
  • Live mail on the same worker as tmpmail tui (polling, plus push on mail.tm and
    DropMail). New mail is marked New.
  • The verification code in a banner with a Copy button, and the likeliest verification link
    first, each with Open and Copy.
  • A safe HTML preview, in light or dark (mail with its own colors is inverted, with an
    "Original colors" switch). Remote images load only on request, over https only.
  • Attachments: Save, or drag them out on Linux and macOS.
  • Notifications for new mail while the window is in the background, with the code when
    there is one. A click opens the message.
  • An opt-in tray icon (New address, Copy code, Quit) that keeps checking with the window
    closed.
  • A settings screen for the provider order, poll interval, push, request timeout and the
    desktop options.
  • The TUI's keyboard shortcuts (? lists them).

Download

System File
Windows 10/11 (x64) tmpmail-desktop-0.1.2-x64-setup.exe
macOS 10.15+ (Apple silicon and Intel) tmpmail-desktop-0.1.2-universal.dmg
Debian, Ubuntu (x86_64) tmpmail-desktop-0.1.2-amd64.deb
Fedora and other RPM-based (x86_64) tmpmail-desktop-0.1.2-x86_64.rpm
Other Linux (x86_64) tmpmail-desktop-0.1.2-x86_64.AppImage

Check a download against SHA256SUMS, or its build attestation:

gh attestation verify tmpmail-desktop-0.1.2-x86_64.AppImage --repo qorvyx/tmpmail

Installing an unsigned app

The app isn't signed with a paid certificate, so each system warns once.

  • macOS: open the DMG and drag tmpmail to Applications. Open it once: macOS refuses.
    Then go to System Settings → Privacy & Security, click Open Anyway next to the
    message about tmpmail, and enter your password. On macOS 15 (Sequoia) and later,
    Control-click → Open no longer skips this. If you trust the download, xattr -dr com.apple.quarantine /Applications/tmpmail.app does the same from a terminal.
  • Windows: SmartScreen says "Windows protected your PC": click More info, then
    Run anyway. The installer installs for your user only, with no admin prompt, and
    fetches WebView2 if it's missing. If Smart App Control is on, it blocks the installer
    outright with no way past; it can only be turned off as a whole (Windows Security → App &
    browser control).
  • Linux: sudo apt install ./tmpmail-desktop-0.1.2-amd64.deb, or sudo dnf install ./tmpmail-desktop-0.1.2-x86_64.rpm; both pull in WebKitGTK 4.1. The AppImage runs
    as is after chmod +x (it may need libfuse2; without FUSE, run it with
    --appimage-extract-and-run). On NVIDIA, if the window stays blank, start it with
    WEBKIT_DISABLE_DMABUF_RENDERER=1.

Use tmpmail CLI 0.3.2 or later alongside the app. The settings screen can write the
http_timeout key to config.toml, which tmpmail 0.2.0 refuses, and a CLI older than 0.3.2
drops the app's read marks when it rewrites an inbox.

Known limits

  • No auto-update yet: watch the releases page.
  • Windows: no dragging attachments out (a drag can hang the app there); Save works.
  • Linux: the tray needs a StatusNotifier host (stock GNOME needs the AppIndicator
    extension), and clicks on the tray icon itself aren't reported, so everything is in its
    menu. Copying on pure Wayland needs a compositor with clipboard data-control support.
  • macOS: the notification permission prompt and the tray have not been tried on a real
    Mac. An ad-hoc signed app may be asked for permissions again after each update.
  • x86_64 only on Linux and Windows for now.