Custom Gauge Card — Carte Home Assistant
Jauge circulaire à LED animées pour Home Assistant : zones colorées, marqueurs, alarmes visuelles, tendance et boutons de commande.
Ouvrir dans HACS · Code sur GitHub
Présentation
Custom Gauge Card affiche un capteur de Home Assistant sous la forme d'une jauge circulaire faite de LED animées. L'arc, les graduations, les zones colorées et les marqueurs se règlent librement, du cercle complet à la jauge en C, avec un mode bidirectionnel pour les valeurs négatives.
La carte signale les dépassements par des alarmes visuelles déclenchées par n'importe quelle entité, montre la tendance sur 24 heures et peut piloter jusqu'à quatre entités (lumières, interrupteurs, scènes, scripts) depuis des boutons placés sous le titre.
Fonctionnalités
- Jauge circulaire avec LEDs animées
- Transitions fluides et douces entre les valeurs
- Effets d'ombre et de lumière dynamiques
- Alarmes multi-entités avec quatre effets visuels (ombre pulsante, LEDs clignotantes, valeur clignotante, bordure pulsante)
- Thèmes personnalisables (clair, sombre, personnalisé)
- Définissez des zones colorées pour visualiser des plages de valeurs
- Ajoutez des marqueurs avec étiquettes pour des repères spécifiques
- Configuration flexible des couleurs et opacités
- Évolution sur 24 heures (ou toute autre période)
- Variation en pourcentage ou absolue, avec flèche directionnelle
- Historique automatique depuis Home Assistant, rafraîchi périodiquement
- Contrôlez plusieurs entités directement depuis la jauge
- Support des interrupteurs, lumières, scènes, scripts, automatisations et plus
- Jusqu'à 4 boutons MDI dans une barre sous le titre
- Icônes intelligentes et retour visuel d'état
Installation
- Dans Home Assistant, ouvrez HACS (bouton « Ouvrir dans HACS » ci-dessus), ajoutez le dépôt guiohm79/custom-gauge-card s'il est demandé, puis installez « Custom Gauge Card » et rechargez le navigateur.
- Sans HACS : téléchargez custom-gauge-card.js depuis la dernière version sur GitHub, copiez-le dans config/www/, puis ajoutez la ressource /local/custom-gauge-card.js (type « Module JavaScript ») dans Paramètres → Tableaux de bord → Ressources.
Configuration
type: 'custom:custom-gauge-card'
entity: sensor.processor_use
min: 0
max: 100
title: Processor
Options
| Option | Type | Défaut | Description |
|---|---|---|---|
entity (obligatoire) | string | Entité à afficher | |
attribute | string | Lire cet attribut au lieu de l'état | |
name | string | Nom affiché sous la jauge | |
unit | string | Unité de mesure | |
min | number | 0 | Valeur minimale |
max | number | 100 | Valeur maximale |
decimals | number | 0 | Nombre de décimales |
gauge_size | number | 200 | Taille de la jauge en pixels |
center_size | number | 120 | Taille du centre en pixels |
led_size | number | 8 | Taille des LEDs en pixels (diamètre ; en rect, largeur du segment le long de l'arc) |
led_shape | string | round | v2.4 : round (LEDs) ou rect (segments radiaux, style vu-mètre hi-fi) |
led_length | number | led_size × 2 | v2.4 : rect uniquement — longueur radiale des segments en pixels. Les segments s'allongent vers l'intérieur : leur bord extérieur reste à la place des LEDs rondes |
led_corner_radius | number | 1 | v2.4 : rect uniquement — arrondi des coins en pixels |
leds_count | number | 100 | Nombre de LEDs |
bidirectional | boolean | false | Mode bidirectionnel : les LEDs partent d'une valeur de référence, dans un sens au-dessus et dans l'autre en dessous |
bidirectional_reference | number | auto | v2.5 : Bidirectionnel uniquement — valeur d'où partent les LEDs, dans l'unité du capteur. Par défaut : 0 s'il est entre min et max, sinon le milieu. Ramenée dans [min, max]. La référence est placée à sa position proportionnelle sur l'arc : marqueurs, zones et graduations restent alignés |
card_width | string | auto | Largeur du conteneur de la carte (ex. "300px") |
card_height | string | auto | Hauteur du conteneur de la carte (ex. "350px") |
card_padding | string | 16px | Marge intérieure du conteneur de la carte |
theme | string | default | Thème : default, light, dark, custom |
custom_background | string | Couleur de fond (thème custom) | |
custom_gauge_background | string | Fond de la jauge (thème custom) | |
custom_center_background | string | Fond du centre (thème custom) | |
custom_text_color | string | Couleur du texte (thème custom) | |
custom_secondary_text_color | string | Couleur du texte secondaire (thème custom) | |
title_font_family | string | inherit | Police de caractères pour le titre (ex: "Roboto, Arial, sans-serif") |
title_font_size | string | 16px | Taille de la police pour le titre |
title_font_weight | string | normal | Épaisseur de la police pour le titre (ex: "normal", "bold", "600") |
title_font_color | string | Couleur personnalisée pour le titre (remplace la couleur du thème) | |
value_font_family | string | inherit | Police de caractères pour la valeur centrale (ex: "Roboto, Arial, sans-serif") |
value_font_size | string | 32px | Taille de la police pour la valeur centrale |
value_font_weight | string/number | bold | Épaisseur de la police pour la valeur (ex: "normal", "bold", 300-900) |
value_font_color | string | Couleur personnalisée pour la valeur (remplace la couleur du thème) | |
unit_font_size | string | 16px | Taille de la police pour le symbole d'unité |
unit_font_weight | string/number | normal | Épaisseur de la police pour l'unité (ex: "normal", "bold", 300-900) |
unit_font_color | string | Couleur personnalisée pour l'unité (remplace la couleur secondaire du thème) | |
arc_sweep | number | 360 | Étendue de l'arc en degrés (30 à 360). En dessous de 360 : jauge partielle (ex. 270 pour une forme en C) |
arc_start | number | 0 | Angle de départ en degrés depuis le haut (midi), dans le sens horaire |
scale_ticks | boolean | false | Affiche des graduations SVG sur la jauge |
scale_steps | number | 5 | Nombre d'intervalles entre les graduations principales |
scale_labels | boolean | true | Affiche la valeur à chaque graduation |
tap_action | object | {action: more-info} | Action au clic, configurable |
smooth_transitions | boolean | true | Activer les transitions fluides |
animation_duration | number | 800 | Durée des animations en ms |
enable_shadow | boolean | false | Activer l'ombre extérieure |
center_shadow | boolean | false | Activer l'ombre au centre |
center_shadow_blur | number | 30 | Flou de l'ombre centrale |
center_shadow_spread | number | 15 | Expansion de l'ombre centrale |
center_shadow_pulse | boolean | false | Obsolète depuis la v2.2, voir les alarmes. Active l'alarme par pulsation de l'ombre centrale |
center_shadow_pulse_duration | number | 1000 | Obsolète. Durée d'un cycle complet de pulsation, en ms |
center_shadow_pulse_min | number | min | Obsolète. Valeur minimale de la zone d'alarme (valeurs réelles du capteur, pas des pourcentages) |
center_shadow_pulse_max | number | max | Obsolète. Valeur maximale de la zone d'alarme (valeurs réelles du capteur, pas des pourcentages) |
center_shadow_pulse_intensity | number | 0.5 | Obsolète. Intensité minimale pendant la pulsation (0 à 1) |
condition | string | range | Voir le tableau des conditions |
min / max | number | gauge min/max | Bornes pour range et outside |
value | number | 0 | Seuil pour above, below, equal |
state | string | on | Chaîne comparée pour state et state_not |
effect | string | shadow_pulse | Voir le tableau des effets |
color | string | severity color | Couleur de l'alarme — ignorée par leds_blink |
duration | number | 1000 | Durée d'un cycle complet en ms (minimum 100) |
intensity | number | 0.5 | Creux du cycle, 0 = flash complet, 1 = pulsation invisible |
transparent_card_background | boolean | false | Rendre l'arrière-plan de la carte principale transparent |
transparent_gauge_background | boolean | false | Rendre l'arrière-plan du cercle gauge transparent |
transparent_center_background | boolean | false | Rendre l'arrière-plan du cercle central transparent |
hide_shadows | boolean | false | Masquer toutes les ombres portées (box-shadows) |
hide_inactive_leds | boolean | false | Masquer les LEDs inactives (grises), ne montrant que les LEDs actives |
show_trend | boolean | false | Afficher l'indicateur de tendance (évolution sur trend_hours) |
trend_mode | string | percent | v2.5 : percent (variation relative) ou absolute (variation dans l'unité du capteur, ex. ↑ 0.6 °C). Une variation relative depuis 0 bascule toujours en absolute |
trend_position | string | bottom-right | v2.5 : bottom-right, bottom-left, top-right, top-left ou below-title (dans le flux de la carte, entre le titre et la barre de boutons — ne chevauche rien) |
trend_hours | number | 24 | v2.5 : Durée de la fenêtre de tendance, en heures |
trend_update_interval | number | 300 | v2.5 : Fréquence de relecture de la valeur de début de fenêtre dans l'historique, en secondes (minimum 60). 0 la lit une seule fois, comme avant la 2.5. La valeur courante est toujours celle en direct |
trend_show_period | boolean | false | v2.5 : Afficher la période (24 h) à côté de la variation |
trend_font_size | string | 12px | v2.5 : Taille de police de l'indicateur |
trend_background | string | rgba(0,0,0,.6) | v2.5 : Fond de l'indicateur (toute valeur CSS, ex. transparent) |
trend_up_color / trend_down_color / trend_stable_color | string | #4caf50 / #f44336 / #ffeb3b | v2.5 : Couleurs de la flèche. « Stable » = la variation arrondie à la précision affichée vaut zéro |
button_icon_size | number | 22 | Taille par défaut de l'icône pour tous les boutons (en pixels) |
buttons_layout | string | bar | bar (sous le titre) ou corners (placement d'avant la 2.3, respecte le position de chaque bouton) |
markers | list | Liste de marqueurs avec value, color, label | |
dynamic_markers | list | Liste de marqueurs dynamiques qui suivent la valeur d'entités | |
zones | list | Liste de zones avec from, to, color, opacity | |
severity | list | Liste de paliers avec value, color pour les LEDs | |
severity_mode | string | v2.4 : steps (défaut) — une couleur plate par palier ; gradient — toute la barre prend une seule couleur, interpolée en RGB entre les deux paliers qui encadrent la valeur ; gradient_arc — chaque LED prend la couleur de sa propre position, la partie allumée affiche tout le dégradé | |
power_save_mode | boolean | false | Pause les mises à jour quand invisible |
power_save_threshold | number | 10 | Seuil de visibilité (%) |
update_interval | number | 1000 | Intervalle de mise à jour en ms |
debounce_updates | boolean | false | Limiter la fréquence des mises à jour |
Questions fréquentes
Comment installer Custom Gauge Card ?
Avec HACS : ajoutez https://github.com/guiohm79/custom-gauge-card comme dépôt personnalisé (catégorie Tableau de bord / Lovelace), installez la carte puis rechargez le navigateur. Le bouton « Ouvrir dans HACS » de cette page fait l'ajout du dépôt pour vous. Home Assistant 2024.1 ou plus récent est nécessaire.
Faut-il écrire du YAML ?
Non. La carte a un éditeur visuel complet, avec des sections repliables pour tous ses réglages. Le YAML reste possible pour copier une configuration d'un tableau de bord à l'autre.
La jauge peut-elle afficher des valeurs négatives ?
Oui : avec bidirectional: true, la jauge part du zéro et s'allume d'un côté ou de l'autre, comme un thermomètre.
Peut-on déclencher une alarme visuelle d'après une autre entité ?
Oui. Les alarmes acceptent n'importe quelle entité et quatre effets : ombre pulsante, LED clignotantes, valeur clignotante ou bordure de carte pulsante.