https://github.com/ccrsxx/autobsi

Attendance script for My Best BSI
https://github.com/ccrsxx/autobsi

automation chromedriver python schedule selenium webscraper

Last synced: 3 months ago
JSON representation

Attendance script for My Best BSI

• Host: GitHub
• URL: https://github.com/ccrsxx/autobsi
• Owner: ccrsxx
• License: mit
• Created: 2021-10-10T12:16:24.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-03-14T08:32:49.000Z (11 months ago)
• Last Synced: 2024-10-11T10:51:39.640Z (4 months ago)
• Topics: automation, chromedriver, python, schedule, selenium, webscraper
• Language: Python
• Homepage:
• Size: 92.8 KB
• Stars: 19
• Watchers: 3
• Forks: 8
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# [autobsi](https://github.com/ccrsxx/autobsi) · ![Build](https://github.com/ccrsxx/autobsi/actions/workflows/codeql-analysis.yml/badge.svg) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

autobsi is a script that allows you to automatically attend your class on the My Best BSI site. It features a scheduler that will automatically start the script when your class starts, it is also able to run when you are inside your class schedule. You can run it on your computer or host it on a cloud server like Heroku.

## Prerequisites

Make sure you have installed all of the following prerequisites on your machine:

- Git - [Download & Install Git](https://git-scm.com/downloads).

- Python version 3.8 or higher - [Download & Install Python](https://nodejs.org/en/download/).

- Google Chrome version 90 or higher.

## Setup

First before running the script. You need to set up the `src/config.json` to allow the script to log in and attend the class. Follow these steps:

1. In the timetable section, you can find days for classes that you have to take per week. Change those days based on your schedule. Make sure it's written in English and typed correctly.

2. Inside the timetable you can find the name, time, and link. The name is for your class name, you can name it whatever you want here. The time is your class schedule, it's a list that consists of when your class starts and ends, it's formatted as 'HH:MM' i.e '12:30'. The link is the URL of the class that you attend, you can get it on My Best in your class attendance section.

3. The last section is the username (nim) and password. This data is used to allow the script to log in to your My Best Account.

**Cloud tutorial coming soon...**

**Note**: If you have multiple classes a day, you will need to wrap your class name, time, and link to a list. The time section is always a list, so it's nested inside a list when you have more than one class a day. See the example at Thursday class on the default `src/config.json`.

## Installation

Follow all these steps shown below to use the script.

1. Clone this repository. Run:

   ```bash

   git clone https://github.com/ccrsxx/autobsi.git

   ```

2. Change the directory to the autobsi folder. Run:

   ```bash

   cd autobsi

   ```

3. Install the dependencies with pip. Run:

   ```bash

   pip install -r requirements.txt

   ```

4. Install the webdriver for selenium. Run:

   ```bash

   python setup.py

   ```

5. Run the script:

   ```bash

   python main.py

   ```

**Note**: If you are running the script locally or on a Windows machine, follow these additional steps in the `main.py`:

1. Change the get method from `get_from_heroku` to `get_from_config`.

2. Change the cloud parameter from `True` to `False`.

3. Change the mail parameter from `True` to `False` to prevent an authentication error traceback. If you have a google mail API, don't change this parameter.