Français

Linear Gauge Card — Home Assistant card

Linear gauges for Home Assistant: 14 styles (bar, LED, battery, thermometer, wave…), targets, 24-hour min/max and visual alerts.

Available on HACSGaugesVersion V1.4.1★ 11 starsMinimum Home Assistant 2025.1.0

Open in HACS · Code on GitHub

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

Overview

Linear Gauge Card shows several Home Assistant entities as linear gauges, in a horizontal list or vertical columns. Each gauge can use one of 14 styles: bar, gradient track, glass, stripes, LED segments, dots, equalizer, battery, thermometer, wave, ticks, needle, cursor or sparkline.

The card marks a fixed or entity-driven target, shows the last 24 hours' min/max, makes the bar pulse on critical states and can start from zero for negative values. Everything is set in the visual editor, and each entity keeps its own tap action.

Features

  • Visual Editor: Fully configurable via the Home Assistant UI.
  • Theme Integration: Follows your Home Assistant theme or custom background color with transparency support.
  • Interactive Actions: Full support for tap_action on each entity (toggle, navigation, call-service, URL).
  • Icons: Material Design icons support.
  • Targets: Display a target marker, either a fixed value (target) or driven by an entity's state (target_entity).
  • Visual Alerts: Pulse animation that blinks the bar for critical states.
  • 24h Min/Max: Visualization of the value range over the last 24 hours.
  • Flexible Layout: Choose between horizontal (list) or vertical (columns) display.
  • Smart Gradients: Define a global gradient or specific colors per entity.
  • LED Effect: Segmented and rectangular display mode for a modern "pixel" style.
  • 14 Gauge Styles: Choose how each gauge is drawn — bar, gradient_track, glass, stripes, segments (LED), dots, equalizer, battery, thermometer, wave, ticks, needle, cursor or sparkline.
  • Compact Mode: Minimal display with just icon and bar to save space.
  • Value in Bar: Display the value directly on the progress bar (hides the value next to the name to avoid duplication).
  • Shimmer Effect: Animated shine effect on bars (can be disabled).

Installation

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

Configuration

type: custom:linear-gauge-card
title: Server
show_min_max: true
colors:
  - "#4caf50"
  - "#ffeb3b"
  - "#f44336"
entities:
  - entity: sensor.cpu_load
    name: CPU
    icon: mdi:cpu-64-bit
    target: 80                    # Marker at 80%
    severity:
      - from: 90
        color: "#d32f2f"
        pulse: true               # Activates pulse animation
  - entity: sensor.temperature
    icon: mdi:thermometer
    target_entity: sensor.target_temp  # Dynamic marker
    tap_action:
      action: toggle

Options

OptionTypeDefaultDescription
titlestringCard title
entitieslistList of entities to display (required)
layoutstringhorizontal (default) or vertical
minnumberGlobal minimum value (default: 0)
maxnumberGlobal maximum value (default: 100)
show_min_maxbooleanShow 24h min/max markers (default: false)
colorslistList of colors for a global gradient
colorstringGlobal fixed color (overrides gradient)
color_negativestringGlobal fixed color for negative values when center_zero is active
severitylistGlobal severity configuration
effectstringdefault or led for a rectangular segmented effect (legacy — prefer gauge_style)
gauge_stylestringHow the gauge is drawn: bar (default), gradient_track, glass, stripes, segments, dots, equalizer, battery, thermometer, wave, ticks, needle, cursor, sparkline
segment_countnumberNumber of elements for the segments, dots and equalizer styles (range 3–120; defaults: 20 segments, 12 dots, 16 equalizer bars)
tick_countnumberNumber of labelled graduations for the ticks style, and of graduation marks on the thermometer tube (default: 5, min 2)
cursor_shapestringThumb shape for the cursor style: circle (default), line, arrow, diamond, bar
tap_actionobjectDefault action on click (e.g., toggle)
transparentbooleanTransparent background (default: false)
card_backgroundstringCustom card background color (with alpha support)
compact_modebooleanCompact display mode (default: false)
show_value_in_barbooleanShow value inside the bar, hides value next to name (default: false)
disable_shimmerbooleanDisable the shimmer animation effect (default: false)
center_zerobooleanStart the bar at the zero point. Negative values extend left/bottom, positive extend right/top (default: false)
bar_thicknessnumberBar thickness in pixels (default: 12)
vertical_heightnumberVertical bar height in pixels (default: 120)
vertical_widthnumberVertical bar width in pixels (default: 16)
wave_heightnumberHeight of the wave style in horizontal layout, in pixels (default: 40)
equalizer_heightnumberHeight of the equalizer style, in pixels (default: 34)
battery_sizenumberHeight of the battery body in horizontal layout, in pixels (default: 22)
battery_cellsnumberNumber of cells drawn inside the battery shell (default: 4, range 2–12)
entitystringEntity ID (e.g., sensor.cpu_load)
namestringCustom displayed name
iconstringIcon (e.g., mdi:thermometer)
targetnumberFixed target marker value
target_entitystringEntity whose state drives the target marker (takes priority over target)
min / maxnumberSpecific limits for this entity
pulseobjectPulse alert: threshold (value) and condition (above or below)

FAQ

How do I install Linear Gauge Card?

With HACS: add https://github.com/guiohm79/jaugeLineaire 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. Home Assistant 2025.1 or newer is required.

Do I need to write YAML?

No. The card is fully set up in the Home Assistant visual editor. YAML is still available to copy a configuration from one dashboard to another.

Can the gauge show negative values?

Yes: with center_zero: true, the bar starts from zero and extends one way for negative values and the other way for positive ones.

Which gauge styles are available?

Fourteen: bar, gradient track, glass, stripes, LED segments, dots, equalizer, battery, thermometer, wave, ticks, needle, cursor and sparkline (gauge_style).

Screenshots

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

More cards