Wi-Fi login for VIT

This application helps you login to the Wi-Fi networks used for students at VIT University, Vellore, India.

DISCLAIMERS

• This software has been tested on Windows only, not on MacOS or GNU/Linux even though support for these is included.

  To all Linux and MacOS users on campus: We would really appreciate it if you would please help us out by testing it for us 😊

• This has not yet been approved by VIT staff in any capacity, and is not official software. Please use this completely at your own risk.

[FOR DEBIAN-LIKE] Steps to run:

1. Run the following command. You must have curl and python3 in installed and in your system path. You must also have sudo privileges.

   curl -s https://raw.githubusercontent.com/cocapp/wicon-py/master/setup.sh -o /tmp/wicon-setup.sh 
   chmod +x /tmp/wicon-setup.sh
   /tmp/wicon-setup.sh

   When prompted, enter a sudo password. This is required to install WiCon in the network manager.

2. When prompted, enter your VIT Wi-Fi credentials. These will be stored in your home directory in a file called .wicon. You may later edit this file to change your credentials, or reuse the addcreds command.

[FOR EVERYONE ELSE] Steps to run:

1. Install the Python dependencies in your local environment:

   python -m pip install -r requirements.txt

   If you intend to also develop, also installing developer dependencies might be useful to you:

   python -m pip install -r dev-requirements.txt

2. Set up your credentials using the addcreds command. You may later use the same command to edit (overwrite) your credentials.

   python ./login_cli.py addcreds

   Example usage:

   $ python ./login_cli.py addcreds
   Enter your register number: 21BEE8964
   Enter your password:
   Credentials added successfully.

   The echo is turned off when entering the password, and it is normal for no text to be displayed.

3. Run the script to login:

   python ./login_cli.py login

   You may optionally supply your credentials as an argument:

   python ./login_cli.py login -r 21BEE8964 -p "my unguessable password"

4. When you're done using the internet, logout.

   python ./login_cli.py logout