README.md

MS-Teams-Auto-Joiner

This python script will automatically join Microsoft Teams meetings appearing in your Teams calendar.

Features:

• This python script will automatically open a chrome tab, enter your username, your password, open the calendar tab and then join a meeting if available.
• Before joining any meeting, it will by default turn off your camera and microphone.
• After the organiser ends the meeting, it will open the calendar tab to look for new meetings and join the next meeting if available.
• If the organiser leaves the meet instead of ending the meet, the script will automatically leave the meeting after the number of attendees falls below the minimum participants allowed set by the user (default is 10), but will rejoin the meeting if the join button is still visible on the calendar tab.
• To receive SMS alerts follow Step 3 to setup your twilio account. Credits to @WOLFIEEEE for doing the twilio integration.

Requirements:

• Python3
• Google Chrome browser

Prerequisites:

After cloning the repo, go in the repo directory and then follow below steps:

• Step 1: Install dependencies from requirements.txt:

  pip install -r requirements.txt

• Step 2: To set login credentials and minimum number of participants allowed, modify config.json.rename and rename it to config.json:

  {
      "username":"example@example.com",
      "password":"example",
      "minimumParticipants":10,
      "headless": false,
      "use_twilio":false,
      "account_sid": "AC506be2ab8a6f4d8602cccccccccccccccc",
      "auth_token":"9f2ca3f98b46c57ab0a77accccccccccccc",
      "your_no":"+91894900000",
      "twilio_no":"+17039970000", 
      "nickname" : "nick_name"
  }

To use twilio for sending SMS alerts set use_twilio to true and follow below steps else jump to Usage. (Credits: @WOLFIEEEE)

• [Step 3] Optional:
  • Step 1: To create a free trial account on twilio https://www.twilio.com/try-twilio
  • Step 2: Sign Up / Login and verify your mobile number
  • Step 3: Open twilio console
  • Step 4: There you will see account_ssid, auth token and to get the number (which will be used to send the message), click on Get trial number.
  • Step 5: Modify config.json.rename and rename it to config.json:

    {
        "username":"example@example.com",
        "password":"example",
        "minimumParticipants":10,
        "headless": false,
        "use_twilio":true,
        "account_sid": "AC506be2ab8a6f4d8602cccccccccccccccc",
        "auth_token":"9f2ca3f98b46c57ab0a77accccccccccccc",
        "your_no":"+91894900000",
        "twilio_no":"+17039970000", 
        "nickname" : "nick_name"
    }

• Extra config:
  • To run in headless mode: Set headless to true.

Usage:

• Run autoJoin.py:

  python autoJoin.py

• The script might not work as expected if the browser is minimised i.e you may open other windows above it but do not minimize the chrome window.

Sample Scenario:

• You have a meeting at 9 A.M, you may run the script anytime before 9 A.M. and the script will automatically join the meeting when the join button is available.
• The script will then automatically join the next meeting scheduled at e.g.:- 10 A.M. AFTER the organiser ends the meeting.
• If the organiser does not end the meeting i.e the organiser leaves the meeting instead of ending the meeting, the script will leave the meeting after the strength of the meeting falls down to 10 or any minimum value set by the user.
• To set a custom condition to automatically leave the meeting change the code on line# 137 of autoJoin.py

Contributing:

• When contributing to this repository, feel free to discuss the change you wish to make via Issues, Discussions or gitter chat room before making a change.
• And don't forget to ⭐ the repo, 😃.