0.0.4 • Published 5 years ago

homebridge-meteobridge v0.0.4

Weekly downloads
3
License
MIT
Repository
github
Last release
5 years ago

homebridge-meteobridge

A pretty basic plugin for Homebridge to display Temperature and Humidity for meteobridge-connected weatherstations. Currenlty the plugin relies on your locally-connected meteobridge to relay and display weather station data (temperature and humidity) to the Home App.

Special Note: As with most things in HomeKit, you can ask Siri on your iOS (or HomePod) device to read out the temp and/or humidity based on how you setup your devices in the Home App.

Quick Installation

  1. Install homebridge using: npm install -g homebridge
  2. Install this plugin using: npm install -g homebridge-meteobridge
  3. Update your configuration file to reflect your local conditions (see the sample below)

No keys, or APIs required. We just rely on the fact that (a) You have a weather station on your local network connected through a Meteobridge and (b) Meteobridge exposes templates for us to take advantage of.

All you need is the IP address and admin password for your Meteobridge. (Note: The admin password is only used to make the local HTTP 'GET' calls.)

Meteobridge References

  1. Meteobridge Templates
  2. Meteobridge Add-On Services
  3. Try this if you don't know your Meteobridge's IP address.

Sample Configuration

Add the following information to your config.json file:

"accessories": [
    {
      "accessory": "HomeMeteobridge",
      "name": "Meteobridge",
      "ip_address":  "A.B.C.D",
      "frequency": 5000,
      "password": "<password>",
      "debug": "true"
    }
]

Field Explainations

"accessory": "HomeMeteobridge", <-- Our Accessory name
"name": "Meteobridge",          <-- Easy to remember name
"ip_address":  "A.B.C.D",       <-- IP address of our meteobridge
"frequency": 5000,              <-- Update frequency (5 second min)
"password": "<password>",       <-- Admin password for Meteobridge
"debug": "true"                 <-- Display console messages [valid entries: 'true' || 'false']

Things yet to do:

  • Add support for other sensors exposed by Meteobridge (e.g., pressure, wind, rain, solar, etc.) v0.0.4
  • Add support for user-defined units
  • Add support for forecasted temperatures based on the Lat/Lon found in Meteobridge.
  • Add support for battery status v0.0.2
  • Add support for updaing sensor info with Meteobridge specifics (e.g., Model #, Firmware Version, etc.) v0.0.2
  • Add support for active and inactive status v0.0.2
  • Add support for elgato history v0.0.3
  • Add support for more descriptive console messages v0.0.3
  • Add support for Wind Speed (Currently only displayed in the 'Eve App') v0.0.4
  • Add support for Ultra Violet Index (Currently only displayed in the 'Eve App') v0.0.4
  • Add support for Air Pressure and History (Currently only displayed in the 'Eve App') v0.0.4
  • Stability and bug fixing v0.0.4

Credits

This plugin was heavily influenced by the Thorsten Voß's plugin:homebridge-wunderground. With Wunderground likely becoming inaccessible as a free service in the not-so-distant future, I chose to make this "local" version for people to use (if they have a Meteobridge-connected weather station, of course).