Skip to content

smkrv/ha-metar-weather

Repository files navigation

Logo METAR Weather

hacs_badge GitHub release (latest by date) License: MIT Home Assistant English Русский Deutsch

Professional aviation weather monitoring for Home Assistant. Get real-time METAR data from over 9,000 airport weather stations worldwide with automatic trend analysis and historical tracking.

IMPORTANT NOTICE

⚠️ This integration is NOT certified for aviation navigation or flight planning! METAR data provided is for informational purposes only. Always consult official aviation weather sources and certified flight planning tools for aviation activities.

METAR Weather

Installation

Requirements

  • Home Assistant: Version 2025.2 or higher
  • Internet Connection: Required for METAR data retrieval

Features

METAR Weather — screenshot

Global Coverage

Access real-time weather data from over 9,000 airport weather stations worldwide. The integration supports any airport with an ICAO code that publishes METAR reports.

Comprehensive Weather Data

Every configured station provides a complete set of sensors:

  • Temperature and Dew Point with automatic humidity calculation
  • Wind Speed, Direction and Gusts with variable wind detection
  • Visibility in your preferred units
  • Atmospheric Pressure with QNH support
  • Cloud Coverage including ceiling height and layer information
  • Weather Phenomena such as rain, snow, fog, and thunderstorms
  • Runway Conditions when reported by the station
  • CAVOK Status and trend information
  • Raw METAR String for reference

ℹ️ Note on Runway State Information

Since November 4, 2021, following amendments to ICAO Annexes 3, 14, and 15, the Runway State Group (RSG) has been officially deprecated in METAR reports. Most countries—including EU member states, the United States, Canada, and Australia—have fully transitioned to the SNOWTAM/GRF (Global Reporting Format) system for runway condition reporting. As a result, runway state information is no longer included in METAR for the majority of airports worldwide. Some countries that maintain independent meteorological reporting standards may still include RSG data in their METAR broadcasts.

Intelligent Trend Analysis

The integration tracks historical data and calculates trends automatically:

  • Rising/Falling/Stable indicators for temperature, pressure, humidity
  • Veering/Backing for wind direction changes
  • 24-hour statistics including min, max, and average values
  • Historical data storage with automatic cleanup

Multi-Source Reliability

Data is fetched from official sources with automatic fallback:

  • Primary: Aviation Weather Center REST API (aviationweather.gov)
  • Fallback: NOAA FTP via AVWX (tgftp.nws.noaa.gov)

If the primary source is unavailable, the integration seamlessly switches to the backup source.

Flexible Unit Configuration

Choose your preferred units, use Home Assistant system settings, or native aviation units:

  • Auto: Follow Home Assistant system settings
  • Native (METAR): Standard aviation units (°C, knots, statute miles, hPa, feet)
  • Manual selection:
    • Temperature: Celsius or Fahrenheit
    • Wind Speed: km/h, m/s, mph, or knots
    • Visibility: kilometers, meters, miles, or feet
    • Pressure: hPa, inHg, or mmHg
    • Cloud Height: meters or feet

Multi-Station Support

Monitor as many airports as you need. Each station operates independently with its own update cycle and historical data.

Localization

Full interface translation in:

  • English
  • Russian (Русский)
  • German (Deutsch)

Configuration

  1. Go to Settings > Devices & Services
  2. Click Add Integration
  3. Search for METAR Weather
  4. Enter the ICAO airport code (4 letters, e.g., KJFK, EGLL, UUEE)
  5. Configure your preferred units

Finding Airport Codes

Services

update_station

Force an immediate data update for a specific station:

service: ha_metar_weather.update_station
data:
  station: KJFK

clear_history

Clear stored historical data for a station:

service: ha_metar_weather.clear_history
data:
  station: KJFK

Troubleshooting

Sensors Show "Unknown" or "Unavailable"

  • Verify the ICAO code is correct (exactly 4 uppercase letters)
  • Check if the station is actively reporting at Aviation Weather Center
  • Some smaller airports report intermittently

Enable Debug Logging

Add to your configuration.yaml:

logger:
  logs:
    custom_components.ha_metar_weather: debug

Data Sources

This integration fetches METAR data from two official sources:

Source Description
AWC REST API Aviation Weather Center API
NOAA FTP Traditional FTP source via AVWX

Both sources provide official NOAA/NWS data. The integration automatically falls back to the secondary source if the primary is unavailable. Users must comply with NOAA data usage terms.

Legal Disclaimer

⚠️ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED.

⚠️ CRITICAL: This integration is NOT certified for aviation navigation or flight planning. Always consult official aviation weather sources for aviation activities.

License

Author: SMKRV License: MIT

Support the Project

  • Star the repository on GitHub
  • Report issues with detailed information
  • Suggest new features
  • Help with translations

Financial Support

USDT Wallet (TRC10/TRC20): TXC9zYHYPfWUGi4Sv4R1ctTBGScXXQk5HZ

About

Home Assistant custom integration for METAR weather data. This integration allows you to get detailed weather information from airport weather stations using METAR data.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages