System Bridge Smart-Home-Integration, kostenlos und Open Source
Your PC through System Bridge: CPU, memory, disks, GPU, battery, sleep and restart buttons.
Veröffentlicht von LM1LC3N7
- Geräte
- Version 0.1.1
- Erfordert Gladys >=5.1.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
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.
Konfigurationseinstellungen
Diese Einstellungen fragt System Bridge in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| How it works | section | Nein | 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 | Ja | 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 | Ja | 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 | Ja | 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 | Nein | 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 | Nein | |
| Allow opening the URL | boolean | Nein | The Open the URL button opens the page below in the default browser of the PC. |
| URL to open (optional) | string | Nein | An http or https address only (never a file nor a program), without a user name nor password. |
So installierst du System Bridge in Gladys
- Öffne in Gladys Integrationen: System Bridge erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/lm1lc3n7/gladys-system-bridge:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-system-bridge.
System Bridge benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
System Bridge ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation