{"id":19880022,"url":"https://github.com/adeeteya/automatic-excel-email-bot","last_synced_at":"2026-06-08T02:32:59.285Z","repository":{"id":111605554,"uuid":"368114877","full_name":"adeeteya/Automatic-Excel-Email-Bot","owner":"adeeteya","description":"A Python bot which automatically emails students their marks individually directly from an excel sheet","archived":false,"fork":false,"pushed_at":"2025-06-11T22:54:47.000Z","size":9,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-11T23:40:58.044Z","etag":null,"topics":["automation","bot","email","excel","python","python3","smptlib"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adeeteya.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-05-17T08:41:39.000Z","updated_at":"2025-06-11T22:54:51.000Z","dependencies_parsed_at":"2023-03-07T10:30:39.549Z","dependency_job_id":null,"html_url":"https://github.com/adeeteya/Automatic-Excel-Email-Bot","commit_stats":null,"previous_names":["adeeteya/automatic-excel-email-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/adeeteya/Automatic-Excel-Email-Bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adeeteya%2FAutomatic-Excel-Email-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adeeteya%2FAutomatic-Excel-Email-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adeeteya%2FAutomatic-Excel-Email-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adeeteya%2FAutomatic-Excel-Email-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adeeteya","download_url":"https://codeload.github.com/adeeteya/Automatic-Excel-Email-Bot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adeeteya%2FAutomatic-Excel-Email-Bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34046003,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","bot","email","excel","python","python3","smptlib"],"created_at":"2024-11-12T17:10:01.219Z","updated_at":"2026-06-08T02:32:59.280Z","avatar_url":"https://github.com/adeeteya.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📧 Automatic Email Sending Bot\n\nA Python-based email automation tool designed to send **individualized emails** using recipient data from an Excel sheet. Commonly used by professors to privately share grades with students, ensuring confidentiality and efficiency.\n\n## ✅ Features\n\n- Sends customized emails to each recipient listed in an Excel sheet\n- Secures credentials using `getpass` and SSL encryption\n- Configurable SMTP server and sender details via a `config.txt` file\n- Facilitates academic use-cases like sharing marks with privacy\n- Easy terminal-based interaction\n\n\n## 🛠️ Technologies Used\n\n- `smtplib`: To create an SMTP client session to send emails.\n- `ssl`: For secure connection using TLS.\n- `openpyxl`: To read and parse Excel `.xlsx` files.\n- `getpass`: For secure password input without echoing it in the terminal.\n\n\n## 📁 Project Structure\n\n```\n📁 email_bot/\n ├── EmailSender.py          # Main script\n ├── config.txt              # Contains SMTP and sender details\n └── student_marks.xlsx      # Excel sheet with student data\n```\n\n\n## ⚙️ Configuration File (config.txt)\n\nFormat:\n```\nsmtp_server: smtp.gmail.com\nemail_id: your-email@gmail.com\nfilename: student_marks.xlsx\nsheetname: Sheet1\n```\n\n## 📋 Excel Sheet Format\n\n| A (Name) | B (Email) | C (Marks) |\n|----------|-----------|-----------|\n| John     | john@email.com | 92    |\n| Alice    | alice@email.com | 88   |\n\n## 🚀 How to Run\n\n1. Place your `.xlsx` file in the **same directory** as the Python script.\n2. Edit `config.txt` with your SMTP and file details.\n3. Run the script:\n\n```bash\npython send_emails.py\n```\n\n4. When prompted, enter your email password (input hidden).\n5. The script will send emails and notify you on successful completion.\n\n## 📌 Notes\n\n- Gmail users may need to enable \"Less secure apps\" or generate an app-specific password.\n- For macOS, you may need to install the `certifi` module if SSL certificates cause issues.\n\n## 🔐 Security Reminder\n\nAvoid hardcoding sensitive information. Use `getpass` or environment variables and **never upload credentials or actual data files to public repositories**.\n\n## 📄 License\nThis project is for educational and internal use. [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadeeteya%2Fautomatic-excel-email-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadeeteya%2Fautomatic-excel-email-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadeeteya%2Fautomatic-excel-email-bot/lists"}