Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bdr-pro/bulkemailsender
🚀 BulkSender: Email 📧 blast! Secure login 🔐, CSV contacts 📋, Attach files 📁, Gen Z vibes 🌈, Easy peasy! 🤙
https://github.com/bdr-pro/bulkemailsender
csv email email-sender python
Last synced: about 2 months ago
JSON representation
🚀 BulkSender: Email 📧 blast! Secure login 🔐, CSV contacts 📋, Attach files 📁, Gen Z vibes 🌈, Easy peasy! 🤙
- Host: GitHub
- URL: https://github.com/bdr-pro/bulkemailsender
- Owner: BDR-Pro
- Created: 2024-03-12T13:12:13.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2024-05-05T23:28:57.000Z (8 months ago)
- Last Synced: 2024-05-06T00:26:17.219Z (8 months ago)
- Topics: csv, email, email-sender, python
- Language: Python
- Homepage:
- Size: 248 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Bulk Email Sender App 📨
Welcome to the Bulk Email Sender App! This Python script is crafted to streamline the process of sending bulk emails directly from your command line. Whether you're distributing newsletters, job applications, event invitations, or any bulk email, this app simplifies the process, allowing you to send personalized emails efficiently to a list of recipients. It supports attachments and ensures secure login credentials handling through environment variables.
```bash
"""
/\_/\ /\_/\ /\_/\ /\_/\ /\_/\ /\_/\ /\_/\ /\_/\ /\_/\ /\_/\
( o.o )( o.o )( o.o )( o.o )( o.o )( o.o )( o.o )( o.o )( o.o )( o.o )
> ^ < > ^ < > ^ < > ^ < > ^ < > ^ < > ^ < > ^ < > ^ < > ^ <
/\_/\ __ __ _ _ ____ _ /\_/\
( o.o ) | \/ | __ _(_) | / ___| ___ _ __ __| | ___ _ __ ( o.o )
> ^ < | |\/| |/ _` | | | \___ \ / _ \ '_ \ / _` |/ _ \ '__| > ^ <
/\_/\ | | | | (_| | | | ___) | __/ | | | (_| | __/ | /\_/\
( o.o ) |_| |_|\__,_|_|_| |____/ \___|_| |_|\__,_|\___|_| ( o.o )
> ^ < > ^ <
/\_/\ /\_/\ /\_/\ /\_/\ /\_/\ /\_/\ /\_/\ /\_/\ /\_/\ /\_/\
( o.o )( o.o )( o.o )( o.o )( o.o )( o.o )( o.o )( o.o )( o.o )( o.o )
> ^ < > ^ < > ^ < > ^ < > ^ < > ^ < > ^ < > ^ < > ^ < > ^ <
"""
```
## Features 🚀
- **Bulk Emailing**: Send personalized emails to a list of recipients from a CSV file.
- **Email Customization**: Personalize the email subject and body via a JSON file.
- **Attachments**: Attach files to your emails, ideal for documents like resumes or reports.
- **Secure Credential Handling**: Uses environment variables to securely store email login credentials.
- **User-Friendly Interface**: Simple command-line interface for easy operation.
## Prerequisites 📋
Before getting started, ensure you have:
- Python 3.x installed on your computer.
- A `.env` file with your SMTP email credentials (`SENDER_EMAIL` and `SENDER_PASSWORD`).
- The recipient list in a CSV file named `emails.csv`.
- Any attachments you wish to send, accessible in the script's directory.
## Installation 🛠
1. **Clone or Download**: Clone this repository or download the script files to your machine.
2. **Install Dependencies**: Install the required Python packages:
```bash
pip install python-dotenv
```
3. **Setup `.env` File**: Create a `.env` file in the script's directory with your email credentials:
```plaintext
[email protected]
SENDER_PASSWORD=your_email_password
```
## Usage 📝
1. **Prepare Your CSV**: Format your `emails.csv` with one email address per line for the recipients.
2. **Customize Message**: Edit the `template_message.json` to match your email's subject and body.
3. **Set Attachment (Optional)**: Specify the filename of your attachment in the command line.
### Commands
- **Sending Emails**:
```bash
python bulksender.py send -e template.csv -m template_message.json -a attachment.pdf
```
This command will process and send emails according to the specified CSV file and message template, attaching the specified file.
- **Login**:
```bash
python bulksender.py login [email protected]
```
This command securely saves your SMTP credentials for email sending.
## Comand Line Interface 📟
The script provides a user-friendly command-line interface for easy operation. Here's a brief overview of the available commands:
```bash
Welcome to the Email Sender App!
Usage:
python bulksender.py [command]
Commands:
send - Execute the send function of the app.
login - Perform login operation.
Arguments for 'send':
-e
-m
-a
Examples:
python bulksender.py send -e template.csv -m template_message.json -a cv.pdf
python bulksender.py login [email protected]
```
## Contributing 🤝
Contributions are welcome! Feel free to fork the project, make improvements, and submit pull requests. If you encounter issues or have suggestions, don't hesitate to open an issue on GitHub.
## Notes and Best Practices 🔒
- Ensure you have permission to email the recipients and comply with anti-spam laws.
- The script defaults to Gmail's SMTP server; if using another service, adjust the `smtp_server` and `port` accordingly.
- Be mindful of sending limits imposed by your email service provider to avoid service disruptions.
Happy Emailing! 🎉