TvOverlay UI for Home Assistant (Marketplace integration)

Installs: 157 sharing analytics
GitHub stars: 15
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: 1.0.9, July 24, 2026
Category: Messaging and notifications, Push notifications
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: tvoverlay_ui
Source: github.com/manjotsc/ha-tvoverlay_ui
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

TvOverlay UI connects Home Assistant to the TvOverlay app on an Android TV and works over the local network. It adds actions to send a notification, send a persistent fixed notification, and clear a fixed notification on the TV. Switches cover the clock, notifications, fixed notifications, pixel shift and debug mode, while number entities set visibility of the clock, overlay and fixed notifications and the notification duration. Selects handle the hot corner and the default shape, and sensors report active fixed notifications, hostname and IP address, with a connectivity binary sensor. Each device gets a stable identifier that stays the same after removing and re-adding the integration, so automations keep working. Setup is done in the UI with the device host, port and a name.

Automatic summary of the README and code of manjotsc/ha-tvoverlay_ui. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Set up TvOverlay UI

HostIP address or hostname of the TvOverlay device
PortPort number (default: 5001)
Device NameFriendly name for this device
Device IdentifierA stable unique ID used in automations and service calls. This ID remains the same even if you delete and re-add the integration, preventing broken automations. Leave empty to auto-generate from device name. Only lowercase letters, numbers, and underscores allowed.

After setup

Host
Port
Device IdentifierA stable unique ID used in automations and service calls. Changing this will break existing automations that reference this device. Only lowercase letters, numbers, and underscores allowed.

Texts from the code of manjotsc/ha-tvoverlay_ui.

Entities

Binary sensorsConnectivity
NumbersClock Visibility, Overlay Visibility, Fixed Notifications Visibility, Notification Duration
SelectsHot Corner, Default Shape
SensorsActive Fixed Notifications, Hostname, IP Address
SwitchesDisplay Clock, Display Notifications, Display Fixed Notifications, Pixel Shift, Debug Mode

Actions

Send NotificationSend a notification to a TvOverlay device.Fields: Device (Dropdown), Device Identifier (Stable), Host, Title, Message, Small Icon, Small Icon Color, Large Icon, Media Type, Media URL
Send Fixed NotificationSend a persistent fixed notification to a TvOverlay device.Fields: Device (Dropdown), Device Identifier (Stable), Host, Notification ID, Icon, Message, Message Color, Icon Color, Border Color, Background Color
Clear Fixed NotificationClear a fixed notification by setting it invisible.Fields: Device (Dropdown), Device Identifier (Stable), Host, Notification ID

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

Set during initial setup or via the Configure button
Use lowercase letters, numbers, and underscores only
Auto-generated from device name if left empty

From the README of manjotsc/ha-tvoverlay_ui, MIT License. Shortened.