SevMail 0.1.0

SevMail is a secure, developer-centric CLI tool for sending emails using Markdown, your own editor, and Gmail App Passwords — with a strong focus on transparency, auditability, and security awareness.

It is designed for people who prefer control, clarity, and minimalism over heavy GUIs.

---

✨ Why SevMail exists

Most email tools today are:

• GUI-heavy
• opaque in behavior
• hard to audit
• unsafe for automation or scripting

SevMail takes a different approach:

• ✍️ Write emails in Markdown
• 🧠 Use your own editor
• 🔐 Authenticate using Gmail App Passwords
• 🧾 Keep local HTML logs of sent emails
• 🚨 Receive security alerts when accounts are added or removed

No background tracking.
No silent behavior.
Everything happens only when you explicitly run a command.

---

🚀 Features

• Markdown-based emails

  • Plain text + HTML multipart emails
  • Fenced code blocks, lists, formatting supported

• Editor-first workflow

  • Write emails in .md files
  • No embedded editors or GUIs

• Secure account management

  • Gmail App Password authentication
  • Passwords stored securely using system keyring
  • No environment variables required

• Security notifications

  • Email alerts when:
    • an account is added
    • an account is removed
  • Includes device information:
    • username
    • hostname
    • local IP
    • public IP (best-effort)
    • OS, architecture, Python version

• Audit logs

  • Optional HTML logs of sent emails
  • Timestamped and organized by date
  • Useful for record-keeping and verification

• Multiple account support

  • Add, list, remove sender accounts
  • Explicit --from selection

---

📦 Installation

git clone https://github.com/goursahil/sevmail.git
cd sevmail
pip install -r requirements.txt

Required Python version: 3.10+

---

🔐 Gmail App Passwords

SevMail uses Gmail App Passwords.

1. Enable 2-Step Verification on your Google account
2. Create an App Password:
   https://myaccount.google.com/apppasswords

Never share your App Password with anyone.

---

🧑‍💻 Usage

Add an account

sevmail --add-account your_email@gmail.com

List accounts

sevmail --accounts list

Remove an account

sevmail --accounts remove your_email@gmail.com

Generate a template

sevmail --gen empty .

Send an email

sevmail --send-template email.md --from your_email@gmail.com

With CC:

sevmail --send-template email.md --from your_email@gmail.com --cc cc.txt

Save an HTML log

sevmail --send-template email.md --from your_email@gmail.com --save

Logs are saved under:

log/YYYY/MM/DD/HH_MM_SS.html

---

🛡️ Security Philosophy

SevMail is intentionally designed to:

• Avoid background monitoring
• Avoid hidden network calls
• Avoid silent account usage
• Notify account owners of sensitive actions
• Keep all data local and user-controlled

---

📄 License

SevMail License – Source Available

Copyright (c) 2026 Sevrus

This project is source-available, not open source. See the LICENSE file for details.

---

🔮 Future Plans

• Predefined email templates
• User-defined email templates
• Template variables
• Preview mode
• Optional default sender
• Improved logging UI

---

🤝 Final Note

SevMail is built to be calm, predictable, and respectful of users.