{"id":19680037,"url":"https://github.com/jorricks/calendar-notifications","last_synced_at":"2026-05-15T18:07:35.147Z","repository":{"id":65427660,"uuid":"519457618","full_name":"Jorricks/calendar-notifications","owner":"Jorricks","description":"Get intrusive calendar notifications on your Mac for Zoom meetings with a join button.","archived":false,"fork":false,"pushed_at":"2024-06-20T11:34:38.000Z","size":150,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-02T00:00:00.694Z","etag":null,"topics":["ical","icalendar","macos","notifications","zoom"],"latest_commit_sha":null,"homepage":"https://github.com/Jorricks/calendar-notifications","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jorricks.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-07-30T08:10:37.000Z","updated_at":"2024-08-17T14:08:30.000Z","dependencies_parsed_at":"2023-01-31T03:16:02.017Z","dependency_job_id":null,"html_url":"https://github.com/Jorricks/calendar-notifications","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Jorricks/calendar-notifications","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jorricks%2Fcalendar-notifications","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jorricks%2Fcalendar-notifications/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jorricks%2Fcalendar-notifications/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jorricks%2Fcalendar-notifications/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jorricks","download_url":"https://codeload.github.com/Jorricks/calendar-notifications/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jorricks%2Fcalendar-notifications/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266187076,"owners_count":23889909,"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":["ical","icalendar","macos","notifications","zoom"],"created_at":"2024-11-11T18:03:39.741Z","updated_at":"2026-05-15T18:07:35.105Z","avatar_url":"https://github.com/Jorricks.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Calendar Notifications\nGet intrusive calendar notifications on your Mac for Zoom meetings with auto-join button. \n\n**Currently, only supports:**\n- Platform: Apple macos\n- Calendar: Any iCalendar calendar like Google Calendar.\n- Joinable meeting notifications: Zoom.\n\n**Note:** The implementation is highly extendable for other meeting tools. You'd just have to set up an `AbstractEventStartHandler` for your meeting tool. If you do add another meeting tool, please add a PR :).\n\n## Features\n- ✨ Notifications for meetings \u0026 recurring meetings.\n- ⏱ Notifications for ToDos.\n- 🖱️ Click on the notification to directly join the Zoom meeting.\n\n## Requirements\nThis application was built on two libraries:\n- [iCal-library](https://github.com/Jorricks/iCal-library)\n- [macos-notifications](https://github.com/Jorricks/macos-notifications)\n\nPlease check them out and give them a 🌟. They were made with this project in mind 💡.\n\n## Instructions\nTo use Calendar Notifications, you will need to:\n1. Set up a new venv and install this tool in a new venv\n    \n       python3 -m venv venv/\n       source venv/bin/activate\n       pip3 install calendar-notifications\n\n2. Get the iCalendar URL of your calendar. Instructions can be found in the [iCal-library remote iCalendar documentation section](https://jorricks.github.io/iCal-library/remote-icalendars/).\n3. Enable python notifications. Instructions can be found in the [macos-notification FAQ](https://jorricks.github.io/macos-notifications/faq/).\n4. Start it with `start_calendar_notifications`.\n\n## DISCLAIMER\nThis project was developed after missing several meetings. I was looking for something more intrusive and ended up with this project. I went all-in on making sure it caught 100% of my Zoom meetings and that clicking the notification would immediately join the meeting for me. Although I did some effort productionising this, do not consider this as the holy grail. You might need to tweak it a little. Please file any [issues](https://github.com/Jorricks/calendar-notifications/issues) you encounter or submit a [pull-request](https://github.com/Jorricks/calendar-notifications/pulls) to fix it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjorricks%2Fcalendar-notifications","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjorricks%2Fcalendar-notifications","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjorricks%2Fcalendar-notifications/lists"}