Home Assistant custom integration for Weather Underground personal weather station users.
Includes a native Home Assistant Weather Entity and a variety of weather sensors.
Current conditions are generated from the wundergroundpws configured pws_id.
Forecast is generated from the Home Assistant configured latitude/longitude.
The wundergroundpws platform uses Weather Underground as a source for current weather information.
đź‘Ť If you find this software useful, feel free to make a donation: Paypal.me Donation Link
Weather Underground PWS API Key
Description of terms and variables
Please review the minimum requirements below to determine whether you will be able to install and use the software.
- wundergroundpws v1.1.X requires Home Assistant Version 2023.1 or greater
- wundergroundpws v1.0.2 requires Home Assistant Version 2022.11 or greater
- Registered and active Weather Underground personal weather station API key
Free API keys are only issued to registered and active Weather Underground personal weather station users.
To use this integration, you need a Weather Underground personal weather station API key and Station ID.
To get a free API key:
- You must have a personal weather station registered and uploading data to Weather Underground.
a) Join weather Underground
b) Sign In
c) My Profile -> My Weather Stations
d) Add a New PWS - get API key at https://www.wunderground.com/member/api-keys.
Please consider this when using the following information.
Download the latest v1.X.X release zip file from this repository. Extract the zip file to a temporary directory.
Stop Home Assistant. If you do not stop the Home Assistant instance, changes to the sensors in configuration.yaml will cause a restart failure, and you will have to reboot the device.
Copy the custom_components directory from the extracted file into your .homeassistant directory
and the www directory from the extracted file into your .homeassistant directory.
or
copy the contents of the custom_components directory from the extracted file into an existing custom_components directory in your .homeassistant directory
and the contents of the www directory from the extracted file into an existing www directory in your .homeassistant directory.
To add Wundergroundpws to your installation, add the following to your configuration.yaml file:
# Example configuration.yaml entry
# REQUIRED
wundergroundpws:
api_key: YOUR_API_KEY
pws_id: YOUR_STATION_ID
# Required to generate HASS weather Entity for weather forecast card
weather:
- platform: wundergroundpws
# Required if you wish to add sensors
sensor:
- platform: wundergroundpws
monitored_conditions:
- temp
- dewpt
- heatIndexRestart Home Assistant
UPGRADE NOTE v1.1.0: BREAKING CHANGE - Requires Home Assistant v 2023.1 or later.
UPGRADE NOTE v1.0.0: BREAKING CHANGE - Requires Home Assistant v 2022.11 or later.
UPGRADING FROM v0.8.X REQUIRES SIGNIFICANT CHANGES TO CONFIGURATION.YAML.
See "Example configuration.yaml entry" above.
TO UPGRADE:
- Stop Home Assistant. If you do not stop the Home Assistant instance, changes to the sensors in configuration.yaml will cause a restart failure, and you will have to reboot the device.
- Delete contents of existing "custom_components/wundergroundpws" directory.
- Download the latest v1.X.X release zip file from this repository.
- Extract v1.X.X zip file and copy the contents of the "custom_components/wundergroundpws" directory into the existing "custom_components/wundergroundpws" directory.
- Modify your configuration.yaml, to resemble the "Example configuration.yaml entry" above.
- Restart Home Assistant.
- Existing sensors in any entity cards should be the same.
- In lovelace, add a "weather forecast" card selecting the "weather.YOUR_STATION_ID" entity and save.
wundergroundpws:
api_key:
description: The API key for Weather Underground. See above for details.
required: true
type: string
pws_id:
description: You must enter a Personal Weather Station ID.
The station id will be used to display current weather conditions.
Note - Case Sensitive. Must match the ID of your Wunderground device in member settings.
required: true
type: string
numeric_precision:
description: Optional - Show PWS data as integer or decimal.
Only applies to PWS current values (not forecast) in sensors (not weather entity).
required: false - Value of 'none' or 'decimal'
type: string
default: none
calendarday_temp:
USE AT YOUR OWN RISK - Undocumented in The Weather Company PWS observations API:
description: Optional - if true, retrieve Forecast temperature max/min relative
to calendar day (12:00am -> 11:59pm) as opposed to API period (~7:00am -> ~6:59am).
Only affects the weather entity forecast values, not the sensors.
This field is undocumented in The Weather Company PWS API,
so it is subject to change and if removed from API response in the future, will crash the integration if set true.
required: false - Value of 'true' or 'false'
type: boolean
default: false
lang:
description: Specify the language that the API returns. The current list of all
Wunderground language codes is available at
https://docs.google.com/document/d/13HTLgJDpsb39deFzk_YCQ5GoGoZCO_cRYzIxbwvgJLI/edit
or at the Localization bookmark below.
If not specified, it defaults to English (en-US).
required: false
type: string
default: en-US
latitude:
description: Latitude coordinate for weather forecast (required if **longitude** is specified).
required: false
type: string
default: WU API lat of stationId
longitude:
description: Longitude coordinate for weather forecast (required if **latitude** is specified).
required: false
type: string
default: WU API lon of stationId monitored_conditions:
# description: Conditions to display in the frontend. The following conditions can be monitored.
# required: true
# type: list
# default: symbol
# See https://www.wunderground.com/about/data) for Weather Underground data information.
#
# Observations (current)
dewpt:
description: Temperature below which water droplets begin to condense and dew can form
elev:
description: Elevation
heatIndex:
description: Heat index (combined effects of the temperature and humidity of the air)
humidity:
description: Relative humidity
neighborhood:
description: WU PWS reference name
obsTimeLocal:
description: Text summary of local observation time
precipRate:
description: Rain intensity
precipTotal:
description: Today Total precipitation
pressure:
description: Atmospheric air pressure
solarRadiation:
description: Current levels of solar radiation
stationID:
description: Your personal weather station (PWS) ID
temp:
description: Current temperature
uv:
description: Current levels of UV radiation.
windChill:
description: Wind Chill (combined effects of the temperature and wind)
winddir:
description: Wind degrees
windDirectionName:
description: Wind cardinal direction (N, NE, NNE, S, E, W, etc)
windGust:
description: Wind gusts speed
windSpeed:
description: Current wind speed
# Forecast
precip_1d:
description: Forecasted precipitation intensity. (Variations _1d, _2d, _3d, _4d, _5d)
precip_chance_1d:
description: Forecasted precipitation probability in %. (Variations _1d, _2d, _3d, _4d, _5d)
precip_chance_1n:
description: Forecasted precipitation probability in %. (Variations _1n, _2n, _3n, _4n, _5n)
temp_high_1d:
description: Forecasted high temperature. (Variations _1d, _2d, _3d, _4d, _5d)
temp_low_1d:
description: Forecasted low temperature. (Variations _1d, _2d, _3d, _4d, _5d)
weather_1d:
description: A human-readable weather forecast of Day. (Variations _1d, _2d, _3d, _4d, _5d)
weather_1n:
description: A human-readable weather forecast of Night. (Variations _1n, _2n, _3n, _4n, _5n)
wind_1d:
description: Forecasted wind speed. (Variations _1d, _2d, _3d, _4d, _5d)All the conditions listed above will be updated every 5 minutes.
Wunderground API caveat:
The daypart object as well as the temperatureMax field OUTSIDE of the daypart object will appear as null in the API after 3:00pm Local Apparent Time.
The affected sensors will return as "N/A" when this condition is met.
Conditions above marked with [1d] are daily forecasts. To get forecast for different day, replace the number
in _1d_ part of the sensor name. Valid values are from 1 to 5.
Conditions above marked with [1n] are nightly forecasts. To get forecast for different night, replace the number
in _1n_ part of the sensor name. Valid values are from 1 to 5.
sensor:
- platform: wundergroundpws
monitored_conditions:
- precip_1d
- precip_2d
- precip_3d
- precip_4d
- precip_5d
- precip_chance_1d
- precip_chance_1n
- precip_chance_2d
- precip_chance_2n
- precip_chance_3d
- precip_chance_3n
- precip_chance_4d
- precip_chance_4n
- precip_chance_5d
- precip_chance_5n
- temp_high_1d
- temp_high_2d
- temp_high_3d
- temp_high_4d
- temp_high_5d
- temp_low_1d
- temp_low_2d
- temp_low_3d
- temp_low_4d
- temp_low_5d
- wind_1d
- wind_2d
- wind_3d
- wind_4d
- wind_5d
- weather_1d
- weather_1n
- weather_2d
- weather_2n
- weather_3d
- weather_3n
- weather_4d
- weather_4n
- weather_5d
- weather_5nNote: While the platform is called “wundergroundpws” the sensors will show up in Home Assistant as “WUPWS” (eg: sensor.wupws_weather_1d).
Additional details about the API are available here.
wundergroundpws data returned to weather entity (HASS weather forecast card):
Current:
- temperature
- pressure
- humidity
- wind_speed
- wind_bearing
Forecast:
- datetime
- temperature (max)
- temperature (low)
- condition (icon)
- precipitation
- precipitation_probability
- wind_bearing
- wind_speed
The following are wundergroundpws sensors exposed to the statistics card in Lovelace.
Note that only sensors of like units can be combined in a single card.
-
class NONE
-
sensor.wupws_uv
-
class DEGREE
-
sensor.wupws_winddir
-
class RATE & SPEED
-
sensor.wupws_precipRate
-
sensor.wupws_windGust
-
sensor.wupws_windSpeed
-
class LENGTH
-
sensor.wupws_precipTotal
-
class PRESSURE
-
sensor.wupws_pressure
-
class HUMIDITY
-
sensor.wupws_humidity
-
class IRRADIANCE
-
sensor.wupws_solarRadiation
-
class TEMPERATURE
-
sensor.wupws_dewpt
-
sensor.wupws_heatIndex
-
sensor.wupws_windChill
-
sensor.wupws_temp
wundergroundpws:
api_key: YOUR_API_KEY
pws_id: YOUR_STATION_ID
weather:
- platform: wundergroundpws
sensor:
- platform: wundergroundpws
monitored_conditions:
- dewpt
- elev
- heatIndex
- humidity
- neighborhood
- obsTimeLocal
- precip_1d
- precip_2d
- precip_3d
- precip_4d
- precip_5d
- precip_chance_1d
- precip_chance_1n
- precip_chance_2d
- precip_chance_2n
- precip_chance_3d
- precip_chance_3n
- precip_chance_4d
- precip_chance_4n
- precip_chance_5d
- precip_chance_5n
- precipRate
- precipTotal
- pressure
- solarRadiation
- stationID
- temp
- temp_high_1d
- temp_high_2d
- temp_high_3d
- temp_high_4d
- temp_high_5d
- temp_low_1d
- temp_low_2d
- temp_low_3d
- temp_low_4d
- temp_low_5d
- today_summary
- uv
- weather_1d
- weather_1n
- weather_2d
- weather_2n
- weather_3d
- weather_3n
- weather_4d
- weather_4n
- weather_5d
- weather_5n
- wind_1d
- wind_2d
- wind_3d
- wind_4d
- wind_5d
- windChill
- winddir
- windDirectionName
- windGust
- windSpeedSensor "friendly names" are set via translation files.
Wundergroundpws translation files are located in the 'wundergroundpws/wupws_translations' directory.
Files were translated, using 'en.json' as the base, via https://translate.i18next.com.
Translations only use the base language code and not the variant (i.e. zh-CN/zh-HK/zh-TW uses zh).
The default is en-US (translations/en.json) if the lang: option is not set in the wundergroundpws config.
If lang: is set (i.e. lang: de-DE), then the translations/de.json file is loaded, and the Weather Underground API is queried with de-DE.
The translation file applies to all sensor friendly names, EXCEPT wupws_weather_1d(n) through wupws_weather_5d(n).
wupws_weather_1d(n) through wupws_weather_5d(n) translations are supplied by the Weather Underground API.
Available lang: options are:
'am-ET', 'ar-AE', 'az-AZ', 'bg-BG', 'bn-BD', 'bn-IN', 'bs-BA', 'ca-ES', 'cs-CZ', 'da-DK', 'de-DE', 'el-GR', 'en-GB',
'en-IN', 'en-US', 'es-AR', 'es-ES', 'es-LA', 'es-MX', 'es-UN', 'es-US', 'et-EE', 'fa-IR', 'fi-FI', 'fr-CA', 'fr-FR',
'gu-IN', 'he-IL', 'hi-IN', 'hr-HR', 'hu-HU', 'in-ID', 'is-IS', 'it-IT', 'iw-IL', 'ja-JP', 'jv-ID', 'ka-GE', 'kk-KZ',
'km-KH', 'kn-IN', 'ko-KR', 'lo-LA', 'lt-LT', 'lv-LV', 'mk-MK', 'mn-MN', 'mr-IN', 'ms-MY', 'my-MM', 'ne-IN', 'ne-NP',
'nl-NL', 'no-NO', 'om-ET', 'pa-IN', 'pa-PK', 'pl-PL', 'pt-BR', 'pt-PT', 'ro-RO', 'ru-RU', 'si-LK', 'sk-SK', 'sl-SI',
'sq-AL', 'sr-BA', 'sr-ME', 'sr-RS', 'sv-SE', 'sw-KE', 'ta-IN', 'ta-LK', 'te-IN', 'ti-ER', 'ti-ET', 'tg-TJ', 'th-TH',
'tk-TM', 'tl-PH', 'tr-TR', 'uk-UA', 'ur-PK', 'uz-UZ', 'vi-VN', 'zh-CN', 'zh-HK', 'zh-TW'
Weather Entity (hass weather card) translations are handled by Home Assistant and configured under the user -> language setting.