Overview
MMM-Timeline is a module for MagicMirror² that renders a visual timeline from a start date to the present day. It supports horizontal and vertical layouts, configurable milestones, and dynamic event highlighting from other modules.
Key Features
- Flexible layout — Horizontal or vertical timeline orientation
- Custom milestones — Define events with date, title, and type (default, major, milestone)
- Dynamic highlighting — Other modules can trigger live highlights via notifications
- Auto-updating — Refreshes automatically at configurable intervals
- Clean design — Minimal, modern styling that adapts to any MagicMirror theme
Integration
The module listens for TIMELINE_HIGHLIGHT_DATE notifications, making it compatible with modules like MMM-GDriveAmbient to sync photo dates with timeline markers in real time.
Technical Stack
- Language: JavaScript (ES6)
- Platform: MagicMirror² Module API
- Rendering: Dynamic DOM generation with CSS transitions
- Tooling: ESLint, automated linting
Source Code
Full documentation and installation instructions on GitHub: github.com/CuzImHarry/MMM-Timeline