Solar Panel Visualizer

Solar Panel Visualizer is a Home Assistant Lovelace card for building a live, panel-level solar array overview. It is available in the default HACS store, is configured fully from the Home Assistant GUI, and is designed for arrays from a few panels to large 100+ panel systems.

It gives you a clear visual map of each panel slot, live power and energy KPIs, health coloring, popup graphs, inverter or panel status checks, Forecast.Solar overlays, and practical setup tools without requiring YAML.

✨ Top highlights

• 10-second setup with auto-populate search: search by entity ID or friendly name, fill panel sensors, inverter/panel status, and telemetry from matching serial/device groups, then drag panels into the right slots.
• Live panel-level array overview: see each panel slot with power, energy, status color, row/column labels, and system KPIs in one card.
• String inverter friendly setup tree: choose strings, panel counts, and per-string power/energy sensors; shared values are split by rated W so totals and graphs do not double-count.
• Array Health Check: compare panels against peers to spot underperformance, deviation, inverter faults, and unavailable sensors.
• Useful diagnostics popups: open panel, Power, Energy, and Custom KPI popups with recorder graphs, virtual total graphs, comparison graphs, and 1h, 6h, and 24h ranges.
• Forecast.Solar, themes, and motion: add forecast overlays, status checks, light/dark modes, power-flow animation, and alert effects.

🎬 Animated tour

Right-click and select "Play animation" on Safari macOS if a GIF does not start automatically.

Tap-to-configure, drag-and-drop, and panel diagnostics

GUI auto-populate setup

KPI popups and graph ranges

Panel fault detection

Panel deviation detection

✨ All features

• Available directly in the default HACS store, no custom repository needed for normal installs.
• 100% GUI configuration in the Home Assistant card editor.
• Visual solar array layout with rows, columns, fixed slots, status chips, and row/column labels.
• Live Power, Energy, Alerts, and optional Custom KPI summary cards.
• Panel tiles with production coloring, rated-power percentage, optional energy, and optional inverter/panel status text.
• Live tile values update directly from Home Assistant entity states; recorder data is used only for graphs and health history.
• Array Health Check for peer comparison, underperformance detection, warm-up handling, smoothing, and low-light guardrails.
• Panel, Power, Energy, and Custom KPI popups with recorder history graphs.
• Virtual total Power and Energy histories from panel sensors when no system KPI sensor is configured.
• Saved string setup tree for string inverters where one power or energy sensor represents multiple physical panels.
• Panel comparison graphs inside Power and Energy KPI popups.
• 1h, 6h, and 24h graph ranges with max, median, and min reference lines.
• Forecast.Solar overlay support for Home Assistant's default forecast sensors.
• Inverter or panel status working/fault term matching with clear panel and system health feedback.
• Light, dark, and automatic theme modes.
• Built-in motion effects for power flow, KPI updates, and alerts.
• Tap-to-configure unconfigured panel slots.
• Drag-and-drop panel reordering directly on the card.
• Entity ID or friendly-name sensor auto-fill, friendly-name panel naming, and bulk sensor removal tools.
• Safer multi-inverter auto-fill with natural sorting, repeated serial/device grouping, optional inverter/panel status fill, optional advanced telemetry fill, and shared daily energy protection.
• Advanced per-panel telemetry fields for inverter and panel diagnostics.
• Scales to large arrays, including 100+ panel slots.

🖼️ Static screenshots

Open screenshot gallery

Overview of the card:

Full GUI setup, no YAML needed:

Panel health overview:

Tap-to-configure panels:

Array health overview:

KPI sensors and popups:

📦 Installation with HACS

Solar Panel Visualizer is included in the default HACS store.

1. Open Home Assistant.
2. Go to HACS.
3. Search for Solar Panel Visualizer in the Frontend/Dashboard section.
4. Open the repository and click Download.
5. Reload the Home Assistant frontend, or restart Home Assistant if HACS asks you to.
6. Add the card to a dashboard from the Home Assistant card picker. It appears as Solar Panel Visualizer with a solar panel icon after the frontend reloads.

