homebridge-glances

Homebridge Glances plugin

This Homebridge plugin platform exposes the temperature sensors, cpu load and memory load from Glances Monitoring Tool as accessoires to homebridge.

Installation

npm install -g homebridge-glances

You need to install Glances on your target system and start it in server mode, which is done via the paramater -w. Start the Glances server with your own configuration. See -> Configuration Docs. You can also put aliases to you sensors there, so on default they have generic names like 'it3451' etc. Following Plugins are supported:

• sensors -> Temperature data
• cpu -> Cpu load
• mem -> Memory load

Annotation : The cpu loads and memory loads are exposed as HumidityService, because the loads are in percent value, the HumidityService.CurrentRelativeHumidity characteristic was the best option for that.

Example:

[sensors]
#enable it
disable=False 
#alias for 'it3451'
it3451_alias=CoreTemp1

[cpu]
#enable it
disable=False 
[...]

[mem]
#enable it
disable=False 
[...]

Homebridge configuration

To enable the platform in homebridge add the following to the config:

platforms:
[
    {
        "name":  "Glances",
        "platform":  "Glances",
        "hostname":  "{IP},
        "updateInterval":  3000,
        "prefix":  "{PREFIX}",
        "sensors": true,
        "cpu": true,
        "memory": true
    }
]

following parameters are defined:

Property	Utilization	Default Value	Description
name	required	Glances	The name handled by homebridge
platform	required	Glances	Required to identify the platform
hostname	required		The ip or hostname of your target system where glances server is running
port	optional	61208	The port of your target system where glances server is running
updateInterval	optional	5000	The update interval in milliseconds to update the sensors, ATTENTION values below 1000 may slow down your homebridge or target system
prefix	optional		A prefix to identify the exposed accessories better
sensors	optional	false	Enables the sensors plugin to be exposed
cpu	optional	false	Enables the cpu plugin to be exposed
memory	optional	false	Enables the memory plugin to be exposed

Release Notes

Version 1.0.0

• Initial Version

Version 1.0.1

• Some small fixes

Version 1.0.2

• made it all asynch
• changed from StaticPlatform to DynamicPlatform (for async reasons)
• better error handling
• logs

Future plans:

• add support for multiple hosts
• more plugins for glances to expose network and filesystem