MagicMirror

Overview MMM-GDriveAmbient is a module for MagicMirror² that displays random photos from a Google Drive folder as an ambient slideshow. It authenticates via a Google Service Account, handles HEIC-to-JPEG conversion server-side, and extracts photo metadata for timeline integration. Key Features Google Drive integration — Fetches random images from a specified folder using a Service Account HEIC/HEIF support — Automatically converts iPhone photos to JPEG for browser compatibility Ambient color theming — Samples the dominant color from each photo and exposes it as a CSS variable (--ambient-color) Timeline sync — Sends date metadata to MMM-Timeline for live timeline highlighting Cached file listing — Reduces API calls with a 5-minute cache Architecture Layer Technology Role Frontend MagicMirror Module API Renders image, samples color, sends notifications Backend Node.js (NodeHelper) Google Drive auth, file download, HEIC conversion Integration Socket notifications Bi-directional frontend ↔ backend communication Technical Stack Runtime: Node.js APIs: Google Drive API v3 (Service Account auth) Libraries: googleapis, heic-convert Communication: MagicMirror socket notifications Source Code Full documentation, installation guide, and source code available on GitHub: github.com/CuzImHarry/MMM-GDriveAmbient

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. ...