Gyft Save

Get Your Freaking Timetable

Project README

Contributors Forks Stargazers Issues MIT License Wiki


Get Your Freaking Timetable
Report Bug · Request Feature

Table of Contents

About The Project

Gets your timetable from ERP and adds it to your Google Calendar or gives you an ICS file which you can add in any common calendar application.

Note All updates to this repo should reflect, with appropriate refactorisation, in gyft-serve

(back to top)

Getting Started

To set up a local instance of the application, follow the steps below.


The following prerequisites are required to be installed for the project to function properly:

  • Python 3
  • IIT-KGP Student ERP Account

(back to top)


Now that the environment has been set up and configured to properly compile and run the project, the next step is to install and configure the project locally on your system.

  1. Clone the repository
    git clone --depth 1
  2. Change the current directory to the project directory
    cd gyft
  3. Install the dependencies
    pip install -r requirements.txt

(back to top)


  1. Run the script
  2. Enter your roll number, password, security answer, and OTP (if required) when prompted
  3. Now you can choose between 2 options, which will be prompted to you:
    • Add to Google Calendar:

      • For this, you have to get your credentials.json and save it as client_secret.json to the current directory by following the Step 1 from here
      • Also note that adding to Google Calendar requires an Internet connection
    • Generate ICS file:

      • This will generate an ICS file which you can import into any calendar application.
      • For importing to Google Calendar, follow the instructions given here.

  • Optional flags:
    • To delete all the recurring events added by the CLI or GYFT Web Application (uses a property of recurrence to identify events to delete), you can run with the --del-events flag:
      python3 --del-events
    • To specify the output file (.ics) to which the ICS file will be written, use the --output flag.
      python3 --output autumn_2023.ics

(back to top)

Development Notes

This project utilizes the iitkgp-erp-login package to handle ERP login functionality.

Updates To Be Made Each Sem

The following procedure is to be followed each new semester by the maintainer for updating GYFT to work properly.

  • Download the academic calendar for the particular year.
  • New semester dates need to be updated in utils/
  • The format for the date-time is (YYYY, MM, DD, HH, MM).
  • Raise a pull request once the dates are updated.

(back to top)


Please read guide to know more.


Open Source Agenda is not affiliated with "Gyft" Project. README Source: metakgp/gyft
Open Issues
Last Commit
4 weeks ago

Open Source Agenda Badge

Open Source Agenda Rating