Version 2.3.1 adds Poster canvas width (100–200%). 100% preserves the square layout; larger values extend the background sideways while preserving the sharp poster's size within the image. With Remote 3's Zoom artwork enabled, try 125–150% and tune to its artwork slot. Actual cropping depends on the remote's layout; this setting does not directly change widget margins.
In Display and artwork, or the device's configuration controls, enable Blurred poster background to fit a sharp TMDB poster inside a square with a blurred, edge-darkened background. Portrait and landscape images are supported. Enable Channel logo over programme poster for a large TiviMate channel logo across the bottom of a selected programme poster. These independent switches default to off; neither changes the artwork priority. Choose TMDB poster in the TiviMate artwork priority to use the overlay. Other apps can use the blurred background for TMDB posters, but do not receive a channel logo.
Image processing runs in a background worker and results are cached. A missing or unsupported channel logo leaves the poster intact. Update the integration files and restart Home Assistant to register the new image route and controls.
A Home Assistant custom media-player facade designed for Unfolded Circle Remote 3.
It combines media metadata from an existing Home Assistant player with Android TV app detection and event-driven TiviMate metadata from the companion Shield observer.
- Standard media title, artist, duration, position, volume and artwork fields
- App-specific names and fallback logos
- Optional TMDB programme artwork
- Passive, event-driven TiviMate channel and programme detection
- Persistent last-known TiviMate metadata
- XMLTV channel-logo matching and automatic programme rollover
- Background XMLTV parsing with a bounded schedule window
- Optional channel-logo scaling for Remote 3
- Local light/dark Home Assistant brand artwork
- Open HACS in Home Assistant.
- Open the three-dot menu and select Custom repositories.
- Add
https://github.com/IainDMC/remote3_display. - Select Integration as the category.
- Install Remote 3 Media Display.
- Restart Home Assistant.
HACS installs the component under:
/config/custom_components/remote3_display/
New installations are configured from Settings → Devices & services → Add integration → Remote 3 Media Display. Existing YAML installations remain supported.
After setup, open the integration and select Configure to manage:
- artwork preference, fallback, icon size, canvas and background
- programme progress, title, channel and next-programme fields
- observer retention, stale threshold and inactive behaviour
- XMLTV rollover, refresh interval, bounded history/future windows and guide gaps
- strict/safe matching, channel aliases, suffix and superscript cleanup
- TMDB scope, language, confidence and excluded programme categories
- advanced ADB polling and TiviMate resource IDs
The integration also creates buttons to refresh the EPG, clear artwork caches, reset retained TiviMate data, and test observer freshness.
Install updates from HACS, then restart Home Assistant. GitHub releases are used as the integration versions presented by HACS.
Version 2.0.1 automatically imports the existing
media_player: - platform: remote3_display YAML block:
- Install the update and restart Home Assistant while the old YAML block is still present.
- Open Settings → Devices & services → Remote 3 Media Display. The imported
GUI entry uses the current YAML values, including values resolved through
!secret. - Open Configure and confirm the settings.
- Remove or comment out the old YAML block and restart again. The GUI entry then becomes the only source of configuration.
The import uses the existing values only when the GUI entry is first created. Later GUI changes are not overwritten if the old YAML block is accidentally left in place.
Private values entered in the integration UI are stored in Home Assistant's
config-entry storage. YAML users can continue using !secret.
For responsive detection without ADB polling, use tivimate_mode: webhook and the
companion TiviMate Observer accessibility service on the NVIDIA Shield. The webhook
is local-only and the observer listens only to TiviMate package ar.tvplayer.tv.
The observer source and installation guide are included in
tivimate-observer/. Each GitHub release includes a
ready-to-sideload TiviMateObserver-1.0.0.apk. HACS installs the Home Assistant
integration only; install the APK separately on the Shield.
- The integration domain remains
remote3_display; the display name changed without breaking existing YAML. - XMLTV sources refresh at startup and at most every six hours.
- Programme schedules retain entries overlapping the previous 6 hours and next 48 hours.
tivimate_channel_icon_scale: 75centers a 75% channel logo on a transparent canvas while leaving other artwork unchanged.
Report problems through GitHub Issues.
MIT