📧 BulkMail - Bulk HTML Email Sending App

A simple yet powerful desktop application built with Python and Tkinter for sending HTML-formatted emails in bulk through Gmail SMTP.

---

✨ Features

• 📬 Bulk email delivery
• 🎨 Beautiful HTML email templates
• ⚙️ Auto-saving configuration
• 📝 Custom subject and description
• 🌐 Website & Telegram button support
• ⏱ Adjustable sending delay
• 📊 Live sending status updates
• 🛑 Start / Stop controls
• 🔄 Queue-based email processing
• ✅ Duplicate tracking with sent history

---

🖥 Preview

The application provides a graphical interface where you can:

• Configure SMTP credentials
• Edit email content
• Set website and Telegram links
• Choose send count
• Monitor sending progress in real time

---

📂 Project Structure

.
├── main.py
├── config.json
├── data.txt
├── sended.txt
└── README.md

File	Description
main.py	Main application
config.json	Saved configuration
data.txt	Email queue
sended.txt	Sent email records

---

🚀 Installation

Clone the repository

git clone https://github.com/rebeccamice2002/bulkmail.git

cd bulkmail

Install requirements

pip install tk

Tkinter is included by default in most Python installations.

---

⚙️ Gmail Setup

To use Gmail SMTP:

0. Go to your Gmail Account Settings.
1. Enable Two-Factor Authentication.
2. Generate an App Password.
3. Use:

SMTP Server: smtp.gmail.com
Port: 587

4. Enter:

Sender Email
App Password

inside the application.

---

📋 Email Queue

Add recipient emails to:

data.txt

Example:

user1@example.com
user2@example.com
user3@example.com

Each line represents one recipient.

---

🎨 HTML Template

The application generates responsive HTML emails with:

• Custom title
• Description section
• Website button
• Telegram button
• Styled modern layout

Example:

🎯 Your Title

Your custom description...

[🌐 Visit Website]

[💬 Join Telegram]

---

🔄 Sending Workflow

Load Emails
     ↓
Validate Address
     ↓
Generate HTML
     ↓
Send via Gmail SMTP
     ↓
Save to sended.txt
     ↓
Remove from Queue

---

📊 Status Indicators

Status	Meaning
✅	Email sent successfully
❌	Sending failed
⏹	Sending stopped
📬	Sending in progress

---

🛠 Technologies Used

• Python 3
• Tkinter
• SMTP
• MIMEText
• Threading
• JSON Configuration

---

⚠️ Configuration Security Reminder

This application stores SMTP credentials and other settings inside config.json.

If you plan to:

• Fork this project
• Push it to GitHub
• Share the source code publicly

make sure your personal config.json is not included in the repository.

A typical .gitignore entry would be:

config.json

Before publishing, remove or replace any:

• Email addresses
• App passwords
• SMTP credentials
• Personal links

with placeholder values.

Example:

{
    "sender_email": "your-email@gmail.com",
    "app_password": "your-app-password"
}

---

📜 License

This project is provided for educational purposes.

Users are responsible for complying with:

• Gmail Terms of Service
• Local anti-spam regulations
• Recipient consent requirements

---

⭐ Contributing

Pull requests and improvements are welcome.

If you find a bug or have a feature suggestion, feel free to open an issue.

---

Made with ☕ Python & Tkinter