Dual Gauge Card — Home Assistant card
Two concentric LED gauges in a single Home Assistant card, to compare two measurements at a glance.
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
- 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.
- 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
| Option | Type | Default | Description |
|---|---|---|---|
name | string | Title displayed | |
title_position | string | 'bottom' | Title position ('bottom', 'top', 'inside-top', 'inside-bottom', 'none') |
title_font_size | string | '16px' | Title font size (e.g., '18px', '1.2em') |
title_font_family | string | inherit | Title font family (e.g., 'Roboto, Arial') |
title_font_weight | string | 'normal' | Title font weight ('normal', 'bold', '100'-'900') |
title_font_color | string | Title font color (e.g., '#ffffff') | |
hide_card | boolean | false | Remove card frame, background and shadow (transparent integration) |
gauge_size | number | 200 | Outer gauge size in pixels |
inner_gauge_size | number | 65% | Inner gauge visual size in pixels |
inner_gauge_radius | number | inner_gauge_size/2 | Inner LEDs positioning radius (to adjust gauge spacing) |
primary_gauge | string | 'inner' | Primary gauge ('inner' or 'outer') - large value display |
value_order | string | 'inner_first' | Order of the two values in the center ('inner_first' or 'outer_first') |
swap_gauges | boolean | false | Draw the first gauge on the outer ring and the second one on the inner ring |
card_theme | string | Global card theme ('default', 'light', 'dark', 'custom') | |
card_background | string | Custom card background color | |
hide_shadows | boolean | false | Hide all shadows |
power_save_mode | boolean | false | Enable power save mode |
debounce_updates | boolean | false | Limit update frequency |
update_interval | number | 1000 | Update interval in ms |
entity (required) | string | Home Assistant entity to display | |
min | number | 0 | Minimum value |
max | number | 100 | Maximum value |
unit | string | Unit to display (e.g., '°C', '%', 'W') | |
decimals | number | 1 | Number of decimal places |
bidirectional | boolean | false | Enable bidirectional mode for negative values (see below) |
leds_count | number | 100 | Number of LEDs on the circle |
led_size | number | 8 (outer) / 6 (inner) | Diameter of a round LED, or the thickness of a rectangular segment along the arc, in pixels |
led_shape | string | round | round = circular LEDs, rect = rectangular segments (hi-fi VU meter style) |
led_length | number | led_size × 2 | Length of a rectangular segment along the radius, in pixels. Ignored when led_shape is round |
led_corner_radius | number | 1 | Corner rounding of a rectangular segment, in pixels. 0 gives sharp corners. Ignored when led_shape is round |
start_angle | number | 0 | Offset of the gauge starting point, in degrees (see below) |
arc_length | number | 360 | Angular span of the gauge, in degrees (see below) |
hide_inactive_leds | boolean | false | Hide inactive LEDs |
value_font_size | string | '24px' | Font size for value (e.g. '30px') |
value_font_weight | string | 'bold' | Font weight for value |
value_font_color | string | Font color for value | |
unit_font_size | string | '14px' | Font size for unit (e.g. '14px') |
unit_font_weight | string | 'normal' | Font weight for unit |
unit_font_color | string | Font color for unit | |
center_shadow | boolean | false | Enable center shadow |
center_shadow_blur | number | 30 | Center shadow blur (px) |
center_shadow_spread | number | 15 | Center shadow spread (px) |
outer_shadow | boolean | false | Enable border shadow |
outer_shadow_blur | number | 30 | Border shadow blur (px) |
outer_shadow_spread | number | 15 | Border shadow spread (px) |
smooth_transitions | boolean | true | Enable smooth transitions |
animation_duration | number | 800 | Animation duration in ms |
severity_mode | string | steps | steps, gradient or gradient_arc |
markers_radius | number | Gauge radius | Marker positioning radius in pixels |
markers_inside | boolean | true | Place marker labels inside the gauge (false = outside) |
markers | array | List 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.