This add-on allows you to control your Home Assistant instance via a Stream Deck, making it easier than ever to manage your smart home devices and scenes 🏠. The add-on is highly customizable and configured using YAML files. It runs on the same machine as Home Assistant and supports Linux-based supervised Home Assistant installations. Check out the GitHub repository for more details.
- Easy to use 😄
- Highly customizable 🔧
- Runs on the same machine as Home Assistant 🏠
- Supports Linux-based supervised Home Assistant installations 🐧
- YAML configuration 📁
- Template support for advanced customization 🔥
- Automatically syncs state of
entity_id
to turn display on/off 💤
streamdeck-addon-gh.mp4
To install the add-on, follow these steps:
-
Click the Home Assistant "My ADD-ON" button below to open the add-on on your Home Assistant instance.
-
Install the
home-assistant-streamdeck-yaml
add-on.
or
- Go to Supervisor -> Add-on store -> Add new repository by URL and fill in
https://github.com/basnijholt/home-assistant-streamdeck-yaml-addon
. - Install the
home-assistant-streamdeck-yaml
add-on.
There are two ways to configure the add-on:
Depending on your setup, the required configuration parameters may vary:
streamdeck_config: /config/streamdeck.yaml
streamdeck_config: /config/streamdeck.yaml
websocket_protocol: wss
hass_host: 192.168.1.2
hass_token: YOUR_LONG_LIVED_ACCESS_TOKEN
The configuration file includes the following parameters:
- 📄
streamdeck_config
: The path to your Stream Deck configuration YAML file. - 🔒
websocket_protocol
: The WebSocket protocol to use (ws
for unsecured,wss
for secured). - 🏠
hass_host
(optional): The IP address of your Home Assistant instance. If not provided, the add-on will automatically use the IP address of the host running the add-on. - 🔑
hass_token
(optional): The long-lived access token for your Home Assistant instance. If not provided, the add-on will automatically use the Supervisor API token.
An example add-on configuration using a .env
file is shown below:
streamdeck_dotenv: /config/streamdeck.env
The configuration file includes the following parameter:
streamdeck_dotenv
: The path to your.env
file containing the necessary configuration values (e.g.,HASS_HOST
,HASS_TOKEN
,STREAMDECK_CONFIG
, andWEBSOCKET_PROTOCOL
).
.env
file, you must include all of the configuration parameters in the .env
file, and all the other configuration parameters are ignored.
Refer to the .env
file example for more details.
Create a configuration.yaml
file for your Stream Deck buttons following the example configuration from the home-assistant-streamdeck-yaml
repository.
Once you have installed and configured the add-on, it will automatically run and display your configured buttons on your Stream Deck.
If you have any issues or need support, please create an issue on the GitHub repository.
This project is licensed under the MIT License - see the LICENSE file for details.