English

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.

Disponible sur HACSJaugesVersion v2.2★ 29 étoilesHome Assistant minimum 2024.1.0

Ouvrir dans HACS · Code sur GitHub

Aperçu de Custom Gauge Card

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

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

OptionTypeDéfautDescription
entity (obligatoire)stringEntité à afficher
attributestringLire cet attribut au lieu de l'état
namestringNom affiché sous la jauge
unitstringUnité de mesure
minnumber0Valeur minimale
maxnumber100Valeur maximale
decimalsnumber0Nombre de décimales
gauge_sizenumber200Taille de la jauge en pixels
center_sizenumber120Taille du centre en pixels
led_sizenumber8Taille des LEDs en pixels (diamètre ; en rect, largeur du segment le long de l'arc)
led_shapestringroundv2.4 : round (LEDs) ou rect (segments radiaux, style vu-mètre hi-fi)
led_lengthnumberled_size × 2v2.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_radiusnumber1v2.4 : rect uniquement — arrondi des coins en pixels
leds_countnumber100Nombre de LEDs
bidirectionalbooleanfalseMode bidirectionnel : les LEDs partent d'une valeur de référence, dans un sens au-dessus et dans l'autre en dessous
bidirectional_referencenumberautov2.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_widthstringautoLargeur du conteneur de la carte (ex. "300px")
card_heightstringautoHauteur du conteneur de la carte (ex. "350px")
card_paddingstring16pxMarge intérieure du conteneur de la carte
themestringdefaultThème : default, light, dark, custom
custom_backgroundstringCouleur de fond (thème custom)
custom_gauge_backgroundstringFond de la jauge (thème custom)
custom_center_backgroundstringFond du centre (thème custom)
custom_text_colorstringCouleur du texte (thème custom)
custom_secondary_text_colorstringCouleur du texte secondaire (thème custom)
title_font_familystringinheritPolice de caractères pour le titre (ex: "Roboto, Arial, sans-serif")
title_font_sizestring16pxTaille de la police pour le titre
title_font_weightstringnormalÉpaisseur de la police pour le titre (ex: "normal", "bold", "600")
title_font_colorstringCouleur personnalisée pour le titre (remplace la couleur du thème)
value_font_familystringinheritPolice de caractères pour la valeur centrale (ex: "Roboto, Arial, sans-serif")
value_font_sizestring32pxTaille de la police pour la valeur centrale
value_font_weightstring/numberboldÉpaisseur de la police pour la valeur (ex: "normal", "bold", 300-900)
value_font_colorstringCouleur personnalisée pour la valeur (remplace la couleur du thème)
unit_font_sizestring16pxTaille de la police pour le symbole d'unité
unit_font_weightstring/numbernormalÉpaisseur de la police pour l'unité (ex: "normal", "bold", 300-900)
unit_font_colorstringCouleur personnalisée pour l'unité (remplace la couleur secondaire du thème)
arc_sweepnumber360Étendue de l'arc en degrés (30 à 360). En dessous de 360 : jauge partielle (ex. 270 pour une forme en C)
arc_startnumber0Angle de départ en degrés depuis le haut (midi), dans le sens horaire
scale_ticksbooleanfalseAffiche des graduations SVG sur la jauge
scale_stepsnumber5Nombre d'intervalles entre les graduations principales
scale_labelsbooleantrueAffiche la valeur à chaque graduation
tap_actionobject{action: more-info}Action au clic, configurable
smooth_transitionsbooleantrueActiver les transitions fluides
animation_durationnumber800Durée des animations en ms
enable_shadowbooleanfalseActiver l'ombre extérieure
center_shadowbooleanfalseActiver l'ombre au centre
center_shadow_blurnumber30Flou de l'ombre centrale
center_shadow_spreadnumber15Expansion de l'ombre centrale
center_shadow_pulsebooleanfalseObsolète depuis la v2.2, voir les alarmes. Active l'alarme par pulsation de l'ombre centrale
center_shadow_pulse_durationnumber1000Obsolète. Durée d'un cycle complet de pulsation, en ms
center_shadow_pulse_minnumberminObsolète. Valeur minimale de la zone d'alarme (valeurs réelles du capteur, pas des pourcentages)
center_shadow_pulse_maxnumbermaxObsolète. Valeur maximale de la zone d'alarme (valeurs réelles du capteur, pas des pourcentages)
center_shadow_pulse_intensitynumber0.5Obsolète. Intensité minimale pendant la pulsation (0 à 1)
conditionstringrangeVoir le tableau des conditions
min / maxnumbergauge min/maxBornes pour range et outside
valuenumber0Seuil pour above, below, equal
statestringonChaîne comparée pour state et state_not
effectstringshadow_pulseVoir le tableau des effets
colorstringseverity colorCouleur de l'alarme — ignorée par leds_blink
durationnumber1000Durée d'un cycle complet en ms (minimum 100)
intensitynumber0.5Creux du cycle, 0 = flash complet, 1 = pulsation invisible
transparent_card_backgroundbooleanfalseRendre l'arrière-plan de la carte principale transparent
transparent_gauge_backgroundbooleanfalseRendre l'arrière-plan du cercle gauge transparent
transparent_center_backgroundbooleanfalseRendre l'arrière-plan du cercle central transparent
hide_shadowsbooleanfalseMasquer toutes les ombres portées (box-shadows)
hide_inactive_ledsbooleanfalseMasquer les LEDs inactives (grises), ne montrant que les LEDs actives
show_trendbooleanfalseAfficher l'indicateur de tendance (évolution sur trend_hours)
trend_modestringpercentv2.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_positionstringbottom-rightv2.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_hoursnumber24v2.5 : Durée de la fenêtre de tendance, en heures
trend_update_intervalnumber300v2.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_periodbooleanfalsev2.5 : Afficher la période (24 h) à côté de la variation
trend_font_sizestring12pxv2.5 : Taille de police de l'indicateur
trend_backgroundstringrgba(0,0,0,.6)v2.5 : Fond de l'indicateur (toute valeur CSS, ex. transparent)
trend_up_color / trend_down_color / trend_stable_colorstring#4caf50 / #f44336 / #ffeb3bv2.5 : Couleurs de la flèche. « Stable » = la variation arrondie à la précision affichée vaut zéro
button_icon_sizenumber22Taille par défaut de l'icône pour tous les boutons (en pixels)
buttons_layoutstringbarbar (sous le titre) ou corners (placement d'avant la 2.3, respecte le position de chaque bouton)
markerslistListe de marqueurs avec value, color, label
dynamic_markerslistListe de marqueurs dynamiques qui suivent la valeur d'entités
zoneslistListe de zones avec from, to, color, opacity
severitylistListe de paliers avec value, color pour les LEDs
severity_modestringv2.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_modebooleanfalsePause les mises à jour quand invisible
power_save_thresholdnumber10Seuil de visibilité (%)
update_intervalnumber1000Intervalle de mise à jour en ms
debounce_updatesbooleanfalseLimiter 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.

Autres cartes