diff --git a/Projects/1-Beginner/Automated-Birthday-Mail-Sender.md b/Projects/1-Beginner/Automated-Birthday-Mail-Sender.md new file mode 100644 index 00000000..28fa01f1 --- /dev/null +++ b/Projects/1-Beginner/Automated-Birthday-Mail-Sender.md @@ -0,0 +1,34 @@ +# Automated Birthday Mail Sender +**Tier:** 1-Beginner + +## Description +This application automatically sends personalized birthday emails to your contacts. Users maintain a CSV file with names, birthdays, and email addresses. The app checks for birthdays daily and sends emails using customizable templates, while storing email credentials securely via environment variables. + +## Purpose +To automate the process of remembering and sending birthday wishes, saving time and ensuring personalized messages for friends, family, or colleagues. + +## Resources Needed +- Python 3 +- CSV file with contact information (name, month, day, email) +- Access to an email account (Gmail, Outlook, Yahoo, etc.) with SMTP enabled +- `smtplib` and `email` Python libraries + +## User Stories +- [ ] User can add contacts and their birthdays in a CSV file. +- [ ] User can create and customize email templates for birthday wishes. +- [ ] User can store email credentials securely using environment variables. +- [ ] User can send personalized birthday emails automatically on the correct date. +- [ ] User can choose the SMTP provider and port for sending emails. + +## Bonus Features +- [ ] User can schedule emails in advance or set recurring reminders for anniversaries or other special events. +- [ ] User can integrate with calendar APIs to automatically fetch birthdays. +- [ ] User can add a GUI interface for managing contacts and templates. + +## Useful Links and Resources +- [Python CSV Documentation](https://docs.python.org/3/library/csv.html) +- [Python `smtplib` Documentation](https://docs.python.org/3/library/smtplib.html) +- [Environment Variables in Python](https://www.geeksforgeeks.org/how-to-use-environment-variables-in-python/) + +## Example Projects +- [Birthday Reminder App – GitHub](https://github.com/nagapraneethk/birthday-reminder) diff --git a/README.md b/README.md index 2d209743..269c5808 100644 --- a/README.md +++ b/README.md @@ -43,6 +43,7 @@ required to complete them. | Name | Short Description | Tier | | --------------------------------------------------------------------------------- | ---------------------------------------------------------- | ---------- | +| [Automated Birthday Mail Sender](./Projects/1-Beginner/Automated-Birthday-Mail-Sender.md) | Automatically sends personalized birthday emails using Python | 1-Beginner | | [Bin2Dec](./Projects/1-Beginner/Bin2Dec-App.md) | Binary-to-Decimal number converter | 1-Beginner | | [Border Radius Previewer](./Projects/1-Beginner/Border-Radius-Previewer.md) | Preview how CSS3 border-radius values affect an element | 1-Beginner | | [Calculator](./Projects/1-Beginner/Calculator-App.md) | Calculator | 1-Beginner |