nabu-eyes-voice-avatar
Work In Progress - Voice Avatar for Home Assistant and Awtrix3 (Ulanzi Clock- assets included in repository)
Nabu Eyes Dashboard Card
The repository provides a Home Assistant Lovelace card that displays the animated Nabu Eyes dashboard GIFs depending on the state of one or more Assist Satellite entities. The card also supports media-player driven equalizer animations, mute overlays, and reacting to timer or alarm events published on the Home Assistant event bus.
Features
- Monitor multiple
assist_satelliteentities and switch the animation through the statesidle,listening,processing,responding, andplaying. - Optional hiding of the card while every tracked satellite is idle.
- Media player integrations for equalizer animations and mute overlays.
- Subscribe to Home Assistant events to represent countdown or alarm activity.
- Alarm state can additionally follow binary entities such as doorbells or switches.
- GUI editor with support for selecting multiple satellites, alarm entities, and event lists.
Installation
- Install the card through HACS or copy the built file from
dist/nabu-eyes-dashboard-card.jsinto your Home Assistantwww/directory (typically/config/www/). - When installing manually, copy the animated GIF assets from
dist/nabu_eyes_dashboardinto the same folder (for example/config/www/nabu_eyes_dashboard). HACS installations bundle these assets automatically under/hacsfiles/nabu-eyes-voice-avatar/nabu_eyes_dashboard. - Add the resource reference to Home Assistant:
url: /local/nabu-eyes-dashboard-card.js type: module
When installed through HACS the resource is exposed automatically at /hacsfiles/nabu-eyes-voice-avatar/nabu-eyes-dashboard-card.js, so you can reference that URL instead of copying the build output manually.
Configuration Options
- assist_entities (required): One or more Assist Satellite entities that drive the base animation state of the card. The card hides itself when every satellite reports
idleifhide_when_idleis enabled.
- hide_when_idle: When
true, the card disappears if all tracked satellites are idle. Set tofalseto always show the idle animation.
- Overlay on top (centered) When
true, the card appears center overlay ontp of dashboard. Set tofalseto appear as a card inline with dashboard.
- media_player: Media player entity that controls the equalizer animation while it is playing.

- mute_media_player: Media player entity that controls the mute overlay. Defaults to the same entity as
media_player.
- asset_path: Path to the folder that contains the GIF assets. Defaults to
/hacsfiles/nabu-eyes-voice-avatar/nabu_eyes_dashboard(the location used by HACS). For manual installations keep the assets under/local/nabu_eyes_dashboardand update this value.Variants:

- countdown_events / countdown_clear_events: Home Assistant event types that toggle the countdown animation on or off.

- alarm_events / alarm_clear_events: Event types that toggle the alarm animation.

- alarm_entities: Binary entities (doorbells, switches, etc.) that can also activate the alarm animation when their state matches
alarm_active_states.
- glow_radius: Glow Radius behind Nabu Eyes.

- vertical_padding: Vertical padding above and below card

- variant glow colours: Colour of glow behind variants




















