MADDR(1)

📦 version 1.4, in alpine 3.24, debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💌 maddr — extract mail addresses from messages

okay bestie, gather round, because maddr is literally the little gremlin that digs through your mail and pulls out every single address like it's collecting Pokémon 💅

✨ SYNOPSIS ✨

maddr [-ad] [-h headers] [msgs ...]

🌸 DESCRIPTION 🌸

maddr prints, separated by newlines, all the mail addresses it finds in the headers of the msgs you hand it. no cap. every single one, one per line, clean and cute 🎀

(if you're wondering how the whole message argument thing works, that's mmsg(7)'s whole gig — go check it.)

so here's the vibe check on where it gets its input:

  • if you don't give it any msgs and you're using it interactively, maddr just operates on the current sequence by default. iconic, effortless, it just knows.
  • otherwise, it reads filenames from the standard input. so pipe it, redirect it, do whatever, it's flexible like that 🦋

and now, the options, because obviously there are options:

  • -a — only print the addr-spec address, not the display name. so you get the someone@somewhere part and nothing else. just the facts, ma'am 💅
  • -d — only print the display name. no address, just the name. the opposite of -a, and yes you could technically use both, we don't make the rules (well, the manpage kind of does, but whatever) 🙈
  • -h headers — only search this colon-separated list of headers for mail addresses. the default is from:sender:reply-to:to:cc:bcc: and their respective resent- variants, if any. so yes, it's already looking in all the right places, this is just if you're feeling particular ✨

🔥 OPTIONS 🔥

recapping because you deserve the full menu:

  • -a — only print the addr-spec address, not the display name.
  • -d — only print the display name.
  • -h headers — only search the colon-separated list of headers for mail addresses. Default: from:sender:reply-to:to:cc:bcc: and their respective resent- variants, if any.

💀 EXIT STATUS 💀

maddr exits 0 on success, and >0 if an error occurs.

so like, 0 means we ate and left no crumbs 👑, anything above that means something went sideways and you should probably look at it.

🫶 SEE ALSO 🫶

💖 AUTHORS 💖

Leah Neukirchen <leah@vuxu.org> — the icon, the legend, the moment 🌟

🌈 LICENSE 🌈

maddr is in the public domain. periodt. 💅

to the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work.

http://creativecommons.org/publicdomain/zero/1.0/

okay that's the whole thing bestie, you're fully caught up 💜 this page came from the Debian folks and it's dated March 30, 2020 — sending you off with that, mwah 🎀✨

📦 where this page comes from