Displays a nicely formatted report in your terminal from a DMARC XML report.
This works best when installed with uv tool or pipx.
# With uv:
uv tool install dmarc-report
# Or with pipx:
pipx install dmarc-reportYou can also run the tool without installing it:
# With uvx:
uvx dmarc-report long-dmarc-report-filename.xmlRun the dmarc-report command-line utility followed by a DMARC report file.
The DMARC report can have one of the following file extensions:
.xml.gz.zip.xml
dmarc-report long-dmarc-report-filename.xml.gz
# or
dmarc-report long-dmarc-report-filename.xml
# or
dmarc-report long-dmarc-report-filename.zipNote: if using a zip file, it will only parse the first xml file found in the zip file.
You'll see a nicely formatted report in your terminal:
╭────────────────────────── DMARC Report for example.com ──────────────────────────╮
│ DMARC Policy Details │
│ ╭───────────────────────┬──────────────────────────────────────────────────────╮ │
│ │ Domain: │ example.com │ │
│ │ DKIM Alignment: │ r │ │
│ │ SPF Alignment: │ r │ │
│ │ Policy: │ quarantine │ │
│ │ Subdomain Policy: │ quarantine │ │
│ │ Percent: │ 100% │ │
│ ╰───────────────────────┴──────────────────────────────────────────────────────╯ │
│ DMARC Report Metadata │
│ ╭───────────────────────┬──────────────────────────────────────────────────────╮ │
│ │ Org name: │ Google, Inc. │ │
│ │ Email: │ noreply-dmarc-support@google.com │ │
│ │ Extra contact info: │ https://support.google.com/a/answer/2466580 │ │
│ │ Report ID: │ 1234567890 │ │
│ │ Date range: │ 2020-01-01 00:00:00 UTC to 2020-01-01 23:59:59 UTC │ │
│ ╰───────────────────────┴──────────────────────────────────────────────────────╯ │
│ Summary │
│ ╭───────────────────────┬──────────────────────────────────────────────────────╮ │
│ │ Total Messages: │ 2 │ │
│ │ Unique Sources: │ 1 │ │
│ │ DMARC Pass Rate: │ 100.0% │ │
│ │ DKIM Alignment: │ 100.0% │ │
│ │ SPF Alignment: │ 100.0% │ │
│ ╰───────────────────────┴──────────────────────────────────────────────────────╯ │
│ Message Records │
│ ╭─────────────┬───────┬──────────────┬─────────────┬───────────────────────────╮ │
│ │ Source IP │ Count │ DKIM Aligned │ SPF Aligned │ Authentication Results │ │
│ ├─────────────┼───────┼──────────────┼─────────────┼───────────────────────────┤ │
│ │ 123.0.456.1 │ 2 │ pass │ pass │ dkim: example.com (pass) │ │
│ │ │ │ │ │ spf: example.com (pass) │ │
│ ╰─────────────┴───────┴──────────────┴─────────────┴───────────────────────────╯ │
╰──────────────────────────────────────────────────────────────────────────────────╯