Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pranjalco/birthday-wisher

This project automates birthday wishes by checking the birthday.csv file for birthdays matching the current date. If found, it picks a random template from letter_templates, replaces [NAME] with the person's name, and uses Python's smtplib to send the email. Perfect for personalized automation!
https://github.com/pranjalco/birthday-wisher

automation communication csv email-automation email-sender file-handling intermediate manipulation programming python random-module

Last synced: 9 days ago
JSON representation

Host: GitHub
URL: https://github.com/pranjalco/birthday-wisher
Owner: pranjalco
License: mit
Created: 2025-01-11T14:08:48.000Z (about 1 month ago)
Default Branch: main
Last Pushed: 2025-01-11T14:12:08.000Z (about 1 month ago)
Last Synced: 2025-01-11T15:25:06.658Z (about 1 month ago)
Topics: automation, communication, csv, email-automation, email-sender, file-handling, intermediate, manipulation, programming, python, random-module
Language: Python
Homepage:
Size: 7.81 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.csv
- License: LICENSE

Awesome Lists containing this project

README

# Project 22: Birthday Wisher

## Author
- **Name**: Pranjal Sarnaik
- **Date**: 03 Jan 2025

## Description
This project automates the process of sending birthday wishes to individuals listed in a CSV file. The program reads the `birthday.csv` file to identify people whose birthdays match the current date. If a match is found, it selects a random letter template from the `letter_templates` folder, replaces the placeholder `[NAME]` with the person's name, and sends an email to their address using Python's `smtplib` module.

## How to Use
1. Ensure the required modules (`datetime`, `pandas`, `random`, `smtplib`) are installed.
2. Place a properly formatted `birthday.csv` file in the project folder. The file should contain the following columns:
- `name`
- `email`
- `year`
- `month`
- `day`
3. Add three letter templates to the `letter_templates` folder with the placeholder `[NAME]` where the recipient's name should appear.
4. Configure the SMTP settings in the `app.py` file to use your email credentials.

## Level
- **Level**: Intermediate
- **Skills**: File handling, CSV manipulation, Email automation, Random module usage
- **Domain**: Automation, Email Communication

## Features
- Reads and processes a `birthday.csv` file to check for birthdays matching the current date.
- Randomly selects a letter template from a folder of predefined templates.
- Dynamically personalizes the letter by replacing placeholders with the recipient's name.
- Sends emails using Python's `smtplib` module.
- Includes a modular structure for easy modification and enhancement.

## Installation
1. Clone this repository:
```bash
git clone https://github.com/pranjalco/mail-merger-simple.git
```
2. Navigate to the project directory:
```bash
cd mail-merger-simple
```

## Running the Program
1. Ensure Python 3.9 or later is installed on your system.
2. To run the program:
- **Using PyCharm**: Open the project in PyCharm and run `app.py`.
- **Using Terminal/Command Prompt**: Navigate to the project folder and execute:
```bash
python app.py
```
- **By Double-Clicking**: You can double-click `app.py` to run it directly, provided Python is set up to execute `.py` files on your system.
3. If the console window closes immediately, run the program from the terminal/command prompt or IDE to see the output.

## File Structure
```
project-folder/
|
├── app.py # Main script to run the program
├── birthday.csv # CSV file containing birthday data
├── letter_templates/ # Folder containing letter templates
│ ├── letter_1.txt
│ ├── letter_2.txt
│ ├── letter_3.txt
├── README.md # Project documentation
```

## Last Modified
- **Modified Dates**: 03 Jan 2025, 06 Jan 2025