GitHunt
KA

kaushalvivek/IIIT-Courier-Notification

A simple notification system to inform when a new parcel is delivered.

IIIT-Courier-Notification

version
python

This script is a cron job and has been written with an intention to notify you via email whenever you get a new parcel, courier, letter etc. at IIIT Hyderabad, and your delivery is logged at Nilgiri. Read up ahead for usage instructions and setup.

Requirements

  1. External Python Libraries:-
  2. Cron
  3. Google Chrome

Setup

Fill up the below section in main.py, here, you have to provide the sign-in details for any gmail account. This account will be used to send emails to you.
This can be found at line 11 onwards.

# FILL THIS UP OTHERWISE THE SCRIPT WON'T RUN
#################################################
# Login details of any gmail account
bot_mail = ''
password = ''
#################################################

Usage and Deployment

After setup, run the script as:

python3 main.py -q YOUR_NAME -m EMAIL 

Note that your name should be written without spaces, use underscore if full name is typed.

Crontask Deployment:

# For checking once every day.

1 0 * * * python3 $PATH_TO_SCRIPT/main.py -q YOUR_NAME -m EMAIL

Do not deploy the script at a greater frequency than once per hour.

If you face any problems, have any suggestions, create issues here in this repository. Contributions are welcome.

Languages

Python100.0%

Contributors

MIT License
Created November 22, 2018
Updated May 21, 2025