💉 CoWIN Notifier 😷

A cross-platform tool written in rust, which instantly notifies users about COVID-19 vaccine availability at their regions. Currently, this tool is only compatible in India.

Usage

💻 Windows

• Download the zip file and unzip it.
• Open the folder containing the file, do a Shift + Right Click and select "Open Powershell here."
• Run ./cowin-notifier "state_name" "district_name" "age_group"
• Minimize the Powershell window.
• If a slot opens up for your age group and district, you'll recieve a notification. Make sure that you don't close the Powershell window.

🍎 macOS

• Download the zip file and unzip it.
• Open your terminal and cd into your default Downloads directory where you have downloaded the file. macOS users can fire up Spotlight using cmd + Space, search for Terminal and open it.
• Run the following commands in the terminal.

 cd ~/Downloads 
chmod +x cowin-notifier
./cowin-notifier "state_name" "district_name" "age_group"

• Minimize your terminal.
• If a slot opens up for your age group and district, you'll recieve a notification. Make sure that you don't close the Terminal.

🐧 Linux

• We use the reqwest crate, which has some specific requirements for Linux. Please install the required dependencies as mentioned.
• Download the zip file and unzip it.
• The rest of the usage is similar to macOS.

Note: The notification functionality hasn't been tested yet on Linux. Please feel free to play around with the code and test it.

If you're stuck somewhere in between, please check these commands out, and of course try googling!

Contributing

Please feel free to contribute. The tool is written purely in the Rust Programming Language. The code definitely needs some cleanup and refactoring, so please open a PR if you feel up for the task. If anyone can figure out how to daemonize this (at least on POSIX) without having to write a systemd file, please go ahead and implement it.