Code Monkey home page Code Monkey logo

cowin-slot-finder's Introduction

CoWin Slot Finder - (Pythonic way to search)

An automated tool/Script/Application to find available slots for your age and state/district and pin using CoWin API.

Cowin is the portal for pan-India Covid-19 vaccination drive.

How is it different from others?

  • Saves your precious time
  • No installation required for windows distributions
  • Can find slot by Postal Pin code
  • Can find slot as per your dose requirement (i.e. First or Second Dose) so no false alarm
  • Easy to use and lightweight
  • Continuous tracking of slot. No need of user attention after setup.
  • Updates data 3 times in a minute and send you a notification on your notification panel.

This script can search through the entire state and organize the results as per district and date. Moreover, it only shows centres with available slots (prevents clutter). Also in Windows 10 systems it is able to send a notification to the user. You don't need to look at the command line for the whole day.

Screenshot

Working of main script find_slots.py

Searching entire Delhi

CLI application Searching by PIN

CLI application Searching by PIN

CLI application Searching by state and district code

CLI application Searching by state and district code

Instructions

Users with Windows OS

  • Download an exe file from the link as per your requirement Download Releases
  • Doubble click on application to start
  • Follow the app instructions. Learn More about usageHere
  • Tip: If you download the icon along with the executable and place it in same file. Notification will look more beautiful.

Users with python 3.0 or grater on any operating system

  • Download Any of the CLI application
  • Follow the instructions Learn More about usageHere

For Advanced Users Having python Installed

  1. Download find_slots.py or clone the repo.
  2. Edit variables in the said file.
  3. Run, using the instructions below.

Windows

  • Install latest Python form this link. or
choco install python
  • Open command prompt (cmd) and run the following-
py -m pip install requests
py "(location)\find_slots.py"

or -You can install all dependencies from repo location using below command.

py -m pip install -r requirements.txt

Linux

sudo apt-get install python3
git clone https://github.com/HDash/cowin-slot-finder.git
pip install -r requirements.txt
python3 <script you want to run>

Contribution

Feel free to pull requests.
Share your feedback, suggestions and bugs. :)

Scopes of Developments

  • GUI Application
  • Mobile Application

Credits

bhattbhavesh91 - json Parsing and request script for cowin API
SridharJena - CLI adaptation for the script, API request fix

License

MIT

cowin-slot-finder's People

Contributors

hdash avatar sridharjena97 avatar kurianbenoy avatar

Stargazers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.