Français

Dual Gauge Card — Home Assistant card

Two concentric LED gauges in a single Home Assistant card, to compare two measurements at a glance.

Available on HACSGaugesVersion V1.2★ 18 starsMinimum Home Assistant 2024.1.0

Open in HACS · Code on GitHub

Dual Gauge Card preview

Overview

A custom card for Home Assistant that displays two concentric circular LED gauges, allowing you to visualize two measurements simultaneously.

Perfect for comparing indoor/outdoor temperatures, displaying temperature and humidity together, or any two related sensor values side by side.

Features

  • Two independent circular gauges (inner and outer)
  • Separate configuration for each gauge
  • Configurable primary value display (choose which value shows large)
  • Choose which of the two values sits on top in the center
  • Swap the two gauges between the inner and the outer ring without rewriting the list
  • Adjustable gauge spacing
  • Adjustable start angle and arc length per gauge (full circle, 270°, half circle...)
  • bidirectional for negative values
  • Two LED shapes per gauge: round LEDs or rectangular segments (hi-fi VU meter style)
  • Color gradients: blend the severity colors smoothly instead of stepping between thresholds
  • Independent shadow controls for each gauge
  • Center shadows for depth effect
  • Border shadows for gauge highlighting
  • Dynamic shadow colors based on sensor values
  • Define colored zones to visualize value ranges

Installation

  1. In Home Assistant, open HACS (“Open in HACS” button above), add the guiohm79/dual_gauge repository if asked, then install “Dual Gauge Card” and reload your browser.
  2. Without HACS: download dual-gauge-card.js from the latest GitHub release, copy it to config/www/, then add the resource /local/dual-gauge-card.js (type “JavaScript module”) in Settings → Dashboards → Resources.

Configuration

type: 'custom:dual-gauge-card'
name: "My Dual Gauge"
gauge_size: 200
inner_gauge_size: 130
primary_gauge: inner
gauges:
  - entity: sensor.outdoor_temp
    center_shadow: true
    center_shadow_blur: 50
    outer_shadow: false
    min: 0
    max: 40
  - entity: sensor.indoor_temp
    min: -10
    max: 50

Options

OptionTypeDefaultDescription
namestringTitle displayed
title_positionstring'bottom'Title position ('bottom', 'top', 'inside-top', 'inside-bottom', 'none')
title_font_sizestring'16px'Title font size (e.g., '18px', '1.2em')
title_font_familystringinheritTitle font family (e.g., 'Roboto, Arial')
title_font_weightstring'normal'Title font weight ('normal', 'bold', '100'-'900')
title_font_colorstringTitle font color (e.g., '#ffffff')
hide_cardbooleanfalseRemove card frame, background and shadow (transparent integration)
gauge_sizenumber200Outer gauge size in pixels
inner_gauge_sizenumber65%Inner gauge visual size in pixels
inner_gauge_radiusnumberinner_gauge_size/2Inner LEDs positioning radius (to adjust gauge spacing)
primary_gaugestring'inner'Primary gauge ('inner' or 'outer') - large value display
value_orderstring'inner_first'Order of the two values in the center ('inner_first' or 'outer_first')
swap_gaugesbooleanfalseDraw the first gauge on the outer ring and the second one on the inner ring
card_themestringGlobal card theme ('default', 'light', 'dark', 'custom')
card_backgroundstringCustom card background color
hide_shadowsbooleanfalseHide all shadows
power_save_modebooleanfalseEnable power save mode
debounce_updatesbooleanfalseLimit update frequency
update_intervalnumber1000Update interval in ms
entity (required)stringHome Assistant entity to display
minnumber0Minimum value
maxnumber100Maximum value
unitstringUnit to display (e.g., '°C', '%', 'W')
decimalsnumber1Number of decimal places
bidirectionalbooleanfalseEnable bidirectional mode for negative values (see below)
leds_countnumber100Number of LEDs on the circle
led_sizenumber8 (outer) / 6 (inner)Diameter of a round LED, or the thickness of a rectangular segment along the arc, in pixels
led_shapestringroundround = circular LEDs, rect = rectangular segments (hi-fi VU meter style)
led_lengthnumberled_size × 2Length of a rectangular segment along the radius, in pixels. Ignored when led_shape is round
led_corner_radiusnumber1Corner rounding of a rectangular segment, in pixels. 0 gives sharp corners. Ignored when led_shape is round
start_anglenumber0Offset of the gauge starting point, in degrees (see below)
arc_lengthnumber360Angular span of the gauge, in degrees (see below)
hide_inactive_ledsbooleanfalseHide inactive LEDs
value_font_sizestring'24px'Font size for value (e.g. '30px')
value_font_weightstring'bold'Font weight for value
value_font_colorstringFont color for value
unit_font_sizestring'14px'Font size for unit (e.g. '14px')
unit_font_weightstring'normal'Font weight for unit
unit_font_colorstringFont color for unit
center_shadowbooleanfalseEnable center shadow
center_shadow_blurnumber30Center shadow blur (px)
center_shadow_spreadnumber15Center shadow spread (px)
outer_shadowbooleanfalseEnable border shadow
outer_shadow_blurnumber30Border shadow blur (px)
outer_shadow_spreadnumber15Border shadow spread (px)
smooth_transitionsbooleantrueEnable smooth transitions
animation_durationnumber800Animation duration in ms
severity_modestringstepssteps, gradient or gradient_arc
markers_radiusnumberGauge radiusMarker positioning radius in pixels
markers_insidebooleantruePlace marker labels inside the gauge (false = outside)
markersarrayList of markers to display

FAQ

How do I install Dual Gauge Card?

With HACS: add https://github.com/guiohm79/dual_gauge as a custom repository (Dashboard / Lovelace category), install the card, then reload your browser, or use the “Open in HACS” button on this page. Home Assistant 2024.1 or newer is required.

What is a dual gauge for?

To read two related measurements at a glance: indoor and outdoor temperature, temperature and humidity of a room, production and consumption… Each ring has its own entity, range and colors.

Is there a visual editor?

Yes: add the card to a dashboard and every option can be set from the Home Assistant editor.

Can the two gauges be swapped?

Yes: swap_gauges: true draws the first gauge on the outer ring and the second one on the inner ring, without rewriting the configuration.

More cards