Half Gauge Card — Home Assistant card
Half-circle (180°) LED gauge for Home Assistant: round LEDs or VU-meter segments, color gradients and a full visual editor.
Overview
Half Gauge Card shows a Home Assistant sensor on a 180° half-circle gauge made of LEDs. The LEDs can be round or rectangular segments, like a hi-fi VU meter, and their color follows severity thresholds, in steps or as a smooth gradient.
The value sits inside or below the gauge; colored shadows, gradient backgrounds and animations are set in the visual editor, no YAML needed. The card can also read an entity attribute instead of its state.
Features
- Half-circle gauge (180°) with customizable LEDs
- Two LED shapes — round LEDs or rectangular segments (hi-fi VU meter style)
- Color gradients — blend the severity colors smoothly instead of stepping between thresholds
- Full visual editor — all options configurable via GUI, no YAML required
- Entity attribute support — display any attribute value instead of the entity state
- Smooth animations and transitions
- Multiple shadow effects (card, center, background)
- Customizable colors with color palette picker
- Background gradient builder — solid color, linear gradient, radial gradient, or custom CSS
- Severity-based color thresholds with color picker
- Value display inside or below the gauge
Installation
- In Home Assistant, open HACS (“Open in HACS” button above), add the guiohm79/half-gauge-card repository if asked, then install “Half Gauge Card” and reload your browser.
- Without HACS: download half-gauge-card.js from the latest GitHub release, copy it to config/www/, then add the resource /local/half-gauge-card.js (type “JavaScript module”) in Settings → Dashboards → Resources.
Configuration
type: custom:half-gauge-card
entity: sensor.humidite
gauge_size: 200
leds_count: 20
name: Humidité
unit: "%"
min: 0
max: 100
severity:
- color: "#f44336"
value: 20
- color: "#ffeb3b"
value: 40
- color: "#4caf50"
value: 100
value_position: inside
value_offset_y: -20
Options
| Option | Type | Default | Description |
|---|---|---|---|
entity (required) | string | Entity to display | |
attribute | string | Entity attribute to read instead of state (e.g. battery_level) | |
name | string | Name displayed under the gauge | |
unit | string | Unit to display (%, °C, etc.) | |
min | number | 0 | Minimum value |
max | number | 100 | Maximum value |
decimals | number | 0 | Number of decimal places |
gauge_size | number | 200 | Gauge size (px) |
leds_count | number | 50 | Number of LEDs |
led_size | number | 10 | LED size (px) — diameter for round LEDs, thickness for rectangular segments |
hide_inactive_leds | boolean | false | Hide inactive LEDs |
card_background | string | theme | Card background — hex color, transparent, or CSS gradient |
gauge_background | string | theme | Gauge background — hex color, transparent, or CSS gradient |
text_color | string | theme | Value color |
unit_color | string | theme | Unit color |
title_color | string | theme | Title color |
led_shape | string | round | round = circular LEDs, rect = rectangular segments (hi-fi VU meter style) |
led_length | number | Radial length of rectangular segments (px). Empty = led_size × 2 | |
led_corner_radius | number | 1 | Corner radius of rectangular segments (px). 0 = sharp corners |
value_position | string | below | below = under the gauge, inside = inside the gauge |
value_font_size | number | Custom font size for the value (px). Default: 36 for below, 32 for inside | |
value_offset_y | number | 0 | Vertical offset for the value (px). Positive = down, negative = up |
enable_shadow | boolean | false | Colored shadow around the active LEDs |
background_shadow | boolean | false | Apply severity color to the card background gradient |
background_shadow_intensity | number | 0.5 | Intensity of background shadow (0 = invisible, 1 = strong) |
center_shadow | boolean | false | Colored shadow in the center of the gauge |
center_shadow_blur | number | 35 | Center shadow blur radius |
center_shadow_spread | number | 20 | Center shadow spread |
center_shadow_size | number | 70 | Center shadow size (% of gauge radius) |
transparent_card | boolean | false | Transparent card background |
transparent_gauge | boolean | false | Transparent gauge background |
use_ha_card | boolean | false | Wrap the card in an ha-card element (adds Home Assistant card styling) |
theme | string | Use a specific theme for this card instead of the dashboard's | |
smooth_transitions | boolean | true | Smooth animation on value changes |
animation_duration | number | 800 | Animation duration (ms) |
severity_mode | string | steps | How threshold colors are applied: steps (one color per threshold), gradient (the whole gauge in the blended color), gradient_arc (each LED takes the color of its position) |
FAQ
How do I install Half Gauge Card?
With HACS: add https://github.com/guiohm79/half-gauge-card as a custom repository (Dashboard / Lovelace category), install the card, then reload your browser. The “Open in HACS” button on this page adds the repository for you.
Do I need to write YAML?
No. Every setting is in the visual editor. YAML is still available to copy a configuration from one dashboard to another.
Can it show an attribute instead of the entity's state?
Yes: the attribute option reads any attribute, for example battery_level or current_temperature.
Can the colors change gradually?
Yes: with severity_mode: gradient, the whole gauge takes a color blended between the two thresholds around the value; with gradient_arc, each LED takes the color of its own position.
Screenshots



