Home Assistant
System Bridge integrates with Home Assistant, so you can monitor and control your machine from your Home Assistant instance. The integration uses a local push connection and is maintained by the System Bridge author.
Prerequisites
Section titled “Prerequisites”- A running System Bridge backend. See Running.
- Your API token. See how to find your token.
Adding the integration
Section titled “Adding the integration”System Bridge can be auto-discovered by Home Assistant. When an instance is found, it appears under Settings > Devices & services as a discovered device, ready to set up.
To add it manually:
- In Home Assistant, go to Settings > Devices & services.
- Select Add Integration and choose System Bridge.
- Enter the host and your token when prompted, then follow the on-screen steps.
Features
Section titled “Features”The integration exposes your system as sensors, a media player, and a set of actions, plus notifications and update tracking.
Sensors
Section titled “Sensors”Sensors report system information such as battery, CPU speed, memory, load, displays, filesystems, GPU usage, processes, and version details. Many are enabled by default, with additional CPU and GPU sensors (temperatures, clock speeds, fan speed, and more) available to enable manually.
Binary sensors
Section titled “Binary sensors”Binary sensors report on/off states such as whether the battery is charging, the camera is in use, a reboot is pending, or a new version is available.
Media player
Section titled “Media player”Control currently playing media on your device from Home Assistant. Media player support is currently limited to devices running System Bridge on Windows.
Media source
Section titled “Media source”Browse and play media from your system through the Home Assistant media browser and supported media players.
Update
Section titled “Update”An update entity notifies you when a new version of System Bridge is available.
Notifications
Section titled “Notifications”Send rich notifications to your device, including a title, message, image, action buttons, and audio.
Actions
Section titled “Actions”Trigger actions on the machine running System Bridge:
- Get a process by its ID, or get processes by name.
- Open a path or a URL with the default application.
- Send a keypress or type text.
- Send a power command such as
sleep,lock,restart, orshutdown.
Next steps
Section titled “Next steps”- Read the official integration documentation for entity names, action parameters, and examples.
- Connect to System Bridge directly with the API and WebSocket.