Solar Battery View

UUID: battery-view@ccarnivore
Last edited:
18 hours ago 2026-04-11, 18:03
Last commit: [16b9a82d] battery-view@ccarnivore: initial submission of solar battery applet (#8529)

Displays battery state of charge and power flow from a solar inverter (works with Fronius inverters via Solar API v1)

README

Close

Solar Battery View

A Cinnamon panel applet that displays battery state of charge and power flow from a Fronius inverter via the Fronius Solar API v1.

Features

  • Battery icon with color-coded SOC (green/yellow/red) and charge direction arrows (>> charging, << discharging)
  • Solar panel icon showing grid status: green >> (exporting), red << (importing), blue = (neutral)
  • SOC percentage displayed as text between the icons
  • Tooltip with detailed power flow information (battery, PV, grid)
  • Click to refresh data immediately
  • Configurable thresholds for SOC colors, PV production, and grid export/import significance

Requirements

  • A Fronius inverter (tested with Symo GEN24) accessible on the local network
  • The Fronius Solar API v1 must be enabled (default on most models)
  • A battery connected to the inverter (tested with BYD)

Configuration

  • Inverter IP: IP address of your Fronius inverter
  • Poll interval: How often to fetch data (5-300 seconds, click applet for manual refresh)
  • SOC green threshold: SOC percentage at or above which the battery icon turns green
  • SOC yellow threshold: SOC percentage at or above which the battery icon turns yellow (below is red)
  • PV production threshold: PV power below this value is considered inactive (filters noise at night)
  • Grid export/import threshold: Grid exchange below this value is shown as neutral (filters insignificant values)

Icon Legend

Battery Icon (right)

Icon Meaning
Green >> High SOC, charging
Green << High SOC, discharging
Yellow >> Medium SOC, charging
Yellow << Medium SOC, discharging
Red >> Low SOC, charging
Red << Low SOC, discharging
Grey ? Connection error

Solar Icon (left)

Icon Meaning
Green >> Significant grid export (production exceeds consumption)
Red << Significant grid import (consumption exceeds production)
Blue = Neutral (below configured thresholds)

Log In To Comment!

0 Comments