Skip to content

Telegram bot to pull attendance from SJCET website, plus more features like bunk calculator, test reports, etc. https://mis-bot.readthedocs.io/

License

Notifications You must be signed in to change notification settings

ArionMiles/MIS-Bot

Repository files navigation

MIS Bot

Telegram Bot Telegram Channel

About

I created this bot as a means to avoid Defaulter's List, and I hope this bot can help others avoid it, too. The bot is hosted on the Google Cloud Platform (GCP).

Features

  • CAPTCHA Bypass

    The bot can automatically answer the captcha code for logging in. Uses securimage_solver library.

  • Bunk Calculator

    Calculate rise/drop in your overall percentage.

    Bunk calculator formula

    where

      a = Total lectures attended
    
      b = Total lectures conducted on the day of bunk
    
      c = Total lectures conducted so far
    
      n = number of lectures to bunk
    
  • Until80

    Shows the number of lectures one must consecutively attend in order to get their Overall Attendance to 80%. It is the minimum percentage of overall lectures one must attend to avoid the defaulter's list.

    Until80 formula

    where

      a = Total lectures attended
    
      c = Total lectures conducted so far
    
      x = number of lectures to attend
    

    Note: We calculate x from this equation. Value of x can be negative too, when your attendance is already over 80.

  • Until X

    Like Until80 but you specify the percentage.

  • Target Attendance

    Set a target of attendance percentage for yourself and we'll remind you how long you've left to go before fulfilling your target.

  • Results

    Fetch results of Class Tests. Uses scrapy-splash library.

Installation and Documentation

Read the documentation at mis-bot.readthedocs.io on getting this bot up and running for yourself.

Roadmap

  • Attendance scraper
  • Bunk/Until80 functions
  • Allow registration
  • Results scraper
  • Store attendance data in a database

Contributors

License

MIT License. Please see License file for more information.