Skip to content

VoHeCode/shelly_monitor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Shelly Energy Monitor

Deutsch | English below


Deutsch

Was ist das?

Shelly Energy Monitor ist eine einfache App zur Auswertung deines Shelly Pro 3EM Energiezählers. Sie zeigt Verbrauch und Einspeisung deiner Solaranlage übersichtlich als Monats- und Jahresdiagramme an und vergleicht deinen aktuellen Stromtarif mit einem alternativen Tarif.

Die App läuft auf Windows, Linux und Android – ohne Cloud, ohne Abo, ohne Internetverbindung. Alle Daten bleiben lokal auf deinem Gerät.


Wie funktioniert es?

Der Shelly Pro 3EM erfasst den Stromverbrauch minutengenau – speichert die Rohdaten aber nur für die letzten 60 Tage intern. Diese App liest die Daten aus und überführt sie in eine lokale Datenbank auf deinem Gerät.

Wer die App regelmäßig alle 60 Tage startet und synchronisiert, baut sich so eine lückenlose Langzeitstatistik auf. Wird länger nicht ausgelesen, gehen die ältesten Messwerte im Gerät unwiderruflich verloren – es entstehen echte Lücken. Die erfassten Werte bleiben dabei aber immer exakt: Verbrauch und Kosten werden nie geschätzt oder interpoliert, sondern ausschließlich aus tatsächlich vorhandenen Messdaten berechnet. Eine lückenhafte Statistik ist also unvollständiger, aber nie ungenauer.

Zusätzlich ermöglichen die eigenen realen Verbrauchsdaten einen ehrlichen Tarifvergleich: Die App zeigt direkt, ob sich ein alternativer Stromtarif auf Basis des tatsächlichen Verbrauchs gelohnt hätte.


Warum nicht einfach die Shelly Cloud nutzen?

Der Shelly Pro 3EM kann optional mit der Shelly Cloud verbunden werden — das ist aber freiwillig und bedeutet, dass deine Messdaten an die Server von Shelly übertragen werden. Diese App benötigt das nicht: Sie kommuniziert ausschließlich lokal im Heimnetz, deine Daten verlassen das Gerät nie.

Die Shelly Cloud bietet zwar Verbrauchsstatistiken und Kostenanzeige für einen konfigurierten Tarif, ist aber in mehreren Punkten eingeschränkt: Die Daten reichen nur so weit zurück wie der Shelly sie intern gespeichert hat (60 Tage). Ein Tarifvergleich ist seit 2025 in Pilotform verfügbar, aber nur über eine Partnerschaft mit Verivox und nur für bestimmte Länder — ein freier Vergleich mit einem beliebigen Alternativtarif ist nicht möglich.

Diese App bietet darüber hinaus:

  • Unbegrenzte Langzeitstatistik, solange regelmäßig synchronisiert wird
  • Freier Vergleich mit jedem beliebigen Alternativtarif
  • Vollständig offline, keine Datenweitergabe
  • Eine lokale SQLite-Datenbank, die künftig weitere Auswertungen ermöglicht — z.B. Jahresvergleiche, Saisonalität oder CSV-Export

Voraussetzungen

  • Ein Shelly Pro 3EM im Heimnetz
  • Wichtig: Das Gerät (PC, Laptop oder Handy), auf dem die App läuft, muss sich im selben Netzwerk (WLAN oder LAN) befinden wie der Shelly-Zähler. Eine Verbindung über ein fremdes Netz oder VPN funktioniert in der Regel nicht.
  • Python 3.9 oder neuer (nur bei manueller Installation)

Screenshot

Shelly Energy Monitor

Installation

Die fertige APK für Android sowie die ausführbaren Dateien für Windows und Linux befinden sich im Ordner build/.

Für die manuelle Ausführung direkt aus dem Quellcode:

pip install flet requests
python main.py

Erste Schritte

  1. App starten
  2. Den Tab Settings öffnen
  3. Entweder die IP-Adresse deines Shelly Pro 3EM eingeben und mit Enter bestätigen, oder auf Search Shelly klicken – die App sucht dann automatisch im Netzwerk
  4. Sobald der Shelly gefunden wurde, auf Sync data klicken, um die Messdaten zu laden
  5. Die Diagramme werden automatisch befüllt

Einstellungen

Feld Bedeutung
Shelly IP IP-Adresse des Shelly Pro 3EM im Heimnetz
Purchase price per kWh Dein aktueller Bezugspreis in EUR/kWh
Feed-in compensation/kWh Einspeisevergütung in EUR/kWh (0 wenn keine)
Base price/month Monatlicher Grundpreis deines Tarifs
Alt. purchase price/kWh Bezugspreis eines Vergleichstarifs
Alt. base price/month Grundpreis des Vergleichstarifs
Currency Währungszeichen für die Anzeige

Datenmigration

Falls du bereits eine ältere Version der App genutzt hast, kannst du deine bestehende Datenbank über den Tab Import in das neue Format übertragen.


Lizenz

MIT License – siehe LICENSE Frei nutzbar, auch für kommerzielle Zwecke, solange der ursprüngliche Autorenhinweis erhalten bleibt.


English

What is this?

Shelly Energy Monitor is a straightforward app for analysing your Shelly Pro 3EM energy meter. It displays consumption and feed-in data from your solar installation as monthly and yearly bar charts, and compares your current electricity tariff against an alternative one.

The app runs on Windows, Linux and Android – no cloud, no subscription, no internet connection required. All data stays locally on your device.


How it works

The Shelly Pro 3EM measures electricity consumption to the minute – but stores raw data internally for only the last 60 days. This app reads that data and transfers it into a local database on your device.

By launching and syncing the app regularly every 60 days, you build up a complete long-term record. If you wait longer, the oldest measurements are permanently lost from the device and real gaps appear in your statistics. However, the recorded values are always exact: consumption and costs are never estimated or interpolated, but calculated solely from actually available measurements. A statistics with gaps is therefore less complete, but never less accurate.

Your own real consumption data also enables an honest tariff comparison: the app shows directly whether an alternative electricity tariff would have been worth it based on your actual usage.


Why not just use the Shelly Cloud?

The Shelly Pro 3EM can optionally be connected to the Shelly Cloud — but this is voluntary and means your measurement data is transmitted to Shelly's servers. This app does not require that: it communicates exclusively within your local network and your data never leaves your device.

The Shelly Cloud does offer consumption statistics and cost display for a single configured tariff, but is limited in several ways: data only goes back as far as the Shelly has stored it internally (60 days). A tariff comparison feature was introduced in 2025 as a pilot, but only through a partnership with Verivox and only for certain countries — a free comparison with any alternative tariff of your choice is not possible.

This app additionally offers:

  • Unlimited long-term statistics, as long as you sync regularly
  • Free comparison with any alternative tariff you choose
  • Fully offline, no data sharing
  • A local SQLite database that allows further analysis in the future — such as year-on-year comparisons, seasonality, or CSV export

Requirements

  • A Shelly Pro 3EM on your home network
  • Important: The device running this app (PC, laptop or phone) must be connected to the same network (Wi-Fi or LAN) as the Shelly meter. Connections via a separate network or VPN will generally not work.
  • Python 3.9 or higher (manual installation only)

Screenshot

Shelly Energy Monitor

Installation

The ready-to-use APK for Android and the executables for Windows and Linux can be found in the build/ folder.

To run the app manually from source:

pip install flet requests
python main.py

Getting started

  1. Launch the app
  2. Open the Settings tab
  3. Either enter the IP address of your Shelly Pro 3EM and confirm with Enter, or click Search Shelly to let the app scan your network automatically
  4. Once the Shelly has been found, click Sync data to fetch the measurements
  5. The charts will populate automatically

Settings

Field Description
Shelly IP IP address of the Shelly Pro 3EM on your home network
Purchase price per kWh Your current electricity purchase price in EUR/kWh
Feed-in compensation/kWh Feed-in tariff in EUR/kWh (0 if none)
Base price/month Monthly base charge of your tariff
Alt. purchase price/kWh Purchase price of a comparison tariff
Alt. base price/month Base charge of the comparison tariff
Currency Currency symbol used in the display

Data migration

If you have used an older version of this app, you can import your existing database into the new format using the Import tab.


License

MIT License – see LICENSE Free to use, including for commercial purposes, as long as the original copyright notice is retained.

About

Shelly Energy Monitor is a straightforward app for analysing your Shelly Pro 3EM energy meter.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages