{"id":19449736,"url":"https://github.com/metakgp/chillzone","last_synced_at":"2026-03-06T14:03:52.687Z","repository":{"id":100459212,"uuid":"121857342","full_name":"metakgp/chillzone","owner":"metakgp","description":"Find a place to chill during class hours in IIT KGP","archived":false,"fork":false,"pushed_at":"2024-12-11T23:27:50.000Z","size":7014,"stargazers_count":22,"open_issues_count":8,"forks_count":27,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-01-07T23:37:10.163Z","etag":null,"topics":["academic","classroom","hacktoberfest"],"latest_commit_sha":null,"homepage":"https://chill.metakgp.org","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/metakgp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-17T13:26:44.000Z","updated_at":"2024-08-09T15:43:29.000Z","dependencies_parsed_at":"2023-10-11T13:16:18.891Z","dependency_job_id":"d60caa03-c147-481c-a63f-48bddcfd55f6","html_url":"https://github.com/metakgp/chillzone","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metakgp%2Fchillzone","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metakgp%2Fchillzone/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metakgp%2Fchillzone/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metakgp%2Fchillzone/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/metakgp","download_url":"https://codeload.github.com/metakgp/chillzone/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240636890,"owners_count":19832963,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["academic","classroom","hacktoberfest"],"created_at":"2024-11-10T16:33:37.552Z","updated_at":"2026-03-06T14:03:52.673Z","avatar_url":"https://github.com/metakgp.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv id=\"top\"\u003e\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![GPL v3][license-shield]][license-url]\n[![Wiki][wiki-shield]][wiki-url]\n\n\u003c/div\u003e\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/metakgp/chillzone\"\u003e\n    \u003cimg width=\"140\" alt=\"image\" src=\"images/icons/icon_384x384.png\"\u003e\n  \u003c/a\u003e\n\n  \u003ch1 align=\"center\"\u003eChillzone\u003c/h1\u003e\n\n  \u003cp align=\"center\"\u003e\n    \u003ci\u003eWill find you a chillzone inside IIT KGP at any time.\u003c/i\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://chill.metakgp.org\"\u003eWebsite\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/metakgp/chillzone/issues\"\u003eReport Bug\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eTable of Contents\u003c/summary\u003e\n\n- [Local Installation](#local-installation)\n- [Updation for a new semester](#updation-for-a-new-semester)\n- [Meanings of the various files](#meanings-of-the-various-files)\n  - [Input Files](#input-files)\n  - [Output Files](#output-files)\n- [Development Notes](#development-notes)\n- [Maintainer(s)](#maintainers)\n- [Contact](#contact)\n- [Additional documentation](#additional-documentation)\n\u003c/details\u003e\n\n## Local Installation\n\nTo run Chillzone front-end on your local system.\n\n1. Make sure you have `pnpm` installed on your system. Installation instructions can be found [here](https://pnpm.io/installation).\n2. Clone the repo and change directory.\n\n   ```\n   git clone https://github.com/metakgp/chillzone\n\n   cd chillzone/frontend\n   ```\n\n3. Install modules and launch frontend.\n   ```\n   pnpm install\n   pnpm run dev\n   ```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eBack to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!--\n## How does it work?\n\n### Request\n\n```sh\ncurl 'https://erp.iitkgp.ernet.in/Acad/timetable_track.jsp?action=second\u0026dept=AE' \\\n    -H 'User-Agent: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:58.0) Gecko/20100101 Firefox/58.0' \\\n    -H 'Content-Type: application/x-www-form-urlencoded' \\\n    -H 'Cookie: JSESSIONID=ABCD.worker3;' \\\n    --data 'for_session=2017-2018\u0026for_semester=SPRING\u0026dept=AE'\n``` --\u003e\n\n## Updation for a new semester\n\n1. Updating `.env` file\n\n\u003e **Note**: Use `.env.template` file as the base for `.env` file.\n\nUpdate the `SESSION` and `SEMESTER` environment variables.\n\n\u003e **Note:** In case you are unable to scrape the new semester's timetable, then, these steps will help you find the problem:\n\u003e\n\u003e 1. Turn on `DEBUG` inside the `.env` file by setting it to `\"1\"`.\n\u003e 2. Reduce the size of the departments array to 2 so that you are not buried with output in the terminal.\n\n2. Run `update_data.sh`.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eBack to top\u003c/a\u003e)\u003c/p\u003e\n\n## Meanings of the various files\n\n### Input Files\n\n- `problems.json`\n\n  JSON file that stores problems reported by users. Sometimes, the ERP might\n  show that course A is scheduled to be held in room B, but later, due to\n  (say) too many students, the course might be moved to a bigger room C. Then,\n  a few nodes can be added to the JSON file without touching other files and\n  the schedule can be regenerated.\n\n### Output Files\n\n- `schedule.json`\n\n  This is JSON file whose keys are the names of the rooms. Each value is a\n  matrix with 5 rows and 9 columns. Each element in the matrix is the subject\n  code of the class that will be held in that room during that one-hour slot.\n  This string can be empty to show that the room will remain empty.\n\n- `empty_schedule.json`\n\n  This is a JSON file that stores a matrix with 5 rows and 9 columns. Each\n  element of the matrix is a list of strings containing the list of rooms that\n  are free during that one hour slot.\n\n- `subjectDetails.json`\n\n  This JSON file is used to show the tooltip with the name of the course and\n  the name of the professors on top of the timetable entry in the chillzone\n  webpage. It is a JSON file where the keys are subject codes and the values are\n  strings with this structure: `\u003cSUBJECT NAME\u003e - \u003cPROFESSOR NAMES\u003e`.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eBack to top\u003c/a\u003e)\u003c/p\u003e\n\n## Development Notes\nThis package utilizes [iitkgp-erp-login-go](https://github.com/metakgp/iitkgp-erp-login-go) package to handle ERP login functionality and fetch timetables.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Maintainer(s)\n\n- [Chirag Ghosh](https://github.com/chirag-ghosh)\n- [Shikhar Soni](https://github.com/shikharish)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eBack to top\u003c/a\u003e)\u003c/p\u003e\n\n## Contact\n\n\u003cp\u003e\n📫 Metakgp -\n\u003ca href=\"https://bit.ly/metakgp-slack\"\u003e\n  \u003cimg align=\"center\" alt=\"Metakgp's slack invite\" width=\"22px\" src=\"https://raw.githubusercontent.com/edent/SuperTinyIcons/master/images/svg/slack.svg\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"mailto:metakgp@gmail.com\"\u003e\n  \u003cimg align=\"center\" alt=\"Metakgp's email \" width=\"22px\" src=\"https://raw.githubusercontent.com/edent/SuperTinyIcons/master/images/svg/gmail.svg\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.facebook.com/metakgp\"\u003e\n  \u003cimg align=\"center\" alt=\"metakgp's Facebook\" width=\"22px\" src=\"https://raw.githubusercontent.com/edent/SuperTinyIcons/master/images/svg/facebook.svg\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.linkedin.com/company/metakgp-org/\"\u003e\n  \u003cimg align=\"center\" alt=\"metakgp's LinkedIn\" width=\"22px\" src=\"https://raw.githubusercontent.com/edent/SuperTinyIcons/master/images/svg/linkedin.svg\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://twitter.com/metakgp\"\u003e\n  \u003cimg align=\"center\" alt=\"metakgp's Twitter \" width=\"22px\" src=\"https://raw.githubusercontent.com/edent/SuperTinyIcons/master/images/svg/twitter.svg\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.instagram.com/metakgp_/\"\u003e\n  \u003cimg align=\"center\" alt=\"metakgp's Instagram\" width=\"22px\" src=\"https://raw.githubusercontent.com/edent/SuperTinyIcons/master/images/svg/instagram.svg\" /\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eBack to top\u003c/a\u003e)\u003c/p\u003e\n\n## Additional documentation\n\n- [License](/LICENSE)\n- [Code of Conduct](/.github/CODE_OF_CONDUCT.md)\n- [Security Policy](/.github/SECURITY.md)\n- [Contribution Guidelines](/.github/CONTRIBUTING.md)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eBack to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\n[contributors-shield]: https://img.shields.io/github/contributors/metakgp/chillzone.svg?style=for-the-badge\n[contributors-url]: https://github.com/metakgp/chillzone/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/metakgp/chillzone.svg?style=for-the-badge\n[forks-url]: https://github.com/metakgp/chillzone/network/members\n[stars-shield]: https://img.shields.io/github/stars/metakgp/chillzone.svg?style=for-the-badge\n[stars-url]: https://github.com/metakgp/chillzone/stargazers\n[issues-shield]: https://img.shields.io/github/issues/metakgp/chillzone.svg?style=for-the-badge\n[issues-url]: https://github.com/metakgp/chillzone/issues\n[license-shield]: https://img.shields.io/github/license/metakgp/chillzone.svg?style=for-the-badge\n[license-url]: https://github.com/metakgp/chillzone/blob/master/LICENSE\n[wiki-shield]: https://custom-icon-badges.demolab.com/badge/metakgp_wiki-grey?logo=metakgp_logo\u0026style=for-the-badge\n[wiki-url]: https://wiki.metakgp.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetakgp%2Fchillzone","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmetakgp%2Fchillzone","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetakgp%2Fchillzone/lists"}