https://github.com/jorricks/calendar-notifications
Get intrusive calendar notifications on your Mac for Zoom meetings with a join button.
https://github.com/jorricks/calendar-notifications
ical icalendar macos notifications zoom
Last synced: 6 months ago
JSON representation
Get intrusive calendar notifications on your Mac for Zoom meetings with a join button.
- Host: GitHub
- URL: https://github.com/jorricks/calendar-notifications
- Owner: Jorricks
- License: mit
- Created: 2022-07-30T08:10:37.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-06-20T11:34:38.000Z (over 1 year ago)
- Last Synced: 2025-06-02T00:00:00.694Z (7 months ago)
- Topics: ical, icalendar, macos, notifications, zoom
- Language: Python
- Homepage: https://github.com/Jorricks/calendar-notifications
- Size: 146 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Calendar Notifications
Get intrusive calendar notifications on your Mac for Zoom meetings with auto-join button.
**Currently, only supports:**
- Platform: Apple macos
- Calendar: Any iCalendar calendar like Google Calendar.
- Joinable meeting notifications: Zoom.
**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 :).
## Features
- ✨ Notifications for meetings & recurring meetings.
- ⏱ Notifications for ToDos.
- 🖱️ Click on the notification to directly join the Zoom meeting.
## Requirements
This application was built on two libraries:
- [iCal-library](https://github.com/Jorricks/iCal-library)
- [macos-notifications](https://github.com/Jorricks/macos-notifications)
Please check them out and give them a 🌟. They were made with this project in mind 💡.
## Instructions
To use Calendar Notifications, you will need to:
1. Set up a new venv and install this tool in a new venv
python3 -m venv venv/
source venv/bin/activate
pip3 install calendar-notifications
2. 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/).
3. Enable python notifications. Instructions can be found in the [macos-notification FAQ](https://jorricks.github.io/macos-notifications/faq/).
4. Start it with `start_calendar_notifications`.
## DISCLAIMER
This 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.