A customizable MagicMirror² module for counting down to birthdays, holidays, anniversaries, appointments, trips, and other events.
The nearest event is presented as a stable, live days/hours/minutes/seconds countdown with an optional emoji. A rotating, days-only summary of the later upcoming events fades in and out beneath it; the active main event is excluded from that rotation.
Features
Displays the nearest upcoming event as the main countdown.
Shows days, hours, minutes, and seconds.
Offers digital, flip-clock, progress-ring, and hourglass counter styles.
Rotates through days-only summaries of later upcoming events without repeating the active main event.
Supports fixed dates, calculated Easter dates, and weekday-based rules.
Repeats events annually by default.
Supports one-time events with repeatYearly: false.
Displays an optional emoji for the main event and its rotating summary.
Screenshot
[image: 1787944285206-mmm-eventcountdown.gif]
Installation and usage instructions are in the project’s README.md
Project origins
This project combines and extends ideas from two open-source MagicMirror modules:
TouaregWarrior/MMM-HolidayCountdown provides the original holiday/trip countdown module on which this project is based.
double-ratchet/MMM-AnimatedCountdowns, by ElliAndDad, provides the basis for the digital, flip, progress-ring, and hourglass counter styles adapted here.
The resulting module adds four selectable counter styles, rotating event summaries, reusable yearly events, one-time events, movable-date rules, calculated Easter dates, and per-event emojis.