Skip to content

teonghan/bulkmailer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Mail-MagiK βœ¨πŸ“§

Mail-MagiK is a Streamlit-based bulk email sender designed for simplicity, magic, and flexibility. Whether you’re sending event invitations, personalized letters, or follow-ups β€” just bring your spreadsheet, design your email with {tags}, and cast the send spell. πŸ§™β€β™€οΈ


✨ Features

  • πŸ“‹ Upload CSV/XLSX of contacts
  • πŸ§‘β€πŸ’Ό Personalize email with {{Name}}, {{CompanyName}}, etc.
  • πŸ–ΌοΈ Add custom headers, footers, images (auto-scaled)
  • 🧾 Preview each email before sending
  • πŸ“Ž Optional PDF link (or embed Drive links as dynamic <a href> HTML)
  • ⏱️ Auto-sleeps 1 second per email to prevent spam detection
  • πŸ’… Fully HTML-formatted content with image width control
  • πŸ’¬ Sidebar controls for layout, sender identity, and subject line

πŸ›  Requirements

  • Python 3.9+
  • Streamlit
  • pandas
  • jinja2
  • beautifulsoup4
  • requests
  • html5lib
  • openpyxl

πŸš€ Getting Started

  1. Clone this repo
git clone https://github.com/your-username/mail-magik.git
cd mail-magik
  1. Create conda environment
conda create -n streamlit python=3.10
conda activate streamlit
pip install -r requirements.txt
  1. Run the app
streamlit run app.py
  1. Send your first magical email!

πŸ’Œ Example Spreadsheet

Email Name Salutation CompanyName PDF Link
alice@acme.com Alice Ms Acme Corp https://drive.google.com/file/d/xyz/view?...

⚠️ Email Setup Note

  • The app uses SMTP login (email + password).
  • If Gmail blocks access, you may need:
    • App Password (if 2FA enabled)
    • Or use another SMTP (like Outlook/Zoho)

πŸ“œ License

MIT License

About

Streamlit-based bulk email sender designed for simplicity.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages