---

Give out x7k2p9qzrm@yourdomain.com instead of your real address. Whatever gets sent to it is parsed, cleaned up, and delivered to you. Torch it when you're done.

Quick start

npm install && npm run setup

Asks which way you want to receive mail, then writes the config file for you. The default path needs no domain, no DNS, and no server.

Two moving parts

A core that generates addresses, tracks who owns them, parses incoming mail, and doesn't care where any of it came from or where it's going. Two things plug into it:

• Where mail comes from. mail.tm (no domain, no server), your own server (SMTP + SQLite), or Cloudflare (Email Routing + D1). The last two run addresses on a domain you own.
• Where mail goes. Discord.

Setup guides

• mail.tm: quickest, no domain or server at all. Read the caveat in that guide first, mail.tm's domain is a known temp-mail domain and some signup forms block it.
• Cloudflare Workers: your own domain, no server to run, just a Cloudflare account.
• Self-hosted: your own machine, your own domain, your own uptime.
• Discord setup: same steps regardless of which of the above you picked. Commands (/new /list /extend /torch) are documented there.

How it works

1. /new generates a random address and ties it to whoever ran the command.
2. Give that address to whatever's asking for an email, a signup form, a newsletter, whatever. Mail sent to it always comes back to you, not wherever you gave it out.
3. Mail arrives. The receiver looks up the owner. Missing, expired, or torched: dropped, no bounce, nothing logged.
4. Valid: the mail gets parsed (HTML to readable text, links intact, attachments forwarded) and delivered.

Daily cleanup clears expired/torched addresses and stale rate-limit rows, on every path.

Limits

• 5 active addresses per owner, 10 day expiry. Both configurable, and /new permanent: true opts a single address out of expiry entirely.
• Message bodies cap at 1500 characters inline, longer gets attached as message.txt.
• Inbound HTML caps at 256KB before parsing (parsing cost scales quadratically with input, and addresses are reachable by anyone who learns one).
• Attachments forward individually up to 25MB combined per email. Over budget gets dropped with a note, not the whole batch.

Code layout and how to add an adapter or backend: docs/architecture.md.

License

MIT. See LICENSE.