MeteoLux Integration for Home Assistant

This is a custom integration for Home Assistant that provides weather information from MeteoLux, the national meteorological service of Luxembourg.

The integration fetches data from the official MeteoLux API and provides both current weather conditions and detailed forecasts including hourly and daily forecasts.

Features

• Current Weather: Real-time weather conditions including temperature, humidity, pressure, wind speed/direction, and visibility.
• Hourly Forecast: Up to 48 hours of detailed hourly weather forecasts.
• Daily Forecast: Up to 5 days of configurable daily weather forecasts.
• Weather Warnings: A dedicated sensor for vigilance/weather warnings.
• Comprehensive Weather Data: Precipitation, cloud coverage, and detailed weather descriptions.
• Automatic Fallback: Falls back to a legacy CSV data source if the main API is unavailable.

Installation

HACS (Home Assistant Community Store)

1. Go to HACS -> Integrations.
2. Click on the 3 dots in the top right corner and select "Custom repositories".
3. Add the URL of this repository (https://github.com/koosoli/MeteoLux-for-Home-Assistant) and select "Integration" as the category.
4. Click "Add".
5. The "MeteoLux" integration will now be available to install. Click "Install".
6. Restart Home Assistant.

Configuration

1. Go to Settings -> Devices & Services.
2. Click the + Add Integration button.
3. Search for "MeteoLux" and click on it.
4. The integration will be added and a weather entity and several sensors will be created.
5. To change the number of forecast days, go to the integration's card on the Devices & Services page and click "Configure".

Provided Entities

Weather

• weather.meteolux_weather: A weather entity that provides current conditions and forecasts.
  • Supports both hourly and daily forecasts (configurable from 1 to 5 days).
  • Provides current temperature, humidity, pressure, wind data, and visibility.
  • Automatically maps weather conditions to Home Assistant icons.

Sensors

The integration provides a variety of sensors, including:

• sensor.meteolux_vigilance_level: Displays the current highest weather warning level. Attributes contain details of the warning.
• sensor.meteolux_max_temperature: The maximum temperature forecast for the current day.
• sensor.meteolux_min_temperature: The minimum temperature forecast for the current day.
• Per-day forecast sensors: For each configured forecast day, sensors are created for:
  • Max/Min Temperature
  • Condition
  • Precipitation
  • Wind Speed, Gusts, and Direction
• Status sensors: sensor.meteolux_last_update, sensor.meteolux_data_source, etc.

Data Sources

This integration uses multiple data sources for maximum reliability:

1. Primary: MeteoLux API - Provides comprehensive current weather and forecast data
2. Fallback: Open data CSV from data.public.lu - Provides daily forecast periods

The integration automatically tries the primary API first and falls back to the CSV data source if needed, ensuring continuous operation.

API Compliance

This integration complies with the High Value Dataset (HVD) Implementing Regulation (EU) 2023/138 and uses free access to real-time meteorological data from Luxembourg.