Libre Hardware Monitor smart home integration, free and open source
The sensors of a Windows PC: CPU and GPU temperatures, loads, fans, power.
Published by LM1LC3N7
- Devices
- Version 0.1.1
- Requires Gladys >=5.1.0
- ★ 0
Follow the sensors of a Windows PC in Gladys: CPU and GPU temperatures, loads, fan speeds, power, and, if you wish, clocks, voltages, memory, disks and network throughputs. Gladys reads them through the web server of Libre Hardware Monitor, a free program that runs on the PC.
Unofficial integration, not affiliated with the Libre Hardware Monitor project. It has never been tested with a real PC yet: it was written from the format the reference library reads, and tested against simulated answers. Your feedback is welcome.
What you get
- One device per piece of hardware (CPU, GPU, motherboard, memory, each disk, each network card...), with one read-only feature per sensor.
- One device for the PC, whose "Online" feature is 1 while the PC answers and 0 when nothing answers at all (PC off, asleep, program closed, network down; behind a reverse proxy, its errors 502, 503 and 504): use it in a scene, for example to be told when the PC turns off. An answer with an error (a refused password, another program on the port) keeps it at 1: the PC is on, only its sensors are not read.
- Read only. Gladys sends nothing to the PC but the reading of the sensors: no command, no shutdown, nothing that "turn everything off" or a voice assistant could trigger.
Units: temperatures in °C, power in W, voltages in V, currents in A, memory in GB or MB, throughputs in KB/s, durations in seconds. Gladys has no unit for a load in %, a fan in RPM or a clock in MHz on these sensors: the unit is then written in the name of the feature ("CPU Total Load (%)").
On the PC
- Install Libre Hardware Monitor (0.9.7 or later recommended; older versions work, with less precise values).
- Run it as administrator, or most sensors stay hidden.
- Menu Options → Remote Web Server → Run. The default port is 8085 (Options → Remote Web Server → Port to change it).
- Let the Windows firewall accept incoming connections on this port, at least from the Gladys machine.
- Give the PC a fixed address in your router, so Gladys always finds it.
- Tick Options → Run On Windows Startup if the PC should be followed after every restart.
Authentication (optional)
Libre Hardware Monitor can ask for a user name and a password (Options → Remote Web Server → Authentication). If you set them, type the same in Gladys; leave both fields empty otherwise.
Its web server speaks plain http: the password crosses your network in
clear, readable by any device on it. Use a password of its own, used nowhere
else. In Gladys, the password is a secret field: kept by Gladys in its
database, never shown again, sent only to Libre Hardware Monitor (HTTP Basic
authentication). It is never written to the logs nor to the /data volume
of the integration.
In Gladys
- Install the integration from the store, then open its configuration.
- Address of the PC:
192.168.1.20:8085(a bare address is read as http on port 8085). Behind a reverse proxy:https://host/path; the certificate must then come from a known authority. - Sensors offered: "Essential" (temperatures, loads, fans, power) or "All the sensors". A PC holds hundreds of sensors: start with the essential ones.
- Reading: every 30 s, minute (default), 2 or 5 minutes.
- Save, then press Test the connection: it reads the PC at once and counts its hardware and sensors.
- Open the Discovery tab and create the devices you want.
Changing "Sensors offered" never removes a feature you already created: a device keeps all of its features, and the new ones are offered with "Update".
Limits
- 250 values per minute at most. Gladys accepts 300 states per minute from an integration. Only the values of the devices you created that changed are sent (rounded: 0.1 °C, 1 %, 1 RPM, 0.1 W...). On a big PC read every 30 seconds, values beyond the budget wait for the next minute, the oldest first: every value still arrives, a little later.
- One PC per integration in this version.
- A device offers 200 features at most; a reading is limited to 64 pieces of hardware and 5,000 sensors, and to 8 MB.
- When the PC does not answer, Gladys tries again after the reading interval, then at a growing pace up to every 5 minutes: the "Online" feature may take up to 5 minutes to come back to 1 after a long outage.
- A refused password (HTTP 401) stops the readings until you save the configuration or press "Test the connection": Gladys never tries the same password again by itself.
- An HTTP 429 (too many requests) or a server error (5xx) pauses the readings at least for the reading interval (429: 1 min to 6 h); the pause is kept across a restart of the integration.
- Moving from Libre Hardware Monitor 0.9.4 or older to 0.9.5 or later changes
the id of the motherboard (its chip,
lpc-..., becomesmotherboard), like in Home Assistant: the motherboard appears as a new device in Discovery; delete the old one once the new one is created.
Troubleshooting
| Status | What to check |
|---|---|
| Does not answer | PC on? Libre Hardware Monitor running, web server started (Options → Remote Web Server → Run)? Port open in the Windows firewall? Right address and port? |
| Does not answer like the web server | The port is that of another program, or the web server is off. Open http://<IP>:8085/data.json in a browser: you should see JSON. |
| Asks for a user name and a password | Authentication is on in Libre Hardware Monitor: type the same user name and password in Gladys. |
| Refused the user name or the password | Type them again, save. |
| No sensor | Run Libre Hardware Monitor as administrator; check the hardware ticked in its Options menu. |
Privacy
The integration only talks to the address you type. It reads the names of the hardware of the PC and the names of its network cards, which become names of Gladys devices and features. Nothing leaves your network.
Configuration settings
These are the settings Libre Hardware Monitor asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| How it works | section | No | Gladys reads the sensors of a Windows PC through the web server of Libre Hardware Monitor (free software, on the PC): temperatures, loads, fans, power, clocks, memory, disks. Each piece of hardware (CPU, GPU, motherboard, disk...) becomes a Gladys device (Discovery tab), and the PC a device whose "Online" tells whether it answers. Read only: Gladys sends nothing to the PC but the reading. In Libre Hardware Monitor: Options, Remote Web Server, Run (port 8085); run it as administrator to see every sensor. Unofficial integration, not affiliated with the Libre Hardware Monitor project. |
| Address of the PC | string | Yes | The address of the PC on your network and the port of the web server: <IP>:8085. A bare address is read as http on port 8085; with http:// or https:// and no port, port 80 or 443 (a reverse proxy, a path is kept). Give the PC a fixed address in your router. |
| Authentication (optional) | section | No | Only when the web server of Libre Hardware Monitor asks for a user name and a password (Options, Remote Web Server, Authentication): type the same here. Leave both empty otherwise. The web server of Libre Hardware Monitor speaks plain http: the password crosses your network in clear, readable by any device on it. Use a password of its own, used nowhere else. |
| User name | string | No | |
| Password | secret | No | Kept by Gladys in its database, never shown again, sent only to Libre Hardware Monitor, in the Authorization header (HTTP Basic authentication). |
| Sensors and refresh | section | No | A PC holds hundreds of sensors. The Discovery tab offers, per piece of hardware, either the essential ones (temperatures, loads, fans, power) or all of them (clocks, voltages, memory, throughputs...). The values of the devices you create are sent when they change, 250 per minute at most: beyond that, the oldest values go first. |
| Sensors offered | select | Yes | |
| Reading | select | Yes |
How to install Libre Hardware Monitor in Gladys
- In Gladys, open Integrations: Libre Hardware Monitor appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/lm1lc3n7/gladys-libre-hardware-monitor:0.1.1), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/LM1LC3N7/gladys-libre-hardware-monitor.
Libre Hardware Monitor requires Gladys >=5.1.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
Libre Hardware Monitor is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by LM1LC3N7, not by the Gladys core team.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation