Skip to content

SwenZ77/ms-teams-automation-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Microsoft Teams Online Class Automation Bot

Automate your Microsoft Teams class attendance with robust scheduling, Discord notifications, and camera/mic controlsβ€”all from your own timetable!

🎯 Features Automated Login: Securely logs into Microsoft Teams using credentials from a .env file.

Custom Timetable: Interactive CLI to add, view, and manage your meeting/class schedule (team, meeting name, day, time).

Smart Meeting Join/Leave: Joins scheduled meetings at the right time, leaves automatically at the end.

Camera & Mic Control: Always joins meetings with camera and microphone OFF.

Discord Notifications: Sends status updates (joined, left, or not found) to your Discord channel via webhook.

SQLite Database: Stores your timetable securely and efficiently.

Robust Selenium Automation: Handles slow Teams loading and UI changes with explicit waits.

πŸ“Έ Screenshots Add screenshots here (e.g., login_success.png, meeting_joined.png) to show the bot in action!

βš™οΈ Setup Instructions

  1. Clone the Repository git clone https://github.com/yourusername/automation-bot.git cd automation-bot
  2. Install Requirements pip install -r requirements.txt
  3. Configure Credentials Create a .env file in the project root: EMAIL=your.email@domain.com PASSWORD=your_password DISCORD_WEBHOOK=https://discord.com/api/webhooks/your_webhook_id/your_webhook_token
  4. Set Up ChromeDriver Download ChromeDriver matching your Chrome version.

Place it in your PATH or the project directory.

πŸš€ Usage Modify Timetable: Add your meetings/classes interactively.

python main.py

Choose option 1 and follow prompts

View Timetable: See your current schedule.

python main.py

Choose option 2

Start the Bot: The bot will automatically join/leave meetings as scheduled.

python main.py

Choose option 3

πŸ“ Example Timetable Entry Team Name: Team Rockers

Meeting Name: Maths

Start Time: 10:00

End Time: 11:00

Day: Monday

πŸ”” Discord Notifications Get instant updates in your Discord channel when the bot joins, leaves, or can’t find a meeting.

πŸ› οΈ File Structure

automation-bot/ β”œβ”€β”€ main.py β”œβ”€β”€ discord_notifier.py β”œβ”€β”€ requirements.txt β”œβ”€β”€ .env └── timetable.db # (auto-created) 🧩 Customization Add screenshots: Use driver.save_screenshot("filename.png") in your code to capture proof of automation.

Change notification logic: Edit discord_notifier.py for custom Discord messages or embeds.

❗ Troubleshooting ModuleNotFoundError: Install missing modules with pip install module-name.

ChromeDriver not found: Ensure the driver matches your Chrome version and is in your PATH.

Bot not joining meetings: Double-check your timetable, team/meeting names, and time format.

πŸ™ Credits Inspired by tomassabol/MS-Teams-Attender-v2 and aniket328/microsoft-team-automation

Discord notifications via discord-webhook

Developed by Swayam Tandon

πŸ“œ License MIT License

Enjoy your automated attendance! If you find this useful, star the repo and contribute!

About

Automation bot that auto-joins and leaves Microsoft Teams classes using Python, Selenium, and SQLite, with schedule-based execution and Discord notifications.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages