Git Product home page Git Product logo

coder-nobody / cowin-slot-telegaram-notifier Goto Github PK

View Code? Open in Web Editor NEW
4.0 1.0 2.0 36.2 MB

This app will notify the user of slot availability in his area pincode and send a message on his telegram messenger.

Python 92.49% Shell 0.03% Batchfile 0.01% HTML 0.40% CSS 0.01% Roff 0.05% DTrace 0.01% VBScript 0.01% PLSQL 0.05% XSLT 0.01% PowerShell 0.04% C 1.37% C++ 0.23% Tcl 5.16% Makefile 0.13% F# 0.01% C# 0.02% Forth 0.01%
python3 telegram-api vaccine-availability slot-availability cowin cowin-vaccine-notification cowin-vaccine-tracker vaccination-tracker covid-19 slot

cowin-slot-telegaram-notifier's Introduction

Cowin-Slot-Telegram-Notifier

This console app can ease up your vaccine hunt by sending Vaccine availability information on your Telegram app as soon as the vaccine is availabe in your pincode.

Features

  • Search Vaccine in your area by Pincode.
  • Can fetch the information for multiple Pincodes.
  • Vaccine information is updated every 30 seconds per pincode.
  • Get the updated information on Telegram.
  • Information can be sent to any number of users and groups on Telegram.

Installation

  • For windows clone or download this repo and run runscript.bat
  • For other operating system install the dependencies in requirements.txt and run main.py from your console on python >3.7 for installing the requirements.txt use this command: pip install -r requirements.txt

Initial setup

You can skip the following steps if you add credentials information in Database.json in advance

image_creds

Now to send messages using telegram you must have Telegram account and you should have your Telegram API Id and Api Hash

If you do not have that Don't worry, in the next section it is described how to get that.

Now on starting the app, follow the on screen instructions and Enter the Telegram API credentials.

image_creds

After that Set the value of Pincode sleep time, by default it is 30 seconds.

image_creds

After that add valid Recipient data. It consists of Pincode, Age group (18 of 45) and his telegram credentials.

Telegram recipient credentials can be:

  • Recipient mobile number with country code eg.(+91xxxxxxxxxx)
  • Recipient Telegram Username.
  • A Telegram group invite link (You must be a member of that group and have messaging rights)

You can add more users also.

image_creds

If you later wish to add users You can do so by running manageUsers.bat

Alternatively you can also edit the entries in Database.json file.

After successfully completing these steps, your credentials will be validated and an OTP will be sent from telegram.

image_creds

Enter the OTP and the setup is complete. πŸ‘πŸ‘

After that it will never ask for OTP and you will start receiving vaccine messages on your registered recipient accounts.

image_creds

This is how you will recieve the Telegram notification.

image_creds

Getting Telegram API ID and HASH

In order to obtain an API id you need to do the following:

  • If you do not have Telegram account then create one.
  • Log in to your Telegram Account here: https://my.telegram.org.
  • Go to 'API development tools' and fill out the form
  • You will get basic addresses as well as the api_id and api_hash parameters required for user authorization.

You can also refer offficial documentation at https://core.telegram.org/api/obtaining_api_id

Note:


Clone or Fork this Repository do remember to give a star 🌟 that motivates me to continue my work.

Do suggest any changes your contributions to this project are highly appreciated.

Using this app get notifications for yourself as well as your friends. Happy to help ☺️

cowin-slot-telegaram-notifier's People

Contributors

coder-nobody avatar

Stargazers

 avatar  avatar  avatar  avatar

Watchers

 avatar

Forkers

trellixvulnteam

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.