System Bridge is an application that runs on your local machine to share system information via its API/WebSocket. You can also send commands to the device such as opening a URL or sending keyboard keypresses.

Prerequisites

Version

This integration requires System Bridge 4.0.2 and above. Any older version will not work.

Token

You will need your token. For instructions on finding your token, follow the steps in the System Bridge documentation.

Configuration

To add the System Bridge device to your Home Assistant instance, use this My button:

👁 Image

System Bridge can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Binary sensors

This integration provides the following binary sensors:

Sensors

This integration provides the following sensors:

These sensors are also available, but are not enabled by default:

Media player

The integration also provides a media player. This allows you control the currently playing media on your device.

This is currently only supported devices running System Bridge on Windows.

Media source

This integration is available as a media source to use with the media browser integration. You can browse and view media from your system to media players such as your web browser and other supported media players.

Update

The integration provides an update component, which will notify you when a new version of the app is available.

Notifiers

The System Bridge integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] adds a notify entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] for your configured device. To send a notification, you can use the notify.send_message actionActions are used in several places in Home Assistant. As part of a script or automation, actions define what is going to happen once a trigger is activated. In scripts, an action is called sequence. [Learn more]. For more customizable notifications, you can use the notify platform instead. For further instructions on using notifiers in automations, refer to the getting started with automation page.

action: notify.send_message
target:
 entity_id: notify.my_device
data:
 title: "Reminder"
 message: "Have you considered frogs?"

Notifications

You can send notifications to the device using the notify.system_bridge_hostname notify entity.

action: notify.system_bridge_hostname
data:
 data:
 image: "https://brands.home-assistant.io/system_bridge/[email protected]"
 timeout: 30
 actions:
 - command: api
 data:
 endpoint: open
 method: POST
 body:
 url: "http://homeassistant.local:8123/lovelace/cameras"
 label: "OpenCameras"
 audio:
 source: "https://d3qhmae9zx9eb.cloudfront.net/home/amzn_sfx_doorbell_chime_02.mp3"
 volume: 80
 title: "TestTitle"
 message: "Thisisamessage"

Parameters

• target: The target to send the notification to. This can be ignored.
• title: The title of the notification.
• message: The message of the notification.
• data: The data to send to the device. See below for more information.

Actions (data parameter)

This is a list of actions that can be sent to the device. These are buttons that show below the title, message, and image.

• command: The command to send to the device. For example, api sends a request to the System Bridge API.
• label: The label of the button.
• data: The data to send to the device. The available parameters for the api command are endpoint, method, body, and params.

Here is an example action that opens a URL in the device’s browser:

- command: api
 label: "OpenCameras"
 data:
 endpoint: open
 method: POST
 body:
 url: "http://homeassistant.local:8123/lovelace/cameras"

Audio (data parameter)

This is an object containing the source and volume (0-100). The source must be a URL to a playable audio file, such as an MP3.

List of actions

The System Bridge integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.

• Get process by ID (system_bridge.get_process_by_id) Gets a running process from a System Bridge server by its process ID.

• Get processes by name (system_bridge.get_processes_by_name) Gets the running processes from a System Bridge server that match a name.

• Open path (system_bridge.open_path) Opens a file on a System Bridge server with the default application.

• Open URL (system_bridge.open_url) Opens a URL on a System Bridge server with the default application.

• Power command (system_bridge.power_command) Sends a power command to a System Bridge server.

• Send keyboard keypress (system_bridge.send_keypress) Sends a keyboard keypress to a System Bridge server.

• Send keyboard text (system_bridge.send_text) Sends text for a System Bridge server to type.

For an overview of every action across all integrations, see the actions reference.