Professional Bulk Email Campaign Management System 🚀
Streamline your email marketing campaigns with enterprise-grade bulk email management ✨
BulkMail Pro is a powerful Flask-based web application designed to revolutionize your email marketing campaigns. Built with scalability and user experience in mind, it provides a comprehensive solution for managing bulk email operations with professional-grade features.
- Secure Login System: Robust user authentication with session management
- User Registration: Easy signup process with email verification
- Password Reset: Secure password recovery functionality
- Role-Based Access: Admin and user privilege management
- User Management: Complete control over user accounts and permissions
- Activity Monitoring: Real-time tracking of user actions and system events
- Email Analytics: Comprehensive logs of all email campaigns and delivery status
- System Oversight: Monitor application performance and usage statistics
- SMTP Configuration: Custom SMTP settings for each user account
- Bulk Email Sending: Efficient processing of large email lists
- File Upload Support: Extract email addresses from text files automatically
- Campaign Tracking: Monitor email delivery status and engagement metrics
- File Management: Automatic cleanup of temporary uploads
- Activity Logging: Detailed audit trail of all user actions
- Database Management: SQLite integration with migration support
- Environment Configuration: Secure handling of sensitive credentials
- Python 3.7 or higher
- pip package manager
- Git
# 1️⃣ Clone the Repository
git clone https://github.com/khaliduzzamantanoy/bulkmail.git
cd bulkmail
# 2️⃣ Set Up Virtual Environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# 3️⃣ Install Dependencies
pip install -r requirements.txtCreate a .env file in the root directory:
# 🔑 Security Configuration
SECRET_KEY=your-super-secret-key-here
# 📧 SMTP Settings
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587
SMTP_EMAIL=your-email@gmail.com
SMTP_PASSWORD=your-app-password
# 🗄️ Database Configuration (Optional)
DATABASE_URL=sqlite:///instance/users.db# Initialize database migrations
flask db init
# Create initial migration
flask db migrate -m "Initial migration"
# Apply migrations to database
flask db upgrade# Start the development server
python app.py🌐 Access your application at: http://localhost:5000
| Step | Action | Description |
|---|---|---|
| 1️⃣ | Access Application | Navigate to http://localhost:5000 |
| 2️⃣ | Create Account | Register a new user account |
| 3️⃣ | Configure SMTP | Set up your email server settings in /account |
| 4️⃣ | Upload Email List | Upload .txt file with email addresses |
| 5️⃣ | Send Campaign | Launch your bulk email campaign |
Access the admin dashboard at /admin to:
- 👥 Manage user accounts and permissions
- 📊 View detailed activity logs
- 📧 Monitor email campaign performance
- 🔍 Analyze system usage statistics
flowchart TD
A[📁 Upload Email List] --> B[⚙️ Configure SMTP]
B --> C[✍️ Compose Email]
C --> D[🚀 Send Campaign]
D --> E[📊 Monitor Results]
E --> F[📈 View Analytics]
style A fill:#e3f2fd
style F fill:#f3e5f5
Create a .txt file with one email address per line:
user1@example.com
user2@example.com
user3@example.com
marketing@company.com| Component | Technology | Purpose |
|---|---|---|
| 🐍 Backend | Flask | Web framework and API |
| 🗄️ Database | SQLite | Data storage and management |
| 🎨 Frontend | HTML/CSS/JS | User interface |
| SMTP | Email delivery system | |
| 🔐 Authentication | Flask-Login | Session management |
| 📊 Migration | Flask-Migrate | Database versioning |
📮 Popular SMTP Configuration Examples
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587
SMTP_EMAIL=your-email@gmail.com
SMTP_PASSWORD=your-app-passwordSMTP_SERVER=smtp-mail.outlook.com
SMTP_PORT=587
SMTP_EMAIL=your-email@outlook.com
SMTP_PASSWORD=your-passwordSMTP_SERVER=smtp.mail.yahoo.com
SMTP_PORT=587
SMTP_EMAIL=your-email@yahoo.com
SMTP_PASSWORD=your-app-password- 🔑 Use strong, unique SECRET_KEY
- 🚫 Never commit
.envfile to version control - 🔐 Use app-specific passwords for email providers
- 🛡️ Enable 2FA on email accounts
- 📊 Regularly monitor activity logs
☁️ Deploy to Heroku
# Install Heroku CLI and login
heroku login
# Create new Heroku app
heroku create your-bulkmail-app
# Set environment variables
heroku config:set SECRET_KEY=your-secret-key
heroku config:set SMTP_SERVER=smtp.gmail.com
heroku config:set SMTP_PORT=587
heroku config:set SMTP_EMAIL=your-email@gmail.com
heroku config:set SMTP_PASSWORD=your-password
# Deploy application
git push heroku main
# Run database migrations
heroku run flask db upgrade🔧 Docker Configuration
FROM python:3.9-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
EXPOSE 5000
CMD ["gunicorn", "--bind", "0.0.0.0:5000", "app:app"]We welcome contributions from the community! 🌟
# 1. 🍴 Fork the repository
# 2. 📥 Clone your fork
git clone https://github.com/YOUR_USERNAME/bulkmail.git
# 3. 🌿 Create feature branch
git checkout -b feature/YourFeatureName
# 4. ✨ Make your changes
# 5. 💾 Commit changes
git commit -m 'Add some feature'
# 6. 🚀 Push to branch
git push origin feature/YourFeatureName
# 7. 🎉 Open a pull request- 🐛 Bug Reports: Use issue templates with detailed descriptions
- ✨ Feature Requests: Discuss new features in issues first
- 📝 Code Style: Follow PEP 8 guidelines
- 🧪 Testing: Add tests for new functionality
- 📖 Documentation: Update docs for any changes
This project is licensed under the MIT License 📜
Feel free to use, modify, and distribute this project ✨
- 🔐 Store all sensitive credentials in environment variables
- 🚫 Never hardcode passwords or API keys in source code
- 🛡️ Use HTTPS in production environments
- 📊 Regularly audit activity logs for suspicious behavior
- 🚀 Use Gunicorn or uWSGI for production deployment
- 🌐 Deploy on reliable platforms (Heroku, AWS, DigitalOcean)
- 💾 Implement regular database backups
- 📈 Set up monitoring and logging systems
- 💾 Backup Location:
instance/users.db - 🔄 Migration Commands: Use Flask-Migrate for schema changes
- 📊 Monitoring: Check database size and performance regularly
| 📞 Support Channel | 🔗 Link | 📝 Description |
|---|---|---|
| 🐛 Issues | GitHub Issues | Bug reports and technical issues |
| 💡 Discussions | GitHub Discussions | Feature requests and general questions |
| Contact | Direct support for urgent issues |
⭐ If this project helped you, please give it a star!
Made with ❤️ by Khaliduzzaman Tanoy
BulkMail Pro - Professional Email Marketing Made Simple 📧