# Bulk Sender Randomizer
A powerful email sending application with a modern dark-themed UI built using Python and Tkinter. This application provides comprehensive features for managing and sending bulk emails with customizable templates and settings.
## Features
### 1. Email Management
- **Email List Management**: Manage recipient email lists with duplicate removal
- **SMTP Server Configuration**: Support for multiple SMTP servers with format `host|port|user|password`
- **Custom Headers**: Add and manage custom email headers
- **From Names**: Customize sender names and information
- **Subject Lines**: Manage and customize email subject lines
- **Links Management**: Store and manage links to be used in emails
### 2. Template System
- **HTML Template Management**: Create, edit, and manage multiple HTML email templates
- **Template Enable/Disable**: Ability to enable or disable specific templates
- **Template Generation**: AI-powered template generation using Gemini API (Coming Soon)
- **Visual Customization**: Customize templates with various design options:
- Visual styles and themes
- Color palettes
- Typography (headings and body text)
- Button styles
- Border styles
- Shadow effects
- Layout options
### 3. AI-Powered Content Generation
- **Smart Subject Line Generation**:
- Generate context-aware subject lines based on template content
- Customizable length (min/max characters)
- Support for keyword inclusion and exclusion
- Language matching with template
- Maintains consistent tone and style
- **Intelligent From Name Generation**:
- Generate sender names that match template context
- Department and service-based name generation
- Language and style matching with template
- Customizable length and format
- Keyword filtering options
- **AI Email Body Generation**:
- Generate complete responsive HTML email templates
- Content rewriting with adjustable intensity levels
- Style customization options:
- Visual style and aesthetics
- Tone and voice
- Color schemes
- Typography variations
- Button and border styles
- Shadow effects
- Layout options (Center, Left, Right, Full Width, Multi-column)
- Custom prompt support for fine-tuned generation
- Language and context preservation
- Support for multiple design variations
### 4. Dynamic Content Tags
- **Smart Tag Replacement**: Automatic replacement of template tags with dynamic content:
- `##email##`: Recipient's email address
- `##name##`: Extracted name from email
- `##link##`: Random link from links.txt
- `##random_number##`: Random number generation
- `##random_string##`: Random string generation
- `##time##`: Current time
- `##date##`: Current date
- `##date&time##`: Current date and time
### 5. Sending Features
- **Multiple Sending Modes**:
- Fast Mode: Multi-threaded sending with customizable thread count
- Slow Mode: Sequential sending with customizable delays
- **Sending Order Options**:
- Random order
- Sequential order
- **Attachment Support**: Ability to attach files to emails
- **Progress Tracking**: Real-time progress monitoring
- **Error Handling**: Robust error handling and retry mechanism
### 6. User Interface
- **Modern Dark Theme**: Easy on the eyes with professional dark mode
- **Multi-tab Interface**:
- Settings management
- Template management
- Console output
- **Real-time Console**: Live feedback on sending process
- **File Management**: Built-in file browser and management tools
### 7. Additional Features
- **Duplicate Removal**: Automatic removal of duplicate entries
- **Email Validation**: Built-in email address validation
- **Custom Tag Support**: Support for custom tags in templates
- **Backup System**: Automatic saving of settings and templates
## File Structure
```
├── main.py # Main application entry point
├── sender_logic.py # Core email sending logic
├── tkinter_ui.py # UI components and layout
├── ai_app_generator.py # AI-powered template generation
├── ai_gen.py # AI-powered subject and name generation
├── dark_theme.py # Dark theme implementation
├── tag_manager.py # Template tag management
├── settings/ # Configuration files
│ ├── emails.txt # Recipient email list
│ ├── smtps.txt # SMTP server configurations
│ ├── subjects.txt # Email subject lines
│ ├── froms.txt # Sender information
│ ├── links.txt # Link management
│ ├── headers.txt # Custom email headers
│ └── proxys.txt # Proxy configurations
└── templates/ # Email HTML templates
```
## Requirements
- Python 3.x
- Required packages (see requirements.txt)
- Google API Key (for AI generation features)
## Setup
1. Install required packages:
```bash
pip install -r requirements.txt
```
2. Create a `.env` file and add your Google API key:
```
GOOGLE_API_KEY=your_api_key_here
```
3. Run the application:
```bash
python main.py
```
## Usage
### Basic Configuration
1. Add recipient emails to `settings/emails.txt`
2. Configure SMTP servers in `settings/smtps.txt`
3. Add subject lines to `settings/subjects.txt`
4. Configure sender information in `settings/froms.txt`
5. Add custom headers in `settings/headers.txt` (optional)
6. Add links in `settings/links.txt` (optional)
### Using AI Generation
1. **Generate Email Body**:
- Input your base content
- Choose style customization options
- Set content change intensity (1-10)
- Add custom prompts if needed
- Click "Regenerate" to create new version
- Preview and edit the generated HTML
- Save or copy the final version
2. **Generate Subject Lines**:
- Select a template as the base
- Set minimum and maximum length
- Add required keywords (optional)
- Add excluded keywords (optional)
- Generate multiple subjects matching template style
3. **Generate From Names**:
- Choose a template for context
- Set length parameters
- Include specific keywords if needed
- Exclude unwanted terms
- Generate department/service-style names
### Sending Emails
1. Select sending mode (fast/slow)
2. Configure mode-specific settings:
- Fast Mode: Set thread count and sending order
- Slow Mode: Set delay between sends
3. Enable desired templates
4. Click Start to begin sending process
### Template Management
1. Create new templates using the built-in editor
2. Enable/disable templates as needed
3. Use the template generator for AI-assisted creation
4. Customize template design using available options
## Security Notes
- Store sensitive information (SMTP credentials, API keys) securely
- Use environment variables for API keys
- Avoid hardcoding credentials in templates or settings
## Contributing
Feel free to submit issues and enhancement requests.
## License
This project is licensed under the MIT License - see the LICENSE file for details. or contact me https://t.me/Dexter_naz
