https://github.com/sycanz/schedulr
A chrome extension that transfers timetable from CLiC to Google Calendar.
https://github.com/sycanz/schedulr
css google-api html icalendar-rfc javascript web-scraping
Last synced: about 1 year ago
JSON representation
A chrome extension that transfers timetable from CLiC to Google Calendar.
- Host: GitHub
- URL: https://github.com/sycanz/schedulr
- Owner: sycanz
- License: gpl-3.0
- Created: 2024-08-11T03:35:20.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-10T20:39:18.000Z (over 1 year ago)
- Last Synced: 2025-03-24T11:12:15.473Z (over 1 year ago)
- Topics: css, google-api, html, icalendar-rfc, javascript, web-scraping
- Language: JavaScript
- Homepage: https://www.mmuschedulr.com/
- Size: 26.1 MB
- Stars: 11
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Schedulr đ
A chrome extension that imports your **MMU CLiC** timetable into Google Calendar and other calendars like Outlook and Apple Calendar.
https://github.com/user-attachments/assets/b9e1409c-e5e3-4159-a5ff-86cfa49d3a7c
## Table of Content
- [Requirements](https://github.com/sycanz04/schedulr?tab=readme-ov-file#requirements-)
- [Installation](https://github.com/sycanz04/schedulr?tab=readme-ov-file#installation-)
- [Usage](https://github.com/sycanz04/schedulr?tab=readme-ov-file#usage-%EF%B8%8F)
- [Import timetable into Google Calendar](https://github.com/sycanz04/schedulr?tab=readme-ov-file#to-import-calendar-into-google-calendar)
- [Import timetable into other calendars](https://github.com/sycanz04/schedulr?tab=readme-ov-file#to-import-calendar-into-other-calendars-like-outlook-apple-calendar)
- [Key Binding](https://github.com/sycanz04/schedulr?tab=readme-ov-file#key-binding-%EF%B8%8F)
- [Linux and Windows](https://github.com/sycanz04/schedulr?tab=readme-ov-file#linux--and-windows-)
- [macOS](https://github.com/sycanz04/schedulr?tab=readme-ov-file#macos-)
- [Project status](https://github.com/sycanz04/schedulr?tab=readme-ov-file#project-status-)
- [Tech Stack](https://github.com/sycanz04/schedulr?tab=readme-ov-file#tech-stack-)
- [Changelog](https://github.com/sycanz04/schedulr?tab=readme-ov-file#changelog-)
- [Privacy policy](https://github.com/sycanz04/schedulr?tab=readme-ov-file#privacy-policy-)
- [License](https://github.com/sycanz04/schedulr?tab=readme-ov-file#license-%EF%B8%8F)
- [Why this project?](https://github.com/sycanz04/schedulr?tab=readme-ov-file#why-this-project-)
- [Buy me a coffee](https://github.com/sycanz04/schedulr?tab=readme-ov-file#buy-me-a-coffee-)
- [Credit](https://github.com/sycanz04/schedulr?tab=readme-ov-file#credit-)
## Requirements đ
- MMU student with **"Active"** current student status **ONLY**.
- Chrome browser **ONLY**.
## Installation đĻ
1. Go to the [extension's page](https://chromewebstore.google.com/detail/schedulr/ofaflpillnejkhmkefmcpoamjeaghipp) or search up "Schedulr" in Chrome Web Store.
2. Click "Add to Chrome".
## Usage đšī¸
Note: Some steps after step 4 may vary depending on your target calendar.
#### For students:
1. Go to "View My Classes/Schedule > By Class" in CliC. ***(Ensure all subjects are expanded)***
2. Open the extension by using the [shortcut key](https://github.com/sycanz04/schedulr?tab=readme-ov-file#key-binding-) or by clicking the extension icon.
3. An authentication window will appear, grant permission for both scopes and then reopen the extension.
#### For lecturers:
1. Go to "Instructor Workstation > My Weekly Schedule" in CLiC.
2. Open the extension by using the [shortcut key](https://github.com/sycanz04/schedulr?tab=readme-ov-file#key-binding-) or by clicking the extension icon.
3. An authentication window will appear, grant permission for both scopes and then reopen the extension.
#### To import calendar into Google Calendar:
4. Select **Transfer to Google Calendar**, then click **Confirm**.
5. Select the semester length: either **Short (7 weeks)** or **Long (14 weeks)**.
6. Select your event format and reminder settings
7. Pick the target calendar. ***(Your main calendar is typically the one linked to your email)***
8. Choose an event colour.
9. Press the **Submit** to transfer timetable to Google Calendar.
#### To import calendar into other calendars (like Outlook, Apple Calendar):
4. Select **Download an .ics file**, then click **Confirm**.
5. Select the semester length: either **Short (7 weeks)** or **Long (14 weeks)**.
6. Select your event format and reminder settings
7. Press the **Submit** to download the .ics file.
8. Go to your target calendar and import the .ics file.
***Tip**: An .ics file lets you import events into other calendar apps like Outlook.*
## Key binding â¨ī¸
The shortcut key opens up the popup page
### Linux đ§ and Windows đĒ
- `Alt+Shift+S`
### macOS đ
- `Command+Shift+S`
## Project status âŗ
Schedulr version 3.0.1 is available on [Chrome Web store](https://chromewebstore.google.com/detail/schedulr/ofaflpillnejkhmkefmcpoamjeaghipp) as of now.
## Tech Stack đ
1. Javascript
2. Google calendar API
3. HTML
4. CSS
## Changelog đ
Detailed changes for each release are documented in the [release notes](https://github.com/sycanz04/schedulr/releases).
## Privacy policy đ
Please read the [Privacy Policy](https://www.mmuschedulr.com/privacy-policy.html) for this extension before proceeding.
## License âī¸
This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](https://github.com/sycanz04/schedulr/blob/main/LICENSE)
## Why this project? đ
Imagine a world where you can automate your life - cool right? I initially created this to save time on manually transferring my timetable but it seems I've spend more time building it than I would have transferring the timetable manually...oh well.
Since this is my first web project, I'd love to hear any suggetions for improvements you might have!
## Buy me a coffee â
I seem to have developed a bit of an addiction to espresso shots, so if you're feeling generous, feel free to [buy me a coffee](https://ko-fi.com/sycanz)!
## Credit đ¤đģ
This project was developed at [Hackerspace MMU](https://hackerspacemmu.rocks/). Also shoutout to a couple of friends who helped me out on this project.