The ultimate energy monitoring experience for Leneda smart meters in Luxembourg.
Completely rewritten from the ground up to offer an "Avant-Garde" visualization, robust device consolidation, and seamless integration.
This isn't just an update; it's a whole new software:
- 🎨 Avant-Garde Dashboard: A stunning, custom-built energy dashboard with glassmorphism, animated flows, and comprehensive stats.
- 🧩 Device Consolidation: Automatically groups consumption, production, and gas meters into a single, logical "Leneda" device.
- ⚡ Real-Time Flow: (Simulated) real-time animations based on your daily data to visualize energy movement.
- 🔋 Energy Community Support: Native support for tracking shared energy within communities.
- 🛠️ Self-Repairing: Automatically handles API outages and preserves sensor states.
- Complete History: Access yesterday's, last week's, and last month's data with pinpoint accuracy.
- Gas Integration: Full support for gas volume (m³) and energy (kWh).
- Zero-Config Calculations: Automatically calculates self-consumption, grid export, and community sharing without complex templates.
The integration includes a standalone dashboard panel that provides:
- Interactive Graphs: Zoomable, panning charts for granular analysis.
- Visual Flow: Beautifully animated energy flow diagrams.
- Metric Insights: Instant visibility into peak power, self-sufficiency, and costs.
| Dashboard | Energy Profile |
|---|---|
 |
 |
| Invoice Estimate & Exceedance Warning | Cost Settings |
|---|---|
 |
 |
No Home Assistant? No problem. The dashboard is available as a hosted web app:
- Go to koosoli.github.io/Leneda-HACS-integration.
- Browse the dashboard with demo data right away.
- To see your real energy data, open Settings and enter your Leneda API credentials (API Key, Energy ID, and Metering Point IDs).
- Your credentials are stored locally in your browser — they are never sent to any third-party server.
- Open HACS in Home Assistant.
- Go to Integrations.
- Click the ⋮ menu (top right) ➜ Custom repositories.
- Add this URL:
https://github.com/koosoli/Leneda-HACS-integration - Category: Integration.
- Find Leneda in the list and click Download.
- Restart Home Assistant.
- Download the latest release from the Releases Page.
- Extract the
custom_components/lenedafolder into your HAconfig/custom_components/directory. - Restart Home Assistant.
Run the dashboard locally without Home Assistant:
Live dev server with hot reload:
cd frontend-src
npm install
npm run dev -- --host localhost --port 5175 --strictPort --openStandalone local server using the built dashboard:
cd frontend-src
npm install
npm run build
cd ../standalone
node server.jsIn both cases, open http://localhost:5175.
For the full standalone guide, see standalone/README.md.
- Go to Settings ➜ Devices & Services.
- Click + Add Integration.
- Search for Leneda.
- Enter your API Key and Metering Point IDs (found in the Leneda Portal).
- (Optional) Set a Reference Power entity to track excess usage charges.
If this integration makes your energy management easier (or just looks cool on your wall), consider buying me a coffee!
Or sponsor me on GitHub: github.com/sponsors/koosoli
Authored by @koosoli.