{"id":19910160,"url":"https://github.com/bhuvansa/whatsappmarksbot","last_synced_at":"2026-05-18T11:09:56.972Z","repository":{"id":165093971,"uuid":"593584243","full_name":"BhuvanSA/WhatsappMarksBot","owner":"BhuvanSA","description":"A bot to send marks of students to parents from excel to whatsapp","archived":false,"fork":false,"pushed_at":"2024-09-16T14:58:31.000Z","size":66614,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-23T01:40:42.611Z","etag":null,"topics":["openpyxl","python","selenium","tkinter-gui"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BhuvanSA.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,"publiccode":null,"codemeta":null}},"created_at":"2023-01-26T11:27:07.000Z","updated_at":"2025-02-05T13:24:21.000Z","dependencies_parsed_at":"2024-02-10T11:27:13.326Z","dependency_job_id":"30d06751-3d68-4ca1-8734-ad9c134b9585","html_url":"https://github.com/BhuvanSA/WhatsappMarksBot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/BhuvanSA/WhatsappMarksBot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BhuvanSA%2FWhatsappMarksBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BhuvanSA%2FWhatsappMarksBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BhuvanSA%2FWhatsappMarksBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BhuvanSA%2FWhatsappMarksBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BhuvanSA","download_url":"https://codeload.github.com/BhuvanSA/WhatsappMarksBot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BhuvanSA%2FWhatsappMarksBot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33175957,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-18T09:27:30.708Z","status":"ssl_error","status_checked_at":"2026-05-18T09:27:28.300Z","response_time":71,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["openpyxl","python","selenium","tkinter-gui"],"created_at":"2024-11-12T21:17:48.256Z","updated_at":"2026-05-18T11:09:56.956Z","avatar_url":"https://github.com/BhuvanSA.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Marks Sender Bot\n\nMarks Sender Bot is a Python-based GUI application that automates the process of sending student marks to parents via WhatsApp. It reads data from an Excel file and uses Selenium to interact with WhatsApp Web for message delivery.\n\n![Marks Sender Bot GUI](/data/Preview.png)\n\n## Features\n\n-   User-friendly GUI built with Tkinter and ttkbootstrap\n-   Excel file parsing for student data\n-   Automated WhatsApp messaging using Selenium\n-   Progress tracking and status updates\n-   Customizable message templates\n\n## Installation\n\n1. Clone the repository:\n\n    ```\n    git clone https://github.com/BhuvanSA/WhatsappMarksBot.git\n    cd marks-sender-bot\n    ```\n\n2. Create a virtual environment (optional but recommended):\n\n    ```\n    conda create -n whatsappbot python=3.11\n    conda activate whatsappbot\n    ```\n\n3. Install the required dependencies:\n\n    ```\n    pip install -r requirements.txt\n    ```\n\n4. Ensure you have Chrome installed, as the bot uses ChromeDriver for Selenium.\n\n## Usage\n\n1. Run the main application:\n\n    ```\n    python src/main.py\n    ```\n\n2. Use the GUI to:\n\n    - Select the Excel file containing student data\n    - Choose the appropriate sheet and internal assessment\n    - Set the range of students to process\n    - Enter the mentor's name\n    - Start the sending process\n\n3. The application will open WhatsApp Web. Scan the QR code to log in.\n\n4. The bot will automatically send messages to the specified range of students.\n\n5. Monitor the progress and status in the GUI table.\n\n\u003c!-- ![Marks Sender Bot in Action](path/to/bot_in_action.gif) --\u003e\n\n## Project Structure\n\n-   `src/`\n    -   `main.py`: Entry point of the application\n    -   `gradebook/gradebook.py`: Main GUI and application logic\n    -   `excelManager.py`: Handles Excel file operations\n    -   `seleniumManager.py`: Manages Selenium WebDriver for WhatsApp interaction\n    -   `messageGenerator.py`: Generates message content\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n## Acknowledgements\n\n-   [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap) for the modern GUI elements\n-   [Selenium](https://www.selenium.dev/) for web automation\n-   [openpyxl](https://openpyxl.readthedocs.io/) for Excel file handling\n\n## Disclaimer\n\nThis project is for educational purposes only. Use it responsibly and in compliance with WhatsApp's terms of service.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbhuvansa%2Fwhatsappmarksbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbhuvansa%2Fwhatsappmarksbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbhuvansa%2Fwhatsappmarksbot/lists"}