Skip to content

TediTae/birthday-email-automation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“« Birthday Email Automation

  • Automatically send personalized birthday wishes via email using Python, CSV data, and pre-written letter templates.

πŸ“Œ Features

  • Reads birthday data from a CSV file.
  • Matches today’s date with birthdays.
  • Picks a random letter template and personalizes it.
  • Sends a custom email through SMTP (e.g., Gmail, Yahoo).
  • Simple, lightweight, and easy to configure.

πŸ› οΈ Requirements

  • Python 3.x
  • pandas
  • smtplib (built-in)

πŸ“ Project Structure

  • β”œβ”€β”€ birthdays.csv
  • β”œβ”€β”€ main.py
  • β”œβ”€β”€ letter_templates
  • β”‚ β”œβ”€β”€ letter_1.txt
  • β”‚ β”œβ”€β”€ letter_2.txt
  • β”‚ └── letter_3.txt

πŸš€ Usage

  1. Place your birthdays.csv file in the project root.
  2. Add at least one or desired amount of birthday template in /letter_templates (need to modify random.randint(1,3) part of code if you desided to change amount of letters).
  3. Run the script: main.py

πŸ“¬ Future Improvements

  • Add support for multiple emails per day.
  • Schedule script to run daily via cron or Windows Task Scheduler.
  • Add GUI interface for non-technical users.
  • Telegram or Discord bot integration for notifications.

πŸ§‘β€πŸ’» Connection

About

A Python script that reads birthday data from a CSV file and automatically sends personalized birthday emails using pre-written templates.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages