Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

homebridge-weather-station-extended

naofireblade81MITdeprecated1.2.3

WARNING: This project has been renamed to homebridge-weather-plus. Install using homebridge-weather-plus instead.

A comprehensive weather station plugin for homekit with current observations and forecasts.

homebridge-plugin, weather-station, weather, weather forecast, forecast, observations, history, weather history, temperature, air pressure, humidity, precip, rain, rain chance, wind, wind speed, wind direction, uv index, solar radiation, visiblity, weather condition

readme

homebridge-weather-station-extended

npm npm GitHub last commit Weather

This is a weather station plugin for homebridge that features current observations, daily forecasts and history graphs. You can download it via npm.

If you update from a version before 1.2.0 and want to see the history graphs, you have to remove and reinstall the eve app. Your devices and rules will remain unchanged.

Feel free to leave any feedback here.

Current Observations

The following current observation values can be displayed and used in HomeKit rules. Use a 3rd party app like Elgato Eve to see all values, translations and some nice icons.

  • Temperature
  • Air Pressure
  • Relative Humidity
  • Rain Last Hour
  • Rain All Day
  • UV-Index
  • Solar Radiation
  • Visibility
  • Weather Condition
  • Weather Condition Category (Sun = 0, Clouds = 1, Rain = 2, Snow = 3)
  • Wind Direction
  • Wind Speed
  • Wind Speed Maximum
  • Observation Station
  • Observation Time

Forecast

The plugin also features a daily forecast for today and the next 3 days. The following forecast values can be displayed.

  • Temperature
  • Temperature Minimum
  • Relative Humidity
  • Chance Rain
  • Rain All Day
  • Weather Condition
  • Weather Condition Category
  • Wind Direction
  • Wind Speed
  • Wind Speed Maximum

History

With the eve app you can view the history for

  • Temperature
  • Air Pressure
  • Relative Humidity

Installation

  1. Install homebridge using: npm install -g homebridge
  2. Install this plugin using: npm install -g homebridge-weather-station-extended
  3. Gather a free developer key for Weather Underground here.
  4. Update your configuration file. See the samples below.

Configuration

Add the following information to your config file. Make sure to add your API key and provide your city or postal code in the location field.

Simple

"platforms": [
    {
        "platform": "WeatherStation",
        "name": "Weather Station",
        "key": "XXXXXXXXXXXXXXX",
        "location": "78613"
    }
]

Advanced

The following config contains advanced optional settings that must not be specified.

The parameter interval sets the interval (minutes) in which the weather will be updated from Weather Underground. The default value is 4 minutes, which fits in the maximum of 400 updates per day for free accounts.

The parameter forecast sets which forecasts you want to see. You can set one of these three values: none, today, 3days. The default value is 3days.

You can also use a station from the Personal Weather Station Network to receive weather information. Just enter pws:YOURID in the location parameter.

"platforms": [
    {
        "platform": "WeatherStation",
        "name": "Weather Station",
        "key": "XXXXXXXXXXXXXXX",
        "location": "pws:ICALIFOR123",
        "interval": "4",
        "forecast": "3days"
    }
]

Example use cases

  • Switch on a blue light in the morning when the chance for rain is above 20% today (or white when the forecast condition is snow / yellow when it's sunny).
  • Start your automatic garden irrigation in the evening depending on the amount of rain today and the forecast for tomorrow.

Hint: To trigger rules based on time and weather condition you will need a plugin like homebridge-delay-switch. Create a dummy switch that resets after some seconds. Set this switch to on with a timed rule. Then create a condition rule that triggers when the switch goes on depending on weather conditions of your choice.

Screenshots

Current Conditions in Elgato Eve app History graph in Elgato Eve app

(c) Screenshots are taken from the Elgato Eve app

Contributors

Many thanks go to

This plugin is a fork of homebridge-weather-station which is no longer being developed. That one is a fork of homebridge-wunderground.

changelog

0.1.0

  • Added characteristics for precip 1 hour, precip today, wind direction, wind speed, air pressure, visibility, uv-index and station
  • Added condition category for sunny weather
  • Renamed condition values to condition categories
  • Changed condition category values
  • Changed service to temperature-sensor so that the device is recognized by apple home app

0.1.2

  • Added optional parameter "interval"
  • Added debug library

1.0.0

  • Added forecast for today
  • Added forecast for next three days
  • Added configuration for forecast
  • Added observation time
  • Added chance for rain
  • Added wind speed max
  • Changed plugin type to platform

1.0.1

  • Changed names of accessories

1.0.2

  • Fixed config example in readme

1.0.3

  • Added screenshot to description

1.0.4

  • Added condition solar radiation
  • Added log output of API response to identify function

1.1.0

  • Added forecast temperature minimum

1.1.1

  • Fixed negative temperatures shown as 0°C

1.1.2

  • Fixed handling of sometimes flawed weather underground responses

1.2.0

  • Added history in eve app for temperature, relative humidity and air pressure

1.2.1

  • Added persistence for history to handle homebridge restarts
  • Fixed history has gaps with interval greater than 10 minutes

1.2.2

  • Fixed mix-up between air pressure and relative humidity

1.2.3

  • Fixed a crash on startup