TronbytAssistant

KO | EN

gitlite — search

#python #hacktoberfest #go #android #machine-learning #rust #linux #docker #nodejs #java #cli #vue #mcp #openai

TronbytAssistant

(★ 9)

Send custom apps, notifications or plain text to a Tronbyt device from HomeAssistant!

TronbytAssistant Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# TronbytAssistant

Display notifications from Home Assistant to Tronbyt devices using this integration.

# Installation

## HACS
You can add this repository to HACS if you have it installed by adding this link to your custom repository (click the 3 dots at the top right):
```txt
https://github.com/tronbyt/TronbytAssistant
```
Then just search for TronbytAssistant and install the integration. You will have to restart HomeAssistant.

This is the recommended installation method since HACS will prompt you when an update is available.

## Manual
Copy the entirety of `custom_components/tronbytassistant` to your `/config/custom_components` folder. You can do this using ***Samba***.

## Configuration
1. Navigate to **Settings → Devices & Services → Add Integration** and search for **TronbytAssistant**.
2. Enter the full base URL of your Tronbyt server (include `http://` or `https://`, e.g. `https://tron.example.com`) and your user API key. The same key works for every device on that server.
3. Confirm the flow. The integration will fetch `/v0/devices`, create entities for each device automatically, and update service selectors in Home Assistant.

# Features

## Entities
- Brightness (`light`)
- Update Interval (`number`)
- Pinned App (`select`)
- Night Mode (`switch`)
- Night Mode Start (`time`)
- Night Mode End (`time`)
- Night Mode Brightness (`light`)
- Night Mode App (`select`)
- Dim Mode Start (`time`)
- Dim Mode Brightness (`light`)
- Enable App (`toggle`) for each app (disabled by default)

## Services
### TronbytAssistant: Push
1. Select the radio button for *Built-in*.
2. Use the *Content* dropdown to select from the built in notifications served by your Tronbyt backend.
3. Select your device(s) and run the action.

### TronbytAssistant: Text
1. Select the radio buttom for *Text*
2. In the *Content* box, enter the text you want displayed. You can also select from the avaialble fonts and colors as well as static text or scrolling.
3. Select your device(s) and run the action. You should see your text on the screen.
   
### TronbytAssistant: Delete
1. Enter the content ID of the app you published and device name.
2. Select you device(s) and run the action. The app should now be removed from your rotation.
3. If the app you tried to delete is not installed on the Tronbyt, you will see a list of apps that are available for deletion. Only apps that you have sent through Home Assistant will show up for deletion.

# Things to note
## Passing arguments
Passing arguments to your app can be helpful because it removes the need to hard code values. It also allows you to pass in templated values directly to your apps. The following example is taken from the Pixlet docs and is how you would use these varibles inside your app:
```
def main(config):
    who = config.get("who")
    print("Hello, %s" % who)
```
This example has a varible "who", which can be used as the **key=value** pair **who=me** which will pass the value **me** into your star app. Here is an example I use for the Movie Night app, which has two varibles **time** and **title** and uses HomeAssistant's template values:
```
  ... other service data here
  arguments: >-
    time={{ (now().strftime('%Y-%m-%d') + 'T' +
    states('input_datetime.movie_night_time') + now().isoformat()[-6:]) 
    }};title={{ states('input_text.movie_night_movie') }}
```

# Troubleshooting
The action should do a few checks when you run it and give feedback on what went wrong. If you need deeper details, check the logs on your Tronbyt server as well as Home Assistant's logs for HTTP errors.

TronbytAssistant

TronbytAssistant Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

TronbytAssistant

TronbytAssistant Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README