Integración domótica System Bridge, gratuita y de código abierto
Your PC through System Bridge: CPU, memory, disks, GPU, battery, sleep and restart buttons.
Publicado por LM1LC3N7
- Dispositivos
- Versión 0.1.1
- Requiere Gladys >=5.1.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
Follow a Windows or Linux PC from Gladys through System Bridge, a free and open source application that runs on the PC: whether it is on, CPU and memory load, disk usage, GPU, battery, users logged in, uptime, camera and microphone in use; and buttons to lock, sleep, hibernate, restart or shut it down, or open a page in its browser.
Unofficial integration, not affiliated with System Bridge. It has never been tested with a real PC yet: please report what you see.
Installation
- Install System Bridge on the PC (Windows or Linux) and start it. It listens on port 9170; let it through the firewall of the PC for your local network only.
- In the settings of System Bridge, copy the API token.
- In Gladys, open this integration and fill in:
- Address of the PC: its IP address or name, e.g.
192.168.1.20(add:portif you changed 9170). Give the PC a fixed address in your router. - Token: the token copied above. It is kept by Gladys in its database, never shown again, sent only to System Bridge, and never written in the logs.
- Address of the PC: its IP address or name, e.g.
- Press Test the connection, then open the Discovery tab and add the PC.
System Bridge has no https: the token and the readings cross your network in clear. Use it on a trusted home network only, never through the Internet.
What you get
One device per PC, named after the PC and identified by its machine id (it survives a rename or a new IP address):
| Feature | Meaning |
|---|---|
| Online | 1 while the PC answers, 0 when it is off, asleep or away |
| CPU (%), CPU | load, and temperature when the PC gives it |
| Memory (%), Memory used | load, and MB used |
| Disk … (%) | usage of each disk (12 at most); system mounts are left out |
| GPU (%), GPU temperature | per graphics card (4 at most), when reported |
| Battery, Charging | laptops only |
| Power | when System Bridge reports it |
| Users logged in, Uptime | sessions open, hours since the last start |
| Camera in use, Microphone in use | 1 while an application uses them |
| Restart pending, System Bridge update available | when reported |
| Lock, Sleep, Hibernate, Restart, Shut down, Open the URL | buttons |
A disk or a GPU seen once stays on the device (it shows no value while it is absent), so that its history is never lost. Under Windows, only NVIDIA cards report a GPU temperature (for the others, Windows gives a zone of the board, not the card).
The PC is read at the pace chosen in Refresh (every minute by default). When it does not answer, Gladys tries again 30 seconds to 5 minutes later, never faster than that pace. The Discovery button shows the last reading when it is more recent than that pace.
Buttons and safety
- Lock locks the session; it is always allowed (it protects the PC), but only while Gladys is connected to that PC (it never opens a connection of its own, so it is refused while System Bridge asked Gladys to slow down).
- Sleep, Hibernate, Restart, Shut down are refused until you tick Allow sleep, hibernate, restart and shut down. Unsaved work on the PC is lost on a restart or a shut down. Never allow them on the PC that runs Gladys itself.
- Open the URL is refused until you tick Allow opening the URL and type an http or https address: it opens that page in the default browser of the PC. Never a file, a path nor a program.
- They are buttons, never switches: no voice assistant nor "turn everything off" scene reaches them. In a scene, use the "set a device value" action on the button.
- Before a sleep, restart, shut down or URL, Gladys reads the PC again and checks it is the same machine. If the check does not fit in Gladys' 5 seconds, nothing is sent. Once sent, if System Bridge does not confirm in time, Gladys says "sent, without confirmation" (it may have run).
- Gladys never sends a command line, keystrokes, a notification, a file nor a path, even though System Bridge accepts them.
When something goes wrong
- The PC does not answer: it is off, asleep, System Bridge is not running, or the firewall blocks port 9170.
- System Bridge refused the token: copy the token again from the settings of System Bridge and save. Gladys does not send a refused token again by itself before 6 hours.
- Does not answer like System Bridge: check the port.
- Slow down: System Bridge (or something in between) answered HTTP 429 or 503; every request is paused (1 minute to 6 hours), even after a restart. The test button lifts the pause.
Privacy
The integration reads only the modules listed above: never the list of processes, the media, the network connections nor the notifications. Names of users, applications using the camera, IP and MAC addresses are never published nor logged.
Parámetros de configuración
Estos son los parámetros que System Bridge te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| How it works | section | No | Install System Bridge (free, open source) on a Windows or Linux PC of your network: Gladys reads it through its local WebSocket API, with its token. The PC becomes a Gladys device (Discovery tab): online, CPU, memory, disks, GPU, battery, users logged in, uptime, and Lock, Sleep, Hibernate, Restart, Shut down and Open the URL buttons. Gladys never sends a command line nor keystrokes. Unofficial integration, not affiliated with System Bridge. |
| Address of the PC | string | Sí | The address of the PC on your network, with the port of System Bridge if it is not 9170: 192.168.1.20 or my-pc.local:9170. System Bridge has no https: the token crosses your network in clear, use it on a trusted network only. |
| Token | secret | Sí | The API token shown in the settings of System Bridge on the PC. Kept by Gladys in its database, never shown again, sent only to System Bridge, in each message. It never appears in the logs. |
| Refresh | select | Sí | How often Gladys reads the PC. When it does not answer (off, asleep), Gladys tries again 30 seconds to 5 minutes later, never faster than this. |
| Commands | section | No | By default Gladys only reads, and locks the session (Lock button). Sleep, Hibernate, Restart and Shut down are refused unless you allow them below; so is Open the URL. They are buttons, never switches: no voice assistant nor "turn everything off" reaches them. Unsaved work on the PC is lost on a restart or a shut down. Never allow them on the PC that runs Gladys itself. |
| Allow sleep, hibernate, restart and shut down | boolean | No | |
| Allow opening the URL | boolean | No | The Open the URL button opens the page below in the default browser of the PC. |
| URL to open (optional) | string | No | An http or https address only (never a file nor a program), without a user name nor password. |
Cómo instalar System Bridge en Gladys
- En Gladys, abre Integraciones: System Bridge aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/lm1lc3n7/gladys-system-bridge:0.1.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/LM1LC3N7/gladys-system-bridge.
System Bridge requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
System Bridge es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene LM1LC3N7, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación