Skip to content
MagicMirror module that displays METAR and FAA delay data for airports in the continental U.S.
JavaScript CSS
Branch: master
Clone or download
stuloh Various small fixes
* Now trims whitespace around each airport in the config.airports list (so you can write "SFO, SJC, JFK" or "SFO , SJC , JFK" instead of "SFO,SJC,JFK" if you like)
* Displays wind CALM without a direction if wind at 0 knots
* Delay time will now specify whether it's a "min", "avg" or "max" delay (FAA doesn't always provide all three numbers, so we use the largest provided)
* Left-align table cells even if module used in right column of MagicMirror
* Minor edits to Readme file
Latest commit c6b478a Jan 17, 2017

Module: Aviation Weather (MMM-aviationwx)

This is a module for MagicMirror.

MMM-aviationwx displays aviation weather information (METAR data) for continental U.S. airports on your MagicMirror. If the FAA tracks delay information for that airport, it will also note if there are any current delays and the reason for the delay if the airport has provided one.

The module includes hyperlinks and tooltips that are generally not accessible with a Raspberry PI installation, but will work if you have mouse control (which is more often the case if you run Magic Mirror on another OS, such as macOS).




  1. Navigate to your MagicMirror modules directory.
  2. Execute git clone
  3. Add the module to your MagicMirror's config.js file (see next section).

Using the Module

To use this module, add it to the modules array in the config/config.js file:

modules: [
        module: 'MMM-aviationwx',
        header: 'Aviation Weather',
        position: 'top_left',
        config: {
            airports: 'KSFO,PAO,HAF,JFK', // 3-char or 4-char codes, U.S. only
            updateInterval: 10, // update interval in minutes


  • position: See MagicMirror documentation for usage.
  • header: Optional. See MagicMirror documentation for usage.
  • config.airports: Comma delimited list of continental U.S. airport codes (no spaces). Supports 3-character FAA codes (which are mostly the same as 3-character IATA codes) or 4-character ICAO codes.
  • config.updateInterval: How often the module will pull new data in minutes. Airports generally only update every 60 minutes. Additionally, because of how the Aviation Weather Center provides METAR data, each update pulls down the data for most airports in the continental U.S., so I suggest going easy on the update frequency.


  • If there is a ceiling, it will show the height in hundreds of feet and whether it's a broken or overcast layer. If there's no ceiling, it will just show the type of highest cloud cover: few, scattered, human-generated clear sky (SKC), automated clear sky (CLR).
  • The time displayed at the end of each weather summary is the time of the last weather report (converted to your local time)
  • Hover over weather summary for raw METAR data.
  • Click on airport code for TAF data.
  • For links and tooltips to work, ensure another module is not 'covering' MMM-aviationwx (check your relative z-index).
  • If there's an airport delay, the module will send a notification to the alert module that is included by default with MagicMirror.

Potential Improvements / TODOs

  • Decoding of wx (+RA, BR, etc.) to English or icons
  • Decoding of delay abbreviations (VOL, etc.)
  • Support for AK, HI and Canadian airports
  • General code and technique clean up


MMM-aviationwx is licensed under the Apache License, Version 2.0.

You can’t perform that action at this time.