À propos du projet

Mini Graph Card est une carte Lovelace personnalisée pour Home Assistant qui affiche l'état actuel des entités sensor et binary_sensor ainsi qu'un graphique en lignes ou en barres de leur historique. Elle s'installe via HACS, manuellement en copiant le bundle dans config/www, ou par téléchargement en ligne de commande, puis se référence comme ressource de module JavaScript dans Lovelace. La carte se configure en YAML. Les options requises sont type (custom:mini-graph-card) et entities, une liste d'entités de capteurs. Chaque entité peut être un simple identifiant d'entité ou un objet avec des options telles que attribute, name, color, unit, aggregate_func, show_state, show_legend_state, show_indicator, show_graph, show_line, show_fill, show_points, show_legend, state_adaptive_color, y_axis, fixed_value et smoothing. Les options au niveau de la carte incluent icon, icon_image, name, unit, tap_action, group, hours_to_show, points_per_hour, aggregate_func, group_by, update_interval, cache, show, animate, height, bar_spacing, line_width, line_color, color_thresholds, color_thresholds_transition, decimals, hour24, font_size, font_size_header, align_header, align_icon, align_state, lower_bound, upper_bound, min_bound_range, bornes secondaires, smoothing, state_map, value_factor et logarithmic. La liste show contrôle les éléments d'interface : name, icon, state, graph (line, bar ou false), fill, points, legend, average, extrema, labels, labels_secondary, name_adaptive_color, icon_adaptive_color et loading_indicator. Les fonctions d'agrégation incluent avg, median, min, max, first, last, sum, delta et diff. Les données peuvent être groupées par intervalle, date ou heure. Les seuils de couleur prennent en charge des transitions douces ou nettes et l'interpolation des valeurs intermédiaires. Les états non numériques peuvent être mappés vers des libellés via state_map, et les attributs dans des dictionnaires ou listes imbriqués sont accessibles par chemins à points. Les exemples couvrent les cartes à entité unique, les styles alternatifs, les entités multiples, les graphiques en barres, l'historique hebdomadaire, les cartes graphique uniquement, les piles horizontales, les couleurs de ligne dynamiques, l'axe y secondaire, le groupement par date, les fonctions d'agrégation, les capteurs binaires et l'affichage d'entités supplémentaires uniquement pour leur état. Les variables de thème mcg-title-letter-spacing et mcg-title-font-weight permettent de personnaliser l'apparence. Le développement nécessite nodejs et npm, avec les scripts npm run build et npm run watch.