Skip to content

Repo for Cowin-Notifier, a go to application for receiving notifications about available vaccine slots on your android device.

Notifications You must be signed in to change notification settings

sukritkapil2/Cowin-Notifier-Android

Repository files navigation

Cowin Notifier Android

GitHub license

Cowin Notifier is an android app that runs in the background and informs you whenever an available slot is found for the mentioned slot and age group.

Cowin Notifier Logo

Unqiue Features

Minimal UI - Easy to use

  • Cowin notifier has an easy UI, that an average user can easily use. A no nonsense application, that you run once and leave it running, without worrying to check back or keep your device on. Additionally it is a small application with only 3.6 Mb size.

Background Application - No need to keep your device on

  • Will continuously run in the background even if you close the application and ping the server every 10 seconds, so that you will know immediately whenever a slot is found.

Run Once Listen Forever - Close the app, it still works!

  • Notifier checks for the next 7 days from the current date not the selected date. So the user can keep the app running and not worry about changing the date again and again.

Bad Network? - It handles it well

  • The notifier takes care of bad network conditions. It will keep running even if internet is not available and whenever the internet is available it will again start pinging the server.

Minimal data usage - Less data? no worries

  • Minimal data usage is there. It only gets a JSON response every 10 seconds. So even after 4-5 days of continuous background running, the maximum data usage will not exceed 10 Mb.

Installation

Download the .apk file for your android phone from here.

Google Drive

Usage

After installation, you can add a pincode or select a district from the edit place section.

Then you can view slots or start a notification service for the selected place and mentioned age group, by clicking on the 'Start Notification Service'.

The application can be closed as well after starting the service as it will start a foregorund service that will notify you whenever a slot is available.

Demo

Here is a working demo of the application

Post.-.Feed.mp4

Languages and Libraries

  • Java
  • Retrofit
  • Material UI
  • Gson

Environment Setup

Download the source code and simply import it as a project in android studio. Let it sync all the libraries after which you can start building the code.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT

About

Repo for Cowin-Notifier, a go to application for receiving notifications about available vaccine slots on your android device.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages