If you need to register for a full class, this bot will keep trying to enroll you every 6 minutes until your shopping cart is full (or two factor kicks you out).

Ensure that Firefox, firefox-geckodriver, Python3, and pip are installed. Use pip to install selenium and typer.

On Debian based distributions (Ubuntu and Pop!_OS tested):

$ git clone https://github.com/amija004/FIU-RegistrationBot
$ cd FIU-RegistrationBot
$ sudo apt update && sudo apt upgrade -y
$ sudo apt install python3 pip3 firefox firefox-geckodriver
$ pip install selenium typer
$ python3 bot.py

For Windows, the simplest method found was to install Ubuntu from the Windows app store, and then use the above instructions. Only Ubuntu was tested, but other Debian based distributions should work. You may have to restart Ubuntu for the installations to be added to the path.

MacOS was not tested, but should work if the required dependencies are installed.

WARNING: YOU MUST MAKE SURE YOUR COMPUTER WILL NOT SLEEP. PLUG IT IN AND CHECK THE SETTINGS, OR USE A DEDICATED COMPUTER FOR THIS SCRIPT

It is highly recommended that you use a computer that is on 24/7 with SLEEP DISABLED. A raspberry pi or an old laptop should work well.

The script is intended to run until you get your classes or you get logged out.

Before running the script, make sure that only the classes you want are in your shopping cart, and ideally only classes for the semester you are trying to enroll in. Tests were only conducted for classes in the Spring semester.

The script will attempt to enroll in all classes in the shopping cart

To test the script in an actual browser window, run:

$ python3 bot.py --no-headless

To run the script, navigate to the RegistrationBot directory and run:

$ python3 bot.py

Follow the instructions to enter your username and password (type carefully, you can't see the prompt for security reasons). Enter 1 for Spring, 2 for Summer, 3 for Fall. This should only matter if you have shopping carts for each semester.

The system will attempt to use the call function of the 2 Factor Authentication to authenticate. You should receive the call shortly after starting the script.

It will then attempt to enroll you in all the classes in your shopping cart every 6 minutes. Tests were conducted with 1 and 2 classes in the shopping cart without issue.

Feedback is appreciated :) That's it, good luck!