Repository: https://github.com/Giorgio866/lumina-energy-card

This project is licensed under the PolyForm Noncommercial License 1.0.0 (LICENSE). Commercial use / resale requires a separate agreement (COMMERCIAL-LICENSE.md).

Install directly (HACS) · Support: ·
Send as donation; other payment methods will be refunded.

Lumina Energy Card – main view with energy flows, PV, battery, grid, and house

Lumina Energy Card is a Home Assistant custom Lovelace card that displays animated energy flows (PV, battery, grid, load, heat pump, EV), aggregates PV strings and batteries, and supports optional EV charging and heat pump metrics. It includes House Management (cameras, lights, temperature, humidity, security keypad), interactive popups with toggles, round buttons (Echo Alive, Text toggle, HOME), PRO features (motion-based text visibility, overlay images, custom flows), Import & Export for config backup, and version 3.3.1 enhancements.

• Gallery: Share your dashboard templates to the community and browse templates shared by others. From the editor, use "Share to gallery" to submit a template (name, description, author, email, rules). One share per user per month. "Top" shows the most popular templates; a 30-day timer resets and notifies the winner.
• Bug fix – Text button: The text toggle button no longer disappears when the HOME button is off.
• Clock color: You can now change the color of the digital clock from the editor.
• Bug fix – Inverter ↔ House flow: Corrected the energy flow display between inverter and house.
• Bug fix – Solar forecast SVG: The solar forecast icon (sun/rain) is now always visible when solar forecast is enabled, even when "Hide texts" is on.
• PV Box and Grid Box: You can now disable PV Box and Grid Box directly from their respective sections in the editor.

• 🛡️ Never Lose Your Config Again: Import & Export buttons let you save your setup locally and restore it instantly. Your data is finally safe.
• Expanded string support: Up to 9 strings for complex setups.
• Smart flow visibility: Flow line automatically disappears when wattage drops below threshold, keeping the dashboard clean.
• Drag & Drop interface: PV Box and Grid Box sections are now fully drag-and-drop — move and arrange them exactly where you like.
• Customizable Array 2: You can now modify the text within Array 2.
• Bug fixes: Fixed #212, #208.

• Security keypad (PIN): In House Management → Security you can assign a keypad entity. The keypad shows a PIN pad with colors that change by state (e.g. armed, disarmed, pending).
• Camera fullscreen on motion: When motion is detected (e.g. via your motion sensor), the camera popup can expand to fullscreen so you see the feed on the whole screen.
• Custom thresholds: In Colori Flussi (Flow colors) you can set flow visibility threshold, PV animation threshold (disable PV animation below a power value in W), and grid animation threshold.
• Counter animation: house or inverter: You can choose whether the animated counter shows house consumption or inverter (e.g. total PV) — configurable in the editor.
• 10 custom flow slots: PRO section now supports 10 custom energy flows (was 5), each with sensor, path, color, direction, and threshold.
• Overlay and flows in PRO and Preview: Overlay images and custom flows can be edited both in the PRO section and in the Preview Lumina (drag) — drag to position overlays and flows in the preview.
• Custom background: You can use your own background by uploading an image (URL or local path), or generate one with IA using tokens (PRO). No need to use only the built-in backgrounds.
• Editable array text: The text shown next to each PV/array can be customized (e.g. “Stringa 1”, “Array 2”) from the editor.
• Box Grid and Box PV – choose what to show: Grid box and PV box now let you choose what to display (e.g. power, daily, or custom sensors) so you can show exactly what you need.
• Home temperature sensor: A house temperature sensor can be displayed on the card (e.g. living room temperature).
• Digital clock: An optional digital clock shows the current time on the card (style and position configurable).
• All texts drag-and-drop: Every text label on the card (PV, battery, grid, load, etc.) is draggable in the editor preview so you can place them exactly where you want.
• Russian and Portuguese: The card and editor are fully translated into Russian and Portuguese (in addition to EN, IT, DE, FR, NL).
• Fix #188 (GitHub): Resolved the issue reported in GitHub #188.

• Where performance is measured: the card runs in the browser (frontend). If you use a Raspberry Pi as a kiosk (Chromium), performance/INP depends on the Pi’s browser.
• performance_mode: low: some heavy animation styles are automatically simplified to keep the UI responsive (better INP).
  In particular, shimmer / arrows / fluid_flow will fall back to dots in low mode.
• performance_mode: auto: default is “balanced”, but on low-power clients it can auto-downgrade to low for responsiveness.
• Want all styles anyway? Set performance_mode: high (more CPU/GPU usage).

One-click install (HACS):

Click the badge → your Home Assistant opens → the repo is added to HACS. Then go to HACS → Frontend, search Lumina Energy Card, and install. Finally: Dashboard → Edit → Add card → Lumina Energy Card.

HACS (manual):

1. HACS → Frontend → Custom repositories → Add https://github.com/Giorgio866/lumina-energy-card (category: Dashboard).
2. Search Lumina Energy Card, install it.
3. Dashboard → Edit → Add card → Lumina Energy Card.

Manual (no HACS): Place lumina-energy-card.js and lumina_background.png in /config/www/community/lumina-energy-card/, add the Lovelace resource, restart Home Assistant.

type: custom:lumina-energy-card
sensor_pv1: sensor.solar_production
sensor_daily: sensor.daily_production
sensor_bat1_soc: sensor.battery_soc
sensor_bat1_power: sensor.battery_power
sensor_home_load: sensor.home_consumption
sensor_grid_power: sensor.grid_power
background_image: /local/community/lumina-energy-card/lumina_background.png

Use the card’s visual editor (Edit → Lumina) to configure entities, colors, and options.

• HOME button: A round HOME button appears on the card (together with Echo Alive and Text toggle, if enabled). Click it to open a collapsible panel on the right with 5 icons: Camera, Lights, Temperature, Security, Humidity.
• Assign entities: In the editor, open the “House Management” section. Configure up to 6 entities per icon:
  • house_camera_1 … house_camera_6: Camera entities. Click the Camera icon → popup with a grid of your cameras.
  • house_lights_1 … house_lights_6: Lights or switches. Click Lights → list with ON / OFF buttons.
  • house_temperature_1 … house_temperature_6: Temperature sensors. Click Temperature → list with names and values (°C).
  • house_humidity_1 … house_humidity_6: Humidity sensors. Click Humidity → list with names and values (%).
  • house_security_1 … house_security_6: Security keypad (PIN). Click Security → keypad with PIN; colors change by state (armed, disarmed, pending, etc.).

Cameras popup:

• Each camera has a ▶ Start and ■ Stop button. Streams do not start automatically; click ▶ Start to begin.
• If the camera supports it, the card uses live streaming (ha-camera-stream). Otherwise it shows refreshed snapshots.
• Close the popup with the × button or by clicking the dark overlay. Always click ■ Stop before closing to free resources, or the card will stop streams automatically when you close.

Lights popup:

• Each light/switch shows its state (On/Off) and ON / OFF buttons. The card calls light.turn_on / light.turn_off or switch.turn_on / switch.turn_off automatically.

• Clickable areas: Click on PV (daily badge / solar panels), Battery, Grid, House, or Inverter to open the corresponding popup.
• Up to 6 lines per popup: In the editor, use sensor_popup_pv_1 … sensor_popup_pv_6 (and similar for house, bat, grid, inverter). You can set custom names (sensor_popup_pv_1_name, etc.) and colors.
• Toggles in popups: If you assign active entities (e.g. lights, switches), the popup shows toggles to turn them on/off directly from the popup, without opening another card.
• Closing: Click the popup background (the semi‑transparent rect), not the content, to close. This keeps the popup easy to use without accidental closes.

• Purpose: Keeps the dashboard alive on Echo Show devices. The Silk browser tends to suspend or close the page; Echo Alive prevents that.
• How to use: Enable enable_echo_alive in the editor (Pulsanti e visibilità testi / Buttons and text visibility). A round button appears first on the left. On Echo Show, keep the dashboard open on a view that uses Lumina with Echo Alive enabled; the card will ping the page to avoid suspension.

• Text toggle: Enable enable_text_toggle_button to show a round Text button. Click it to show or hide all text labels (PV, battery, grid, etc.) and enjoy a clean, graphic‑only view.
• Initial state: You can hide texts by default and reveal them only when needed via the toggle.

• battery_power_mode in the editor:
  • flow (default): One sensor with sign (sensor_battery_flow). Positive = charging (flow toward battery), negative = discharging (flow toward inverter).
  • charge_discharge: Two separate sensors, sensor_battery_charge and sensor_battery_discharge. Charge → flow toward battery, discharge → flow toward inverter.

• What it is: a 6‑segment SOC bar shown on the battery overlay (looks like a “grid” on the battery).
• Toggle: enable/disable from the editor with battery_overlay_enabled (it also enables the battery overlay image).
• Position/size: battery_overlay_x, battery_overlay_y, battery_overlay_width, battery_overlay_height, battery_overlay_opacity.

• animation_style (in Colori flussi / Flow colors, or Stili animazioni):
  shimmer (default), dashes, dots, arrows.
• animation_speed_factor: Adjust speed (e.g. 1 = normal, 2 = faster). Use 0 to pause animations.

• In General Settings you can choose the performance profile with performance_mode:
  • auto (default): balanced
  • low: lower CPU usage (lighter animations)
  • high: smoothest animations (more CPU)

• Purpose: Show estimated solar production with a cyan holographic sun and a status label (lots/moderate/little sun).
• How to enable: In the editor, open the PRO section and set:
  • solar_forecast_enabled: true
  • sensor_solar_forecast: sensor.xxx (your forecast sensor)
  • solar_forecast_max_power (e.g., 10000 W)
• Position & style: Adjust solar_forecast_x, solar_forecast_y, solar_forecast_color (default #00FFFF), and solar_forecast_size.
• Tip: If the sun doesn’t appear, the forecast icon (sun/rain) is always visible when solar forecast is enabled. If values don't appear, check that the sensor has a numeric value.

• What it is: The Gallery lets you share your Lumina dashboard configuration as a template and browse templates shared by other users. You can apply a template to get a ready-made layout and then customize it.
• How to share: In the card editor, open the Gallery section and click "Share to gallery". Fill in: template name, description, author name, email (for contact), and accept the rules. Your current dashboard configuration is sent to the gallery. Limit: one share per user per month.
• How to use a template: In the Gallery, browse the list or use "Top" to see the most popular templates. Click a template to view details and Apply to load it into your card (you can then edit it as usual).
• Top & winner: The "Top" shows templates ranked by popularity. A 30-day timer runs; when it ends, the top template's author is notified as the winner for that period, then the timer resets.

PRO features require a PRO password (pro_password), unlocked via the editor’s PRO section (PayPal support).

• Text visibility motion sensor (text_visibility_sensor):
  Set a motion entity (e.g. binary_sensor.corridoio_motion). When motion is detected, texts appear and stay visible for 60 seconds after the last motion. Ideal for wall tablets with a camera: texts show only when someone is in front of the device.
  If you use the Text toggle to show texts, visibility is controlled only by the button (no motion timeout).

• Overlay images:
  Add up to 10 transparent PNGs over the main background (e.g. second car, pool, wind turbine). Configure overlay_image … overlay_image_10, position, size, and opacity in the PRO section. Overlay and custom flows can also be edited in Preview Lumina (drag).

• Enable the Lumina visual preview: turn on “Preview Lumina (drag)” in the editor.

• Overlay images (PRO): drag inside the preview to update X/Y (overlay_image_x, overlay_image_y, and images 2–5).

• Background: drag inside the preview to update background_image_x / background_image_y.

• Custom flows:
  Up to 10 custom energy flows with their own sensor, path, color, and direction. Use custom_flow_1_enabled … custom_flow_10_enabled, custom_flow_1_sensor … custom_flow_10_sensor, path (or preset), color, threshold. Editable in PRO and in Preview Lumina (drag).

• Custom text:
  Up to 5 custom text labels with optional sensor values, position, color, and font size.

• Solar forecast:
  Enable solar_forecast_enabled, set sensor_solar_forecast, and tune solar_forecast_max_power, position, and color (default #00FFFF).

• Card not showing: Ensure the Lovelace resource is added and clear the browser cache.
• Values at zero: Check entity IDs and that entities exist and are available.
• Cameras 403 / not loading: Cameras must expose access_token (most HA camera integrations do). Use ■ Stop before closing the camera popup.
• Editor slow: Increase update_interval or reduce dashboard refresh frequency.
• Images not downloaded with HACS: HACS installs only the JavaScript file (.js). To use the default backgrounds, download the images from the dist folder (e.g. lumina_background.png, lumina_background1.png), place them in /config/www/community/lumina-energy-card/, then reload the dashboard. Links: lumina_background.png, lumina_background1.png.

Lumina Energy Card è una scheda Lovelace personalizzata per Home Assistant che mostra flussi energetici animati (PV, batteria, rete, carico, pompa di calore, EV), aggrega stringhe FV e batterie e supporta metriche opzionali per EV e pompa di calore. Include Gestione casa (telecamere, luci, temperatura, umidità, keypad sicurezza), popup interattivi con toggle, pulsanti rotondi (Echo Alive, Toggle testi, HOME), funzioni PRO (visibilità testi con sensore movimento, overlay, flussi personalizzati), Import & Export per il backup della configurazione e le novità 3.3.1.

• Galleria: Condividi i template della tua dashboard con la community e sfoglia i template condivisi da altri. Dall’editor usa "Condividi in galleria" per inviare un template (nome, descrizione, autore, email, regole). Un invio per utente al mese. La "Top" mostra i template più popolari; un timer di 30 giorni si resetta e notifica il vincitore.

• Correzione – Pulsante Testo: Il pulsante toggle testi non scompare più quando il pulsante HOME è disattivato.

• Colore orologio: Ora puoi cambiare il colore dell’orologio digitale dall’editor.

• Correzione – Flusso inverter ↔ casa: Corretto il flusso energetico tra inverter e casa.

• Correzione – SVG previsione solare: L’icona della previsione solare (sole/pioggia) è ora sempre visibile quando la previsione è attiva, anche con "Nascondi testi" attivo.

• PV Box e Grid Box: Ora puoi disattivare PV Box e Grid Box direttamente dalle rispettive sezioni nell'editor.

• 🛡️ Mai più perdere la configurazione: I pulsanti Import e Export ti permettono di salvare la configurazione in locale e ripristinarla all'istante. I tuoi dati sono al sicuro.
• Supporto stringhe espanso: Fino a 9 stringhe per configurazioni complesse.
• Visibilità flussi intelligente: La linea del flusso scompare automaticamente quando la potenza scende sotto la soglia, mantenendo la dashboard pulita.
• Interfaccia Drag & Drop: Le sezioni PV Box e Grid Box sono ora completamente trascinabili — posizionale dove preferisci.
• Array 2 personalizzabile: Puoi ora modificare il testo nell'Array 2.
• Correzioni bug: Risolti #212, #208.

• Keypad sicurezza (PIN): In Gestione casa → Sicurezza puoi assegnare un’entità keypad. Il keypad mostra una tastierina PIN con colori che cambiano in base allo stato (es. armato, disarmato, in attesa).
• Telecamera a tutto schermo al movimento: Al rilevamento di movimento (es. tramite sensore movimento), il popup della telecamera pu�� espandersi a tutto schermo per vedere il flusso a schermo intero.
• Soglie personalizzabili: In Colori Flussi puoi impostare soglia visibilità flussi, soglia animazione FV (disattiva l’animazione fotovoltaico sotto una certa potenza in W) e soglia animazione rete.
• Animazione contatore: casa o inverter: Puoi scegliere se il contatore animato mostra il consumo casa o l’inverter (es. PV totale) — configurabile nell’editor.
• 10 slot per flussi custom: La sezione PRO supporta ora 10 flussi energetici personalizzati (prima 5), ciascuno con sensore, percorso, colore, direzione e soglia.
• Overlay e flussi in PRO e Preview: Overlay e flussi personalizzati sono modificabili sia nella sezione PRO sia nella Preview Lumina (drag) — trascina per posizionare overlay e flussi nella preview.
• Sfondo personalizzato: Puoi usare un tuo sfondo caricando un’immagine (URL o path locale) o generandone uno con IA tramite token (PRO). Non sei più limitato agli sfondi inclusi.
• Testo array modificabile: Il testo accanto a ogni stringa/array FV può essere personalizzato (es. “Stringa 1”, “Array 2”) dall’editor.
• Box Grid e Box PV – scegli cosa mostrare: Box rete e Box PV permettono ora di scegliere cosa visualizzare (es. potenza, giornaliero o sensori custom) in base alle tue esigenze.
• Sensore temperatura casa: Un sensore temperatura casa può essere mostrato sulla card (es. temperatura soggiorno).
• Orologio digitale: Un orologio digitale opzionale mostra l’ora corrente sulla card (stile e posizione configurabili).
• Tutti i testi drag-and-drop: Ogni etichetta di testo sulla card (PV, batteria, rete, carico, ecc.) è trascinabile nella preview dell’editor per posizionarla dove vuoi.
• Russo e portoghese: Card e editor sono tradotti in russo e portoghese (oltre a EN, IT, DE, FR, NL).
• Fix #188 (GitHub): Risolto il problema segnalato in GitHub #188.

• Dove si misurano le prestazioni: la card gira nel browser (frontend). Se usi un Raspberry Pi come kiosk (Chromium), CPU/RAM/INP dipendono dal browser sul Pi.
• performance_mode: low: alcuni stili “pesanti” vengono semplificati automaticamente per mantenere la UI reattiva (INP migliore).
  In particolare, shimmer / arrows / fluid_flow vengono convertiti in dots in modalità low.
• performance_mode: auto: di default è “bilanciato”, ma su device poco potenti può scendere automaticamente a low per reattività.
• Vuoi usare tutti gli stili comunque? Imposta performance_mode: high (più CPU/GPU).

Installa direttamente (HACS, un clic):

Clicca il badge → si apre la tua istanza Home Assistant → il repository viene aggiunto a HACS. Poi vai in HACS → Frontend, cerca Lumina Energy Card e installala. Infine: Dashboard → Modifica → Aggiungi scheda → Lumina Energy Card.

HACS (manuale):

1. HACS → Frontend → Custom repositories → Aggiungi https://github.com/Giorgio866/lumina-energy-card (categoria: Dashboard).
2. Cerca Lumina Energy Card, installala.
3. Dashboard → Modifica → Aggiungi scheda → Lumina Energy Card.

Manuale (senza HACS): Copia lumina-energy-card.js e lumina_background.png in /config/www/community/lumina-energy-card/, aggiungi la risorsa Lovelace e riavvia Home Assistant.

type: custom:lumina-energy-card
sensor_pv1: sensor.solar_production
sensor_daily: sensor.daily_production
sensor_bat1_soc: sensor.battery_soc
sensor_bat1_power: sensor.battery_power
sensor_home_load: sensor.home_consumption
sensor_grid_power: sensor.grid_power
background_image: /local/community/lumina-energy-card/lumina_background.png

Usa l’editor visivo della scheda (Modifica → Lumina) per configurare entità, colori e opzioni.

• Pulsante HOME: Sulla card compare un pulsante rotondo HOME (insieme a Echo Alive e Toggle testi, se abilitati). Cliccandolo si apre un pannello laterale a destra con 5 icone: Telecamera, Luci, Temperatura, Sicurezza, Umidità.
• Assegnare le entità: Nell’editor apri la sezione “Gestione casa”. Puoi configurare fino a 6 entità per icona:
  • house_camera_1 … house_camera_6: Entità telecamera. Clic sull’icona Telecamera → popup con griglia delle telecamere.
  • house_lights_1 … house_lights_6: Luci o interruttori. Clic su Luci → elenco con pulsanti ON / OFF.
  • house_temperature_1 … house_temperature_6: Sensori temperatura. Clic su Temperatura → elenco con nomi e valori (°C).
  • house_humidity_1 … house_humidity_6: Sensori umidità. Clic su Umidità → elenco con nomi e valori (%).
  • house_security_1 … house_security_6: Keypad sicurezza (PIN). Clic su Sicurezza → tastierina PIN; i colori cambiano in base allo stato (armato, disarmato, in attesa, ecc.).

Popup telecamere:

• Ogni telecamera ha ▶ Avvia e ■ Stop. Gli stream non partono da soli: clicca ▶ Avvia per avviare.
• Se la telecamera lo supporta, la card usa lo streaming live (ha-camera-stream). Altrimenti mostra istantanee aggiornate periodicamente.
• Chiudi il popup con × o cliccando sull’overlay scuro. È bene cliccare ■ Stop prima di chiudere; in alternativa la card interrompe gli stream automaticamente alla chiusura.

Popup luci:

• Ogni luce/interruttore mostra lo stato (On/Off) e i pulsanti ON / OFF. La card chiama light.turn_on / light.turn_off o switch.turn_on / switch.turn_off in automatico.

• Aree cliccabili: Clicca su PV (badge giornaliero / pannelli), Batteria, Rete, Casa o Inverter per aprire il rispettivo popup.
• Fino a 6 righe per popup: Nell’editor usa sensor_popup_pv_1 … sensor_popup_pv_6 (e analoghi per house, bat, grid, inverter). Puoi impostare nomi personalizzati (sensor_popup_pv_1_name, ecc.) e colori.
• Toggle nei popup: Se assegni entità attive (es. luci, interruttori), nel popup compaiono toggle per accenderle/spegnerle direttamente, senza usare altre schede.
• Chiusura: Clicca sullo sfondo del popup (il rettangolo semi‑trasparente), non sul contenuto, per chiudere. Così si evita di chiudere per sbaglio mentre si usano i toggle.

• Scopo: Mantiene la dashboard attiva sugli Echo Show. Il browser Silk tende a sospendere o chiudere la pagina; Echo Alive lo contrasta.
• Uso: Abilita enable_echo_alive nell’editor (Pulsanti e visibilità testi). Compare un pulsante rotondo come primo a sinistra. Su Echo Show, tieni la dashboard aperta su una vista con Lumina e Echo Alive attivo; la card “sveglia” la pagina per evitare la sospensione.

• Toggle testi: Abilita enable_text_toggle_button per mostrare il pulsante rotondo Testo. Cliccandolo mostri o nascondi tutte le etichette (PV, batteria, rete, ecc.) e usi la card in modalità pulita, solo grafica.
• Stato iniziale: Puoi nascondere i testi di default e mostrarli solo quando serve tramite il toggle.

• battery_power_mode nell’editor:
  • flow (predefinito): Un solo sensore con segno (sensor_battery_flow). Positivo = carica (flusso verso batteria), negativo = scarica (flusso verso inverter).
  • charge_discharge: Due sensori separati, sensor_battery_charge e sensor_battery_discharge. Carica → flusso verso batteria, scarica → flusso verso inverter.

• Cos’è: una barra SOC a 6 segmenti sulla batteria (sembra una “griglia” sulla batteria).
• Toggle: abilita/disabilita dall’editor con battery_overlay_enabled (attiva anche l’immagine overlay batteria).
• Posizione/dimensione: battery_overlay_x, battery_overlay_y, battery_overlay_width, battery_overlay_height, battery_overlay_opacity.

• animation_style (in Colori flussi o Stili animazioni):
  shimmer (predefinito), dashes, dots, arrows.
• animation_speed_factor: Regola la velocità (es. 1 = normale, 2 = più veloce). Con 0 le animazioni sono in pausa.

• Nella sezione Impostazioni generali puoi scegliere il profilo prestazioni con performance_mode:
  • auto (predefinito): bilanciato
  • low: riduce l’uso CPU (animazioni più leggere)
  • high: animazioni più fluide (più CPU)

• Scopo: Mostra la produzione solare stimata con un sole olografico ciano e testo stato (tanto/moderato/poco sole).
• Attivazione: Nell’editor, apri la sezione PRO e imposta:
  • solar_forecast_enabled: true
  • sensor_solar_forecast: sensor.xxx (il tuo sensore)
  • solar_forecast_max_power (es. 10000 W)
• Posizione & stile: Regola solar_forecast_x, solar_forecast_y, solar_forecast_color (default #00FFFF) e solar_forecast_size.
• Nota: Se non compare, verifica che il sensore abbia un valore numerico e che il Toggle testi non stia nascondendo i testi.

Le funzioni PRO richiedono la password PRO (pro_password), sbloccabile dalla sezione PRO dell’editor (supporto PayPal).

• Sensore movimento visibilità testi (text_visibility_sensor):
  Imposta un’entità movimento (es. binary_sensor.corridoio_motion). Al movimento i testi compaiono e restano visibili per 60 secondi dopo l’ultimo movimento. Ideale per tablet a muro con telecamera: i testi si vedono solo quando qualcuno è davanti al dispositivo.
  Se usi il Toggle testi per mostrare i testi, la visibilità dipende solo dal pulsante (nessun timeout da movimento).

• Overlay immagini:
  Fino a 10 PNG trasparenti sopra lo sfondo principale (es. seconda auto, piscina, pala eolica). Configura overlay_image … overlay_image_10, posizione, dimensione e opacità nella sezione PRO. Overlay e flussi custom si modificano anche nella Preview Lumina (drag).

• Attiva la preview Lumina: abilita “Preview Lumina (drag)” nell’editor.

• Overlay immagini (PRO): trascina nella preview per aggiornare X/Y (overlay_image_x, overlay_image_y e immagini 2–5).

• Sfondo: trascina nella preview per aggiornare background_image_x / background_image_y.

• Flussi personalizzati:
  Fino a 10 flussi energetici custom con sensore, percorso, colore e direzione propri. Usa custom_flow_1_enabled … custom_flow_10_enabled, custom_flow_1_sensor … custom_flow_10_sensor, percorso (o preset), colore, soglia. Modificabili in PRO e nella Preview Lumina (drag).

• Testi personalizzati:
  Fino a 5 etichette custom con eventuale valore da sensore, posizione, colore e dimensione font.

• Previsione solare:
  Abilita solar_forecast_enabled, imposta sensor_solar_forecast e regola solar_forecast_max_power, posizione e colore (default #00FFFF).

• La scheda non compare: Verifica che la risorsa Lovelace sia aggiunta e svuota la cache del browser.
• Valori a zero: Controlla gli entity ID e che le entità esistano e siano disponibili.
• Telecamere 403 / non caricano: Le telecamere devono esporre access_token (la maggior parte delle integrazioni HA lo fa). Usa ■ Stop prima di chiudere il popup telecamere.
• Editor lento: Aumenta update_interval o riduci la frequenza di aggiornamento della dashboard.
• Immagini non scaricate con HACS: HACS installa solo il file JavaScript (.js). Per usare gli sfondi predefiniti, scarica le immagini dalla cartella dist (es. lumina_background.png, lumina_background1.png), mettile in /config/www/community/lumina-energy-card/ e ricarica la dashboard. Link diretti: lumina_background.png, lumina_background1.png.

• Licenza: MIT. Vedi LICENSE.
• Segnalazioni e richieste: GitHub.

© 2025 Giorgio866 e contributors.