https://github.com/bhuvansa/whatsappmarksbot
A bot to send marks of students to parents from excel to whatsapp
https://github.com/bhuvansa/whatsappmarksbot
openpyxl python selenium tkinter-gui
Last synced: 22 days ago
JSON representation
A bot to send marks of students to parents from excel to whatsapp
- Host: GitHub
- URL: https://github.com/bhuvansa/whatsappmarksbot
- Owner: BhuvanSA
- Created: 2023-01-26T11:27:07.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-09-16T14:58:31.000Z (over 1 year ago)
- Last Synced: 2025-07-23T01:40:42.611Z (11 months ago)
- Topics: openpyxl, python, selenium, tkinter-gui
- Language: Python
- Homepage:
- Size: 63.5 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Marks Sender Bot
Marks 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.
## Features
- User-friendly GUI built with Tkinter and ttkbootstrap
- Excel file parsing for student data
- Automated WhatsApp messaging using Selenium
- Progress tracking and status updates
- Customizable message templates
## Installation
1. Clone the repository:
```
git clone https://github.com/BhuvanSA/WhatsappMarksBot.git
cd marks-sender-bot
```
2. Create a virtual environment (optional but recommended):
```
conda create -n whatsappbot python=3.11
conda activate whatsappbot
```
3. Install the required dependencies:
```
pip install -r requirements.txt
```
4. Ensure you have Chrome installed, as the bot uses ChromeDriver for Selenium.
## Usage
1. Run the main application:
```
python src/main.py
```
2. Use the GUI to:
- Select the Excel file containing student data
- Choose the appropriate sheet and internal assessment
- Set the range of students to process
- Enter the mentor's name
- Start the sending process
3. The application will open WhatsApp Web. Scan the QR code to log in.
4. The bot will automatically send messages to the specified range of students.
5. Monitor the progress and status in the GUI table.
## Project Structure
- `src/`
- `main.py`: Entry point of the application
- `gradebook/gradebook.py`: Main GUI and application logic
- `excelManager.py`: Handles Excel file operations
- `seleniumManager.py`: Manages Selenium WebDriver for WhatsApp interaction
- `messageGenerator.py`: Generates message content
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the [MIT License](LICENSE).
## Acknowledgements
- [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap) for the modern GUI elements
- [Selenium](https://www.selenium.dev/) for web automation
- [openpyxl](https://openpyxl.readthedocs.io/) for Excel file handling
## Disclaimer
This project is for educational purposes only. Use it responsibly and in compliance with WhatsApp's terms of service.