MailSpoof — v1.1.0
·
4 commits
to main
since this release
MailSpoof v1.1.0 Release Notes
Release Date: 2026-06-06
What's New
Expanded Template Library — 45+ Scenarios
MailSpoof now ships with 45 built-in phishing templates, up from 5 in v1.0.0. New categories include:
- Social Media: LinkedIn, Facebook, Instagram, Twitter/X, TikTok, Snapchat, Pinterest, Reddit, Discord, Twitch, Meta Ads
- SaaS / Cloud: Slack, Zoom, Outlook, Google Workspace, Dropbox, OneDrive, Microsoft Teams, WhatsApp
- Developer Platforms: GitHub OAuth, GitHub SSO, GitLab OAuth, Bitbucket Access, Salesforce MFA
- Consumer Services: Spotify, Netflix, Airbnb, Uber, Amazon, Prime Video, Apple ID
- Financial / Cloud: AWS Root Access, PayPal Invoice, Bank Account Suspension
- HR / BEC: HR Benefits, Overdue Invoice, Payment Authorization CFO
All templates feature realistic HTML layouts, branded imagery, and styled CTA buttons.
Template Management Commands
| Command | Description |
|---|---|
mailspoof preview <id> |
Preview a template body (HTML stripped by default; use --raw for source) |
mailspoof edit-template <id> |
Open a template in $EDITOR (default: nano) with auto-reload after save |
mailspoof remove-template <id> |
Delete custom templates (built-ins are protected) |
mailspoof list --filter <text> |
Search templates by name, category, tags, or body content |
Custom templates are auto-assigned IDs and support {TODAY} date substitution.
SMTP Profile Management
Save and reuse relay configurations with named profiles:
mailspoof profile add gmail --host smtp.gmail.com --port 587 --user me@gmail.com --use-tls
mailspoof test 1 target@example.com --profile gmailmailspoof profile list— Show all saved profilesmailspoof profile add <name>— Save a new profilemailspoof profile remove <name>— Delete a profile
Profiles are stored securely in ~/.mailspoof/config.json.
Verbose Diagnostics
Use --verbose on any send command to see stage-by-stage SMTP output:
mailspoof test 1 target@example.com --verboseOutput includes: connection, STARTTLS, authentication, and send status.
Reporting Improvements
- CSV export:
mailspoof report --format csvgenerates spreadsheet-ready reports - Per-test error details: Failure reasons are now captured in the audit log and CSV output
Desktop Integration
- Linux
.desktopentry with application icon install.shauto-installs icon and launcher on supported desktops- Run MailSpoof directly from your applications menu
Fixes & Improvements
- Installer: Direct pip install (no venv wrapper), supports both system-wide and user installs
- Entry point: Console script correctly routes to
lib.cli:main - Template loading: Built-ins load reliably from
lib/templates/builtins/across all install types - Uninstaller: Inline fallback removes wrappers, config, templates, and pip package cleanly
- Email format: Switched to
multipart/alternativeMIME with HTML + plain text fallback - HTML preview: Terminal preview strips HTML for readable output
- Custom templates: Saved to dedicated
~/.mailspoof/templates/custom/subfolder
Upgrade Instructions
cd /path/to/MailSpoof
bash install.shOr update via Git if installed from source:
mailspoof updateFull Changelog
See CHANGELOG.md for the complete version history.