Skip to content

Easy-to-use bot who can attend your classes on MS Teams

License

Notifications You must be signed in to change notification settings

priyanshux/bunkmeet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

84 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bunkmeet — A Proxy Bot

Bunkmeet is an easy-to-use user-friendly proxy bot who can act as your substitute and attend online meetings or classes hosted on Microsoft Teams.

How to install and run Bunkmeet — https://youtu.be/GFGXuKpEE5c

(Note: Links don't open in new tab)

Bunkmeet

Worker

Quick Ubuntu/Debian Installation

It only takes 3 commands to install and run Bunkmeet on Ubuntu/Debian:

./ubuntu.sh && ./pip.sh

./server.sh on terminal 1

./worker.sh on terminal 2

Same installation has been explained below.

Installation

Step 0 - Cloning the repository

git clone https://github.com/priyanshux/bunkmeet

cd bunkmeet

Step 1 - Installing required packages

Ubuntu/Debian

The first step on Ubuntu/Debian is pretty straightforward.

./ubuntu.sh

Note that you need to be in the first bunkmeet directory before running these scripts as they are path dependent. Running ./bunkmeet/ubuntu.sh will throw errors.

Other Linux distributions

Manually install chromedriver, its dependencies and move chromedriver to /usr/bin/. The executable path in Bunkmeet's webdriver is /usr/bin/chromedriver

Also install python3, python3-pip, python3-venv and redis-server.

Step 2 - Running script for pip packages

./pip.sh

Note that you need to be in the first bunkmeet directory before running these scripts as they are path dependent. Running ./bunkmeet/pip.sh will throw errors.

Components and How To Use

You need to open two separate terminals and run ./server.sh and ./worker.sh

Components

Terminal 1

Run ./server.sh on terminal 1 and go to http://localhost:5000/, you'll be prompted to log in if you're using Bunkmeet for the first time or have deleted data from bunkmeet/database.db.

Terminal 2

Run ./worker.sh and do not close until all your tasks (lectures) have been executed.

Note:

  • None of your data (user credentials and team names) is stored anywhere on cloud. Your data is stored locally on your computer at bunkmeet/database.db and only you can access it.

  • As stressed earlier, running ./bunkmeet/server.sh or ./bunkmeet/worker.sh will throw errors. You need to cd into the first bunkmeet directory using cd bunkmeet before running any of these scripts.

  • You can send multiple tasks, but the worker executes the tasks on first come first serve basis. Make sure you send the task to attend an 8AM lecture before the task for 10AM and so on.

  • The worker and server are separate and don't depend on each other. You don't need to run both ./server.sh and ./worker.sh together for Bunkmeet to work.

  • You can run only the server to send a task, close the server and run the worker anytime before your first lecture starts.

  • It is, however, recommended to keep the worker running while sending a task to confirm its proper functionality in real-time.

Experimental Features (Optional)

Note that you do not need to install any of these features and are optional. Additionally, these features can potentionally show bugs.

Running the worker in background

Install supervisor on your system.

Ubuntu/Debian users can do so using sudo apt-get install supervisor

Make sure you're in the first Bunkmeet directory and run the following commands to set up Celery on Supervisor

bunkmeet=$(pwd)

Download this script and run the following:

mv supervisor.sh $bunkmeet && cd $bunkmeet
chmod 755 supervisor.sh && ./supervisor.sh

Now go to bunkmeet/two.py and uncomment the following:

# options.add_argument("--no-sandbox")
# options.add_argument("--headless")
# options.add_argument("--disable-dev-shm-usage")
# driver.set_window_size(1280, 1440)

This should set up your worker in background using headless mode.

Contribution

Join the Slack workspace

About

Easy-to-use bot who can attend your classes on MS Teams

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published