I’m excited to announce my new MagicMirror module, MMM-BirthdayCalendarCountdown! This module listens for calendar events (via the "CALENDAR_EVENTS" notification) and filters them based on a configurable keyword (defaulting to "birthday"). It then displays upcoming birthday events on your MagicMirror along with a live countdown timer for events that occur within a configurable window (default is 7 days).

Features

• Customizable Keyword Filtering:
  Easily filter calendar events for birthdays (or any other event type by changing the search keyword).

• Live Countdown:
  Watch as the countdown for each upcoming birthday updates in real time.

• Clean, Stylish Display:
  Comes with a dedicated CSS file for a neat and modern look.

• Configurable Options:
  Adjust the update interval, countdown window, maximum events displayed, and search keyword to suit your needs.

How It Works

The module listens for the "CALENDAR_EVENTS" notification from your calendar module. It filters events based on the title, then sorts and displays the upcoming birthdays. If an event is within the specified countdown window, a live countdown (days, hours, minutes, seconds) is shown right below the event details.

Installation & Setup

1. Clone or Download the Repository:
   Clone the repository into your MagicMirror modules directory:

   cd ~/MagicMirror/modules
   git clone https://github.com/wlans/MMM-BirthdayCalendarCountdown.git
   

2. Configure the Module:
   Add the following entry to your config/config.js file:

   {
     module: "MMM-BirthdayCalendarCountdown",
     position: "top_left",  // or any other region you prefer
     config: {
       updateInterval: 1000,       // Refresh display every second
       countdownStartDays: 7,      // Show countdown for events within 7 days
       maxDisplay: 5,              // Display up to 5 upcoming events
       searchKeyword: "birthday"   // Change this keyword to filter different event types
     }
   },
   

3. Ensure You Have a Calendar Module:
   Make sure your MagicMirror setup includes a calendar module that sends out the "CALENDAR_EVENTS" notification with the proper event format (each event must include at least a title and startDate).

4. Customize the Look:
   The module comes with a CSS file (MMM-BirthdayCalendarCountdown.css) to provide styling. Feel free to tweak it to match your mirror’s theme.

Demo

Check out the GitHub repository for further documentation:
https://github.com/wlans/MMM-BirthdayCalendarCountdown

Feedback & Contributions

I’d love to hear your feedback or see improvements from the community. If you run into any issues, have ideas for new features, or just want to say hi, please open an issue or a pull request on GitHub!

Happy mirroring!

Cheers,
wlans