➕ Add and configure the card

1. Open the dashboard where you want the solar array.
2. Click Edit dashboard.
3. Click + Add card.
4. Search for Solar Panel Visualizer.
5. Add the card and configure it in the visual editor.

The editor covers the full card setup:

• Layout: title, rows, columns, max card width, and optional max card height.
• Appearance: automatic, dark, or light theme mode.
• Display: decimals, panel tap behavior, system KPI sensors, custom KPI, and panel width limits.
• Forecast: enable Forecast.Solar overlays when default Home Assistant forecast sensors are available.
• Array Health Check: peer comparison thresholds, sample gates, smoothing, dynamic floor, and history window.
• Status Checks: inverter or panel status entity matching, fault terms, working terms, and optional tile text.
• Status Colors: production gradient, deviation/error/unavailable colors, and intensity.
• Motion: power flow, update shimmer, and alert ripple controls.
• Panels: per-slot sensor selectors, names, rated power, string setup tree, energy display, derate, inverter/panel status, advanced telemetry, and visibility.
• Auto-populate sensors: power, energy, and optional status search, sort mode, optional inverter/panel status fill, optional advanced telemetry fill, and bulk sensor removal.

☀️ Configure a string-based system

Use String of panels when Home Assistant exposes one power or energy sensor for a complete string instead of one sensor for every physical panel. Everything is configured from the GUI:

1. Open Panels in the card editor.
2. Open the String of panels section.
3. Enable String of panels / share duplicate sensors.
4. Set Number of strings.
5. Expand each string and select:
   • String name (optional)
   • Number of panels
   • String power sensor
   • String energy sensor (optional)
6. Set or apply the rated power for the generated panel slots.

The card builds the array automatically:

• Each string becomes one visual row.
• The longest string determines the number of columns.
• Shorter strings receive hidden filler slots, preserving the aligned grid.
• Each string supports up to 30 panels, and the card supports up to 30 strings.
• Generated panels are named automatically, for example String 1 Panel 1.
• Existing custom panel names are preserved where possible; default names such as Panel 1 are regenerated for the new string layout.
• Existing rated power, derate, status, and telemetry settings are preserved by their previous row/column position where possible.

Example: configuring String 1 with 5 panels and String 2 with 12 panels creates a 2 × 12 layout. String 1 uses its first 5 slots and has 7 hidden filler slots; String 2 uses all 12 slots.

How shared values are divided

The same string sensor is assigned internally to every physical panel in that string, but it is counted only once:

• With rated power configured for every panel, each panel receives its rated-power share of the string value.
• If any panel in the string is missing rated power, the value is divided equally across that string.
• The same rule applies to both power and energy sensors.
• Panel tiles, top totals, popups, history graphs, comparison graphs, and Forecast.Solar overlays all use the divided values.

For example, a 1,700 W string sensor shared by five equally rated panels displays 340 W per panel, while the Power total remains 1,700 W, not 8,500 W.

🔍 Feature details

String of panels / shared string sensors

Some systems expose one power or daily energy sensor for a full string instead of one sensor per physical panel. The card can handle that without inflating totals.

• String setup is saved with the card and can be edited later.
• One visual row is generated per string, with up to 30 panels per row.
• Duplicate power and energy sensors are intentional in this mode and are divided without inflating totals.
• Rated-power weighting supports strings containing panels with different ratings.
• Shared power groups show labels such as String 1 · R1C2 in the tile slot label.
• Disable string mode to return to the normal manually configured panel grid; the saved string definitions remain available if string mode is enabled again.

Array Health Check

Array Health Check compares panels against the rest of the active array so weak panels are easier to spot.

• Uses panel power sensors and configured rated power.
• Supports relative deviation threshold and absolute watt shortfall threshold.
• Avoids noisy alerts with minimum active panel count, minimum sample count, runtime gating, smoothing, and dynamic low-power floor.
• Supports per-panel derate for naturally shaded or differently oriented panels.
• Uses a shared recorder history window when available, then falls back gracefully to live warm-up data.
• Shows deviation status on panel tiles and in the System Health popup.

Panel and KPI popups

Popups turn the card from a simple overview into a diagnostic surface.

• Panel popups show power, energy, status, reason text, inverter evaluation, and optional telemetry.
• Power and Energy KPI popups can show system sensor history, or automatically build virtual total histories from configured panel sensors when no system sensor is selected.
• Panel comparison graphs are available in the KPI popups and open automatically when the same panel history has already been loaded for a virtual total graph.
• Custom KPI popup shows the configured custom sensor and graph.
• Graphs are lazy-loaded from Home Assistant recorder data.
• Range chips switch between 1h, 6h, and 24h.
• Graphs include max, median, and min reference lines when data is available.

Forecast.Solar overlays

Forecast overlays can add a dashed reference line to Power and Energy popup graphs.

• Uses Home Assistant's default Forecast.Solar sensors:
  • sensor.power_production_now
  • sensor.energy_production_today
• Overlay is optional and controlled from the GUI editor.
• Overlays work with real system Power/Energy sensors and with virtual totals summed from configured panel sensors.
• If the forecast sensors are missing, the card shows a non-blocking message instead of failing.
• Forecast lines are shown only over the selected history range up to the current time.

Inverter and panel status checks

Status checks help catch panel, string, or inverter issues that raw power values may not explain.

• Configure an inverter or panel status sensor per panel.
• The Auto-populate section can fill empty status sensors from configured panel power sensors.
• Auto-fill first tries clear one-to-one panel status matches, such as panel power and panel status sensors with the same local numbering.
• If no clear one-to-one match exists, auto-fill falls back to one shared inverter/string status sensor for matching panels.
• Use Status search to narrow candidates by entity ID prefix or friendly-name text when an integration has several status-like sensors.
• For integrations with both Device Status and Online Status, shared-status auto-fill prefers the actual device status sensor for evaluation.
• Enable global status checks from the GUI.
• Add working terms and fault terms as comma-separated text.
• Matching fault terms can mark the panel as an error state.
• Matching working terms help distinguish normal status from unknown text.
• Optional tile text can show a compact status summary directly on each panel.

Theme, motion, and visual behavior

The card is designed to be readable and active without requiring extra dashboard cards.

• Theme modes: Auto, Dark, and Light.
• Production colors use a configurable gradient from base to peak.
• Deviation, error, and unavailable states have separate configurable colors.
• Power flow animation draws a left-side collector rail and panel pulses toward the Power KPI.
• KPI shimmer highlights updates.
• Alert ripple highlights deviation, inverter, and error states.
• Motion effects can be enabled or disabled from the GUI.

Advanced telemetry

Advanced telemetry fields are optional. They are useful when your solar integration exposes extra diagnostic sensors.

Per panel, the GUI can map:

• Inverter AC power
• Inverter AC voltage
• Inverter AC current
• Inverter temperature
• Panel current
• Panel voltage
• Panel power

Configured telemetry is grouped in the panel popup, and missing optional telemetry is handled cleanly.

The Auto-populate section can fill empty advanced telemetry fields from each panel's configured power sensor. This is useful for integrations that expose related sensors with the same serial/device/group in the entity ID or friendly name. Shared inverter-level telemetry, such as inverter temperature, can be reused across multiple panels on the same inverter.

Large arrays and setup tools

The card is built for both small residential arrays and large panel layouts.

• Rows and columns define fixed panel slots, up to 30 rows and 30 columns.
• Rated power supports individual panels and string-level sensors up to 10000 W.
• Disabled panels keep their visual slot but are excluded from active sensor behavior.
• Drag-and-drop swaps panel slots and saves the order to the card config.
• Tap-to-configure opens a quick setup popup for unconfigured panels.
• Auto-fill can fill power and energy sensors by sensor. entity ID prefix or friendly-name search.
• Auto-fill sort modes include Auto detect, literal entity ID order, literal friendly-name order, and grouped repeated-suffix order for multi-inverter naming, including serial-like endings such as powerdc1_SERIAL.
• String sensor sharing lets duplicate power and energy sensors be intentional for string-inverter setups. The saved GUI tree can create one visual row per string and assign each string sensor across its physical panels.
• Power sensor auto-fill also refreshes panel display names from the selected sensors' friendly names.
• Energy auto-fill can find daily yield sensors by friendly name or energy device class, and avoids assigning one shared inverter daily energy sensor to multiple panels in the same serial group so summed Energy totals do not double count that inverter.
• Optional inverter/panel status and advanced telemetry auto-fill use configured panel power sensors as anchors and preserve existing manual selections.
• Bulk remove clears panel sensors when rebuilding the layout.
• Panel width limits help keep large dashboards readable.

🛟 Backup and manual setup

Most users should install from the default HACS store and configure the card in the GUI. The sections below are kept for recovery, debugging, or advanced setups.

Custom repository fallback

Use this only if Solar Panel Visualizer does not appear in your HACS search yet.

1. In HACS, open the menu and choose Custom repositories.
2. Add this repository:
   • URL: https://github.com/NoUsername10/Solar-Panel-Visualizer
   • Category: Dashboard
3. Search for Solar Panel Visualizer in HACS and download it.
4. Reload the frontend or restart Home Assistant if HACS asks you to.

Resource fallback

HACS normally adds the resource automatically. If the card is installed but Home Assistant cannot find it, add this dashboard resource manually:

url: /hacsfiles/Solar-Panel-Visualizer/solar-panel-visualizer.js
type: module

Minimal YAML fallback

Use a manual card only if the card picker does not show Solar Panel Visualizer.

type: custom:solar-panel-visualizer

After adding the card, open the visual editor and finish setup in the GUI.

YAML reference for advanced users

YAML is optional. The GUI editor supports the full card configuration.

type: custom:solar-panel-visualizer
title: My Array
theme_mode: auto
rows: 2
columns: 3
enable_array_checks: true
enable_inverter_status: true
enable_string_sensor_sharing: false
# To use string mode, set enable_string_sensor_sharing to true and add groups.
# Rows and columns are then derived automatically from the string definitions:
# string_groups:
#   - id: string-1
#     name: String 1
#     panel_count: 5
#     power_entity: sensor.string_1_power
#     energy_entity: sensor.string_1_energy
#   - id: string-2
#     name: String 2
#     panel_count: 12
#     power_entity: sensor.string_2_power
#     energy_entity: sensor.string_2_energy
enable_forecast_overlay: true
motion_enabled: true
use_system_power_entity: true
system_power_entity: sensor.solar_power
use_system_energy_entity: true
system_energy_entity: sensor.solar_energy_today
show_custom_kpi: true
custom_kpi_title: Grid
custom_kpi_entity: sensor.grid_power
panels:
  - id: panel-1
    name: Panel 1
    power_entity: sensor.panel_1_power
    energy_entity: sensor.panel_1_energy
    rated_power_w: 505
    inverter_status_entity: sensor.panel_1_inverter_status
  - id: panel-2
    name: Panel 2
    power_entity: sensor.panel_2_power
    energy_entity: sensor.panel_2_energy
    rated_power_w: 505
  - id: panel-3
    name: Panel 3
    power_entity: sensor.panel_3_power
    energy_entity: sensor.panel_3_energy
    rated_power_w: 505
  - id: panel-4
    name: Panel 4
    power_entity: sensor.panel_4_power
    energy_entity: sensor.panel_4_energy
    rated_power_w: 505
  - id: panel-5
    name: Panel 5
    power_entity: sensor.panel_5_power
    energy_entity: sensor.panel_5_energy
    rated_power_w: 505
  - id: panel-6
    name: Panel 6
    power_entity: sensor.panel_6_power
    energy_entity: sensor.panel_6_energy
    rated_power_w: 505

📄 License

MIT License.