Français

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.

Available on HACSGaugesVersion V2.0.0★ 10 starsMinimum Home Assistant 2023.0.0

Open in HACS · Code on GitHub

Half Gauge Card Home Assistant card screenshot (1/6)

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

  1. 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.
  2. 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

OptionTypeDefaultDescription
entity (required)stringEntity to display
attributestringEntity attribute to read instead of state (e.g. battery_level)
namestringName displayed under the gauge
unitstringUnit to display (%, °C, etc.)
minnumber0Minimum value
maxnumber100Maximum value
decimalsnumber0Number of decimal places
gauge_sizenumber200Gauge size (px)
leds_countnumber50Number of LEDs
led_sizenumber10LED size (px) — diameter for round LEDs, thickness for rectangular segments
hide_inactive_ledsbooleanfalseHide inactive LEDs
card_backgroundstringthemeCard background — hex color, transparent, or CSS gradient
gauge_backgroundstringthemeGauge background — hex color, transparent, or CSS gradient
text_colorstringthemeValue color
unit_colorstringthemeUnit color
title_colorstringthemeTitle color
led_shapestringroundround = circular LEDs, rect = rectangular segments (hi-fi VU meter style)
led_lengthnumberRadial length of rectangular segments (px). Empty = led_size × 2
led_corner_radiusnumber1Corner radius of rectangular segments (px). 0 = sharp corners
value_positionstringbelowbelow = under the gauge, inside = inside the gauge
value_font_sizenumberCustom font size for the value (px). Default: 36 for below, 32 for inside
value_offset_ynumber0Vertical offset for the value (px). Positive = down, negative = up
enable_shadowbooleanfalseColored shadow around the active LEDs
background_shadowbooleanfalseApply severity color to the card background gradient
background_shadow_intensitynumber0.5Intensity of background shadow (0 = invisible, 1 = strong)
center_shadowbooleanfalseColored shadow in the center of the gauge
center_shadow_blurnumber35Center shadow blur radius
center_shadow_spreadnumber20Center shadow spread
center_shadow_sizenumber70Center shadow size (% of gauge radius)
transparent_cardbooleanfalseTransparent card background
transparent_gaugebooleanfalseTransparent gauge background
use_ha_cardbooleanfalseWrap the card in an ha-card element (adds Home Assistant card styling)
themestringUse a specific theme for this card instead of the dashboard's
smooth_transitionsbooleantrueSmooth animation on value changes
animation_durationnumber800Animation duration (ms)
severity_modestringstepsHow 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

Half Gauge Card Home Assistant card screenshot (2/6)Half Gauge Card Home Assistant card screenshot (3/6)Half Gauge Card Home Assistant card screenshot (4/6)Half Gauge Card Home Assistant card screenshot (5/6)Half Gauge Card Home Assistant card screenshot (6/6)

More cards