Skip to content

Latest commit

 

History

History
36 lines (27 loc) · 2.11 KB

README.md

File metadata and controls

36 lines (27 loc) · 2.11 KB
Raw

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:

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.

  3. Enable python notifications. Instructions can be found in the macos-notification 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 you encounter or submit a pull-request to fix it.