Repository navigation
Releases
tmpmail 0.3.5
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[31mREDprinted as[31mREDbefore; nowRED), 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 isrender::cleanandrender::clean_line, used byls,read,watch, the TUI and the desktop app. -
read --htmlworks 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 (0600in a0700folder) 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 withgio launchand 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. Withoutgioor 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'sodoes the same. -
Inline images show in
read --html. The copy keptcid: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 asdata:URLs: the attachment the provider lists under that name, else the part with thatContent-IDin the raw message, where the provider has one (mail.tm, mail.gw, DropMail, Maildrop). mail.tm and mail.gw rewrite an inline image'scid:address in the HTML they hand out toattachment:ID, the id of the attachment they list for it, which no browser knows: tmpmail now reads an image'ssrc="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 readshows it ascid: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 aContent-header and its colon; nothing else is loosened). Raster images only, up to 10 MiB each. The TUI'soputs 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=, CSSurl(...)) were listed bylinks, and could be "the best link" ofwait --linkor the first link of the TUI'sL/Oand 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
readshowed 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 thatread --rawhas all of it. -
waitwaits through a rate limit. With the desktop app or the TUI checking the same mail.tm inbox,wait --linkexited 3 with "rate limited, try again later" when its first listing was refused.wait,otp --waitandwatchnow say so once and keep waiting: they ask again after the provider'sRetry-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 awaiton the same inbox. -
In-page links in
read --htmlfind their target.href="#section"was kept, but the sanitizer dropped theidand<a name>it points at, so only#topworked. They are kept now, prefixed withmail-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#topunless the mail has its owntop). 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"orhref="http/../Downloads/verify.html"in a message: the link check only looked at the first four letters, the word "verify" ranked it first, andlinks --openor the TUI'sOhanded it to the system opener, which took it for a file path (GNOME'sgio openresolves 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 absolutehttp://orhttps://URL with a host, without backslashes;links --openandOrefuse anything else whatever the list holds. So the TUI'sLno 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&instead of&now works, and an invisible mark right after a link in right-to-left text ends it. The MCP server'sget_linksand the desktop app take the same list. -
A snap can't make
read --htmldelete 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 namedtmpmail-ID.html, and in a snap's folder only such files (and theID.htmlcopies of the first builds that wrote there) are pruned, in every snap'stmpmail-viewfolder 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
urlmatched 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 newauditworkflow checksCargo.lockagainst the RustSec database on every push and every week; the advisories without a fix within semver are listed indeny.tomlwith 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 distinctcid: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 --htmlfetches 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 (anddtolnay/rust-toolchainby 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 ofSHA256SUMS) are made in the release job, which compiles nothing. The Homebrew tap token is given to thegit pushalone. A manual run of the workflow, even on a tag, now only builds (before, it published the release and pushed th...
tmpmail desktop 0.1.4
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 theidandnamethey 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 toattachment: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'sattachment:IDas 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 acid:image, the app finds the part with thatContent-IDin 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.tomlkey 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/kkeep 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 byapp_iconshow. 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-runleaves
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 withhttp, 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 absolutehttp(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 thousandcid: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:fixedover the whole frame opened the sender's address on any click; inline
styles now keep only look-and-layout properties (noposition,z-index,transform,
scale...). Relative and
//hostaddresses are dropped (with "Load images" on they reached the app's own mail
scheme), a style loads onlyhttps:(and inline) images, anddata: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, soattach=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 ownsandboxandframe-ancestorspolicy, 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 ...
tmpmail 0.3.4
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, thennew -u work,new work@…orlogin work@…) was accepted, and-i workthen matched both. It is now refused before any provider is asked (exit 64, naming the labelled inbox), innew,login, the MCP server'screate_inbox, the TUI and the desktop app. A label also wins over a local part in-i,useanddrop, so if a provider hands out such a name by chance (a random address, orrotate), the label still picks its own inbox and a warning says how to reach the new one.new ADDRESSfor an address that is already stored now keeps its label, aslogindoes. - The unknown-domain error reads right. With one provider down,
new -d DOMAINput the other providers' answers inside the unreachable provider's parenthesis (mailgw: unreachable (connection failed: …; the other providers don't offer …)). It now readsmailgw: unreachable (connection failed: …); the other providers don't offer "DOMAIN": …. The exit code (3) and the--jsonkind (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.↑↓(jk),PgUpPgDnandgGnow 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? helpis kept as long as it fits. - MCP tools refuse arguments they don't know.
create_inboxwithusernameinstead ofuserquietly made a random address; every tool ignored unknown arguments. They are now a tool error (isError, kindusage) 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::Otherwhosekind()is stillunreachableand whoseexit_code()is still 3, instead of anError::Unreachable. Code that matches onError::Unreachablewon't see that one case; match onkind()instead. - New:
watcher::CreateFieldandWatcher::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 LinuxOr 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/tmpmailtmpmail 0.3.3
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 tuipanic. It now draws what fits at any size. wait --include-existingtakes 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'swait_for_message,get_verification_codeandget_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 ofZoëinls,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 --notifyescapes 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 aName <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'screate_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 LABELmatched neither. A taken label is now refused before anything is created (exit 64), an ambiguous-ilists the inboxes it matches,rotate --keepmoves the label to the new inbox, and logging in again to a stored address keeps its label. new -candrotate -ckeep the address when the clipboard fails. With a failing or missing clipboard tool, the inbox was created (and forrotate, 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.rotatedrops the old inbox only after the new address is shown.wait --deleteis refused before waiting on providers that can't delete messages (DropMail, tempmail.lol), instead of failing after the wait. With-athose inboxes are skipped with a note.--jsonnow always prints one document: a delete that fails after the message was printed is told on stderr, and the exit code still says so.savekeeps going past an attachment the provider won't serve (mail.tm refuses names with a/). The others are saved, each failure is reported (failedin--json), and the exit code is the first failure's.ls -aexits 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.ccandnew NAME@maildrop.ccask 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_TIMEOUTis checked likehttp_timeoutin the config:0,xor 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.--jsonusage 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 ADDRESSwhen the inbox isn't the active one;qr --jsonprints{"address": ...}; a Maildroploginshows the same public-inbox warning asnew; the TUI's?lists every key,Gstops at the message's last page, andono longer fills the status line with a cut-off path; shell completions offer the provider ids after-p;man -o DIRnames the folder it couldn't write.
Changed
tmpmail providersshowsrawfor the providers that supportread --raw(mail.tm, mail.gw, DropMail, Maildrop), and the docs say which ones do.-pchecks the provider id while parsing, so an unknown one is refused with the list of known ones (still exit 64);login -paccepts only providers that can log in.
Known issue
- A new address whose name part equals another inbox's label (label
work, thennew work@…) is still accepted, and-i workthen 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 LinuxOr 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/tmpmailtmpmail desktop 0.1.3
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 readZoë, 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 LABELmatched
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 nowtmpmail, 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, sotmpmail lsand 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 afterdorDcancels instead of deleting. Pressy(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/tmpmailInstalling 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.appdoes 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, orsudo dnf install ./tmpmail-desktop-0.1.3-x86_64.rpm; both pull in WebKitGTK 4.1. The AppImage runs
as is afterchmod +x(it may needlibfuse2; 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
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.exeand 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.txtno longer locksout.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(andread --raw, and the MCP server'sread_message), the TUI and the desktop app remember instate.jsonwhich messages you opened, sols(*for unread,seenin--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 newreadlist instate.jsonand 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 LinuxOr 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/tmpmailtmpmail 0.3.1
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.exenow links the C runtime in, and CI and the release fail if it imports the runtime DLLs again. Other platforms andcargo installare 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 LinuxOr 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/tmpmailtmpmail 0.3.0
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::Configis#[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. UseConfig::load()orConfig::parse(), orConfig::default()and then set fields. CLI users aren't affected.
Changed
- Unknown config keys are a warning, not an error: a key in
config.tomlthat this version doesn't know (a typo, or one from a newer tmpmail) is ignored with atmpmail: unknown key …warning on stderr.-qand--jsonsilence 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_timeoutconfig key: seconds before a single request to a provider gives up (default 20).TMPMAIL_HTTP_TIMEOUTstill 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 LinuxOr 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/tmpmailtmpmail 0.2.0
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
Nto choose a provider from a list and create an inbox there (no fallback, liketmpmail new -p). Maildrop is markedpublic.nstill creates one with the usual fallback order. - Library crate: tmpmail's core (providers, stored inboxes, the watcher loop, mail sanitizing) is available as
tmpmail::…. Usetmpmail = { version = "0.2", default-features = false }to leave out the CLI's dependencies (clap, ratatui, qrcode). The API isn't stable yet.
Windows
read --htmlandlinks --openopen the browser through Explorer's default handler when$BROWSERisn't set.watch --notifyshows a PowerShell toast notification.- Tools such as
lessandclip.exeare found throughPATHEXT(less.exeetc.). - The terminal size comes from crossterm, which also works in the Windows console, so long messages open in the pager.
- With no
pagerin the config, no$PAGERand nolessinstalled,readprints 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
tmpmailbinary, behind a defaultclifeature. - 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 LinuxOr 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/tmpmailtmpmail desktop 0.1.2
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 nowtmpmail, 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, sotmpmail lsand 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 afterdorDcancels instead of deleting. Pressy(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/tmpmailInstalling 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.appdoes 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, orsudo dnf install ./tmpmail-desktop-0.1.2-x86_64.rpm; both pull in WebKitGTK 4.1. The AppImage runs
as is afterchmod +x(it may needlibfuse2; 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.