README
homebridge-meteohub
A pretty basic plugin for Homebridge to display Temperature and Humidity for meteohub-connected weatherstations. Currenlty the plugin relies on your locally-connected meteohub 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
- Install homebridge using: npm install -g homebridge
- Install this plugin using: npm install -g homebridge-meteohub
- 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 Meteohub and (b) Meteohub exposes templates for us to take advantage of.
All you need is the IP address and admin password (currenlty not used) for your Meteohub. (Note: The admin password is only used to make the local HTTP 'GET' calls.)
Meteohub References
Sample Configuration
Add the following information to your config.json file:
"accessories": [
{
"accessory": "HomeMeteohub", <-- Our Accessory name
"name": "Meteohub", <-- Easy to remember name
"ip_address": "A.B.C.D", <-- IP address of our meteohub <pick IP OR server; leave the other empty --> "">
"server_address: "your.domain.name" <-- MeteoHub server FQ address <pick server OR IP; leave the other empty --> "">
"port": "1234" <-- Desired Port
"frequency": 5000, <-- Update frequency (5 second min)
"password": "<password>", <-- Admin password for Meteohub <Currently NOT used>
"debug": "true" <-- Display temp/humidity readings in the console
}
]
Field Explainations
"accessory": "HomeMeteohub", <-- Our Accessory name
"name": "Meteohub", <-- Easy to remember name
"ip_address": "A.B.C.D", <-- IP address of our meteobridge
"server_address: "your.domain.name" <-- MeteoHub server FQ address <pick server OR IP; leave the other empty --> "">
"port": "1234" <-- Desired Port
"frequency": 5000, <-- Update frequency (5 second min)
"password": "<password>", <-- Admin password for Meteohub <Currently NOT used>
"debug": "true" <-- Display temp/humidity readings in the console
Things yet to do:
- Add support for other sensors exposed by Meteohub
- Add support for user-defined units
- Add support for forecasted temperatures based on the Lat/Lon found in Meteobridge.
- Add support for password protected access to meteohub
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).
This plugin is a very-close cousin to my homebridge-meteobridge plugin. If you have a meteobridge device, use this plugin.