coder-nobody / Cowin-slot-telegaram-notifier

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

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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 ☺️

About

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


Languages

Language:Python 92.5%Language:Tcl 5.2%Language:C 1.4%Language:HTML 0.4%Language:C++ 0.2%Language:Makefile 0.1%Language:PLSQL 0.1%Language:Roff 0.0%Language:PowerShell 0.0%Language:Shell 0.0%Language:C# 0.0%Language:F# 0.0%Language:Batchfile 0.0%Language:Forth 0.0%Language:DTrace 0.0%Language:XSLT 0.0%Language:CSS 0.0%Language:VBScript 0.0%