{"id":23276347,"url":"https://github.com/cesium/calendarium","last_synced_at":"2025-08-21T09:31:28.106Z","repository":{"id":43325898,"uuid":"436665517","full_name":"cesium/calendarium","owner":"cesium","description":"📆 Calendar with special events, due dates and week schedule","archived":false,"fork":false,"pushed_at":"2024-12-15T01:45:02.000Z","size":5694,"stargazers_count":13,"open_issues_count":13,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-12-15T02:27:57.326Z","etag":null,"topics":["hacktoberfest","nextjs","react"],"latest_commit_sha":null,"homepage":"https://calendario.cesium.di.uminho.pt/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cesium.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-09T15:25:26.000Z","updated_at":"2024-11-25T00:37:41.000Z","dependencies_parsed_at":"2023-10-02T19:33:15.290Z","dependency_job_id":"def928d0-83d7-4180-bacd-a68364b10d65","html_url":"https://github.com/cesium/calendarium","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/cesium%2Fcalendarium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cesium%2Fcalendarium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cesium%2Fcalendarium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cesium%2Fcalendarium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cesium","download_url":"https://codeload.github.com/cesium/calendarium/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230504952,"owners_count":18236668,"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":["hacktoberfest","nextjs","react"],"created_at":"2024-12-19T21:31:32.679Z","updated_at":"2024-12-19T21:31:33.377Z","avatar_url":"https://github.com/cesium.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003ca href=\"https://calendario.cesium.di.uminho.pt/\" title=\"Go to Calendarium\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"public/calendarium-dark.svg\"\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"public/calendarium-light.svg\"\u003e\n      \u003cimg alt=\"Calendarium\" height=\"auto\" width=\"800px\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/h1\u003e\n\n[netlify-status]: https://app.netlify.com/sites/cesium-calendarium/deploys\n\n\u003e 📅 Calendar with special events, due dates and week schedule\n\nExams, projects, events and schedules. Your hub to everything LEI, MEI or even MIEI!\n\nAnything out of place? Give us your feedback using the [Suggestions Form](https://forms.gle/C2uxuUKqoeqMWfcZ6)!\n\nYou can also fix it yourself following our [Helping Guide](HELPING_GUIDE.md) ;)\n\n## 🤝 Contributing\n\nWhen contributing to this repository, please first discuss the change you wish to make via discussions, issue, email, or any other method with the owners of this repository before making a change.\n\nPlease note we have a [Code of Conduct](CODE_OF_CONDUCT.md), please follow it in all your interactions with the project.\n\nWe have a [Contributing Guide](CONTRIBUTING.md) to help you getting started.\n\n## 📑 Features\n\n\u003e Here's a quick view of the features you can expect\n\n### Multiple calendar views\n\n- Day\n- Week\n- Month\n\n### Event \u0026 Schedule filtering\n\nSee only the activities that matter to you\n\n### Clear Choices\n\nNew schedule? New subject? Clear all your choices with one click and start again\n\n### Share\n\nShare your schedule or events with another device or with your friends\n\n### Export\n\nExport your calendar or schedule to your favorite calendar app\n\n### Notifications\n\nGet updated on the latest changes to the platform and know when new information is added\n\n### Color Themes\n\nCustomize your calendar view with a choice of themes or create your own!\n\n### Appearance\n\nChoose between beautiful dark and light modes!\n\n## 🔌 Calendar Export API\n\n\u003e Understand how our Export API works, and what you can do with it\n\n### API Endpoints\n\nThere are two endpoints you can work with: `/api/export/events` and `/api/export/schedule`.\n\n**1. `/events`**\n\nThis endpoint is responsible for generating a .ics (iCal) file containing events from the \"Events\" page. It should receive a list of subjects in their short form, similarly to how subjects are displayed in the filters of Calendarium, joined by `\u0026`.\n\nCheck out this example, where we ask the API to generate a file containing the events from the 2nd year / 2nd semester subjects of LEI:\n\n```\nhttps://calendario.cesium.di.uminho.pt/api/export/events?BD\u0026IO\u0026MNOnL\u0026POO\u0026RC\u0026SO\n```\n\n\u003e **Note**  \n\u003e Only the events relevant to the current academic year will be exported. A request with wrongly formatted parameters or subjects that don't exist, will be answered with a \"400 Invalid Request\" error message.\n\n**2. `/schedule`**\n\nThis endpoint is responsible for generating a .ics (iCal) file containing shifts from the \"Schedule\" page, which will have a weekly recurrence rule. It should receive a list of subject-shift pairs, joined by `\u0026`. Similarly to what happens in `/events`, the subject should be represented in its short form. As for the shift, it should be in accordance with the shifts displayed in the filters of Calendarium.\n\nCheck out this example, where we ask the API to generate a file containing a possible schedule for the 3rd year / 1st semester of LEI:\n\n```\nhttps://calendario.cesium.di.uminho.pt/api/export/schedule?CP=T1\u0026CP=TP1\u0026CC=T1\u0026CC=PL1\u0026DSS=T1\u0026DSS=PL1\u0026IA=T1\u0026IA=PL1\u0026LI4=T1\u0026LI4=OT1\u0026SD=T1\u0026SD=PL1\n```\n\n\u003e **Note**  \n\u003e A request with wrongly formatted parameters, or subjects and shifts that don't exist, will be answered with a \"400 Invalid Request\" error message.\n\n### Setting a Time Period for Shifts\n\nAdditionally, it's possible to set an interval in `/schedule` for when a schedule should start and end. This means that you can set a start date and an end date which will delimit when the shifts from your schedule will start and stop showing up on your calendar. For this, you can simply use the parameters `start` and `end`. By default, your schedule will show up on your calendar from the current week onwards, repeating forever.\n\nCheck out this example, where we set the above schedule to start on 11/09/2023 and end on 08/08/2024:\n\n```\nhttps://calendario.cesium.di.uminho.pt/api/export/schedule?CP=T1\u0026CP=TP1\u0026CC=T1\u0026CC=PL1\u0026DSS=T1\u0026DSS=PL1\u0026IA=T1\u0026IA=PL1\u0026LI4=T1\u0026LI4=OT1\u0026SD=T1\u0026SD=PL1\u0026start=2023-09-11\u0026end=2024-08-08\n```\n\n_Note that you can define **just the start, just the end, both or neither**. The parameter you omit will assume the default behaviour._\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcesium%2Fcalendarium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcesium%2Fcalendarium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcesium%2Fcalendarium/lists"}