A module for MagicMirror² that displays live satellite imagery of our planet as a beautiful globe on your mirror.

Fork of LukeSkywalker92/MMM-Globe, originally created by Luke Scheffler. His elegant idea of using CSS clip-path: circle() to turn square satellite images into a globe is the heart of this module. Thank you, Luke!

Four SLIDER perspectives — GeoColor imagery from four geostationary satellites, each with day/night visualization and city lights:

From left to right: GOES-19 (Americas), Meteosat (Europe/Africa), GOES-18 (Pacific), Himawari (Asia/Australia)

The original MMM-Globe module has been unmaintained since 2021 but worked perfectly fine for years — until February 2026, when EUMETSAT discontinued their static image server at eumetview.eumetsat.int. This broke the European satellite styles (europeDiscNat, europeDiscSnow) that many European MagicMirror users relied on.

EUMETSAT migrated to a new dynamic platform at view.eumetsat.int, but this is a JavaScript web application — there are no static image URLs to point the module at. EUMETSAT does however offer a WMS (Web Map Service) endpoint that can deliver satellite images in geostationary projection — perfect for globe display (see Using EUMETSAT WMS below).

Additionally, the CIRA SLIDER service operated by NOAA/RAMMB at Colorado State University provides Meteosat full-disk imagery as PNG tiles, including the excellent GeoColor product — natural color during the day and city lights on a Blue Marble background at night. This makes for a particularly stunning globe display around sunrise and sunset.

This fork adds both options, plus a coastline/border overlay, image saving, configurable logging, and numerous bugfixes. The architecture has been completely refactored in v3.0.0: all image fetching now runs server-side in the node_helper, the frontend is a pure display layer, and all styles share a single download pipeline.

Navigate into your MagicMirror's modules folder and execute:

git clone https://github.com/rkorell/MMM-Globe.git

No additional dependencies are needed — the module uses only Node.js built-in modules.

Add the following to your config.js:

{
    module: "MMM-Globe",
    position: "lower_third",
    config: {
        style: "geoColorEurope", // see Available Styles below
        imageSize: 600,
        enableImageSaving: false,
        logLevel: "ERROR"        // "ERROR", "WARN", "INFO", "DEBUG"
    }
},

For the Americas view with night city lights:

config: {
    style: "geoColorUSA",
    imageSize: 600
}

These styles use the CIRA SLIDER API and auto-poll every 60 seconds. They only download when a new image is available (typically every 10-15 minutes depending on the satellite).

Note: If you were using europeDiscNat or europeDiscSnow, switch to geoColorEurope — it provides the same Meteosat satellite view of Europe and Africa, with the bonus of a beautiful nighttime visualization. The old meteosat style name still works as an alias.

EUMETSAT's WMS endpoint at view.eumetsat.int can deliver satellite images in geostationary projection, which displays as a perfect globe with MMM-Globe's CSS circle clipping. Combined with the coastlines: "europe" underlay, this effectively recreates the discontinued europeDiscNat imagery — the old EUMETSAT static images had the same kind of coastline/border overlay baked in. Use the ownImagePath option with a WMS GetMap URL:

config: {
    ownImagePath: "https://view.eumetsat.int/geoserver/wms?service=WMS&version=1.1.0&request=GetMap&layers=msg_fes:rgb_naturalenhncd&bbox=-6500000,-6500000,6500000,6500000&width=600&height=600&srs=AUTO:42003,9001,0,0&styles=&format=image/png&BGCOLOR=0x000000",
    imageSize: 600,
    updateInterval: 15 * 60 * 1000,
    coastlines: "europe",
    logLevel: "INFO"             // see new images in pm2 logs
}

The key parameter is srs=AUTO:42003,9001,{longitude},0 — this geostationary projection centered on the satellite's longitude produces a round Earth disc. Set BGCOLOR=0x000000 for a black background.

Some useful WMS layers:

The msg_fes layers update every 15 minutes, mtg_fd layers every 10 minutes. Set updateInterval accordingly.

Note: Coastlines are only applied for static styles. SLIDER styles (geoColorEurope, geoColorUSA, etc.) already include natural coastlines in their GeoColor imagery — the overlay is automatically suppressed.

The coastlines option adds a subtle underlay of coastlines and country borders beneath the satellite image. Three pre-rendered PNG overlays (1200×1200, downscaled for thinner lines) are included, each in the correct geostationary projection:

• "europe" — centered at 0° longitude (Meteosat perspective)
• "americas" — centered at -75.2° longitude (GOES-16 perspective)
• "asia" — centered at 140.7° longitude (Himawari-8 perspective)

The underlay uses CSS mix-blend-mode: lighten, which means the coastlines are only visible where the satellite image is dark (night side or black background). On the bright day side, the satellite image dominates completely. This creates a natural effect where borders fade in as the Earth rotates into night.

The coastline data comes from Natural Earth (ne_10m_coastline + ne_boundary_lines_land) via the EUMETSAT WMS background layers.

The module uses a clean backend/frontend separation. The frontend knows nothing about remote URLs, polling, or image saving — it only displays what the backend provides.

Backend (node_helper.js) — all image fetching runs server-side for consistent logging in pm2 and to avoid CORS issues. Three methods with clear responsibilities:

• pollSlider (SLIDER styles: geoColorEurope/USA/Pacific/Asia): Polls the CIRA SLIDER API every 60 seconds for the configured satellite, compares the latest timestamp with the previously known one, and triggers a download only when a new image is available. On error or timeout, retries after retryDelay.
• pollStatic (all other styles + ownImagePath): Triggers a download at each updateInterval. Covers all built-in styles (geoColor, natColor, airMass, fullBand, europeDisc*, centralAmericaDiscNat) as well as custom URLs via ownImagePath.
• downloadAndServe (shared by both polling methods): Downloads the image, writes it to images/current.png, and sends the local file path to the frontend. When enableImageSaving is true, a timestamped copy is also saved. Duplicate detection uses SLIDER timestamps (filename-based) for meteosat and MD5 content hashes for all other styles. All HTTP requests have timeouts (15s for API calls, 30s for image downloads) to prevent stalled polling chains.

Frontend (MMM-Globe.js) — pure display layer. On start, immediately loads current.png if it exists (instant recovery after browser refresh). Receives image path updates from the backend, loads them into an <img> element, and renders with CSS clip-path: circle(). Optionally adds a coastline underlay via CSS mix-blend-mode: lighten (static styles only — SLIDER styles have natural coastlines).

• Four SLIDER perspectives: GeoColor imagery from four geostationary satellites — geoColorEurope (Meteosat), geoColorUSA (GOES-19), geoColorPacific (GOES-18), geoColorAsia (Himawari). All provide the same beautiful day/night visualization with city lights.
• Backwards compatible: The old meteosat style name continues to work as an alias for geoColorEurope.
• Frontend self-recovery: The frontend now loads current.png immediately on start, providing instant display after browser refresh without waiting for the next backend poll cycle.
• Coastlines for static styles only: The coastlines overlay is automatically suppressed for SLIDER styles, which already have natural coastlines in the GeoColor imagery.

Complete refactoring of the module's internal architecture. The frontend and backend responsibilities are now cleanly separated:

• Single download pipeline: All image fetching consolidated into one shared downloadAndServe() method used by both SLIDER and static polling. Previously, different styles used different fetch paths with duplicated logic, and some paths downloaded images twice (once for display, once for saving).
• Frontend is display-only: The frontend (MMM-Globe.js) no longer fetches images, manages URLs, or knows about enableImageSaving. It receives a local file path from the backend and displays it. All polling, downloading, saving, and error handling runs in the backend (node_helper.js).
• HTTP timeouts: All HTTP requests now have timeouts (15s for API calls, 30s for image downloads). Previously, a stalled HTTP connection could block the entire polling chain indefinitely.
• Configurable logging (logLevel): Four levels (ERROR, WARN, INFO, DEBUG) with an unconditional startup message. Default is ERROR (silent operation). All logging happens in the backend (visible in pm2 logs), not in the Electron browser console.
• Coastline/border underlay: Configurable coastlines option with three pre-rendered overlays (europe, americas, asia) in the correct geostationary projection for each satellite view.

• Meteosat via CIRA SLIDER (style: "meteosat"): Full-disk GeoColor imagery of Europe/Africa with day/night visualization
• EUMETSAT WMS support: Use ownImagePath with WMS GetMap URLs in geostationary projection
• Image saving for all styles: enableImageSaving works for all styles, not just meteosat
• Smart SLIDER polling: Polls every 60s but only downloads when a genuinely new image is available

• europeDiscSnow hi-res URL mismatch: The original had a key mismatch between imageUrls (europeDiscSnow) and hiResImageUrls (europePartSnow). Using europeDiscSnow with imageSize > 800 silently failed. Both keys are now consistent.
• Mixed content (HTTP → HTTPS): All RAMMB image URLs updated from http:// to https://.
• Loose equality operators: All == / != replaced with strict === / !==.
• Cache-buster for URLs with query string: The original appended ?timestamp as a cache-buster, which broke URLs that already contain a ? (such as WMS URLs). Now correctly uses & when a query string is already present.
• Startup reliability: Image loading moved out of getDom() into the backend polling loop with automatic retry on failure, so the globe appears even when the network isn't ready at boot time.
• Double image downloads: When enableImageSaving was enabled, images were downloaded twice — once for display, once for saving. Now a single download serves both purposes.
• No HTTP timeouts: The original had no timeouts on HTTP requests. A stalled connection (e.g., unresponsive image server) would silently stop all polling. Now enforced at 15s/30s.
• loadImage as global function: The original's loadImage() function was defined in the global scope, risking name collisions with other modules. Now scoped as _loadImage() inside the module.
• europeDiscNat height hack: Removed a hard-coded height adjustment in getDom() that was specific to the discontinued europeDiscNat style's non-square image format.
• Silent frontend failures: Image load errors in the frontend were swallowed silently. Now logged via Log.warn().

• .gitignore consolidated, images/ directory excluded
• Screenshot link changed to absolute GitHub URL
• package.json updated for fork

The module polls the SLIDER API for four geostationary satellites:

The polling mechanism is identical for all satellites:

1. Query https://slider.cira.colostate.edu/data/json/{sat}/full_disk/geocolor/latest_times.json for available timestamps
2. Take the most recent timestamp (e.g., 20260227123000)
3. Construct the tile URL: https://slider.cira.colostate.edu/data/imagery/2026/02/27/{sat}---full_disk/geocolor/20260227123000/00/000_000.png

Zoom level 00 returns the full disk as a single 464×464 PNG tile — perfect for MMM-Globe's CSS circle clipping. All four satellites provide the GeoColor product with natural daytime colors and city lights on a Blue Marble background at night.

The geostationary projection AUTO:42003,9001,{lon},0 maps the visible Earth disk as seen from a geostationary satellite at the given longitude. This produces a circular Earth image that works perfectly with the module's clip-path: circle() styling.

• Luke Scheffler (@lukecodewalker on the MagicMirror forum) for creating MMM-Globe. The original module's design — a simple, elegant idea that turns satellite imagery into a globe using pure CSS — is what makes this module so appealing. This fork builds on his work.
• CIRA / RAMMB at Colorado State University for providing the SLIDER satellite imagery service, freely available to the public.
• EUMETSAT for providing the WMS endpoint and Natural Earth background layers used for the coastline underlay.

MIT — see LICENCE.