SolixBar ist eine native macOS-Menueleisten-App fuer Anker SOLIX Uebersichtsdaten.
Sie zeigt Akku, PV, Hauslast, Netzbezug, Energiefluss und Ertrag direkt in der Menueleiste, mit modernem Dashboard, abgedockter schmaler Leiste und Verlaufsgraf.
English: SolixBar is a native macOS menu bar app for Anker SOLIX overview data. It provides a compact menu bar readout, a modern dropdown dashboard, a detachable slim bar, and a history graph.
Die Projekt-Homepage liegt in docs/ und kann mit GitHub Pages veroeffentlicht werden.
English: Project homepage files are in docs/ and can be published with GitHub Pages.
- Native AppKit-Menueleisten-App. / Native AppKit menu bar app.
- Demo-Modus zum Testen ohne Zugangsdaten. / Demo data mode for testing without credentials.
- Live-Daten ueber lokalen JSON-Befehl oder JSON-URL. / Live data via local JSON command or JSON URL.
- Frei waehlbare Menueleistenwerte, Bezeichnungen, Symbole, App-Symbol und Skalierung. / Configurable menu bar values, labels, symbols, app icon visibility, and scaling.
- Optionale farbige Energiefluss-Pfeile in der Menueleiste. / Optional colored energy-flow arrows in the menu bar.
- Abgedockte schmale Leiste mit Andocken-Funktion, Fixieren gegen versehentliches Verschieben und gespeichertem Zustand. / Detachable slim bar with dock action, optional movement lock, and restored state.
- Hell, Dunkel oder automatisch passend zum System. / Light, dark, or automatic system appearance.
- Deutsche oder englische sichtbare App-Texte. / German or English visible app text.
- Login-Autostart. / Login autostart support.
- Aufklapp-Dashboard mit Akku, PV, Hauslast, Netzbezug, Akku-Fluss, Tagesertrag, Gesamtertrag und Status. / Dropdown dashboard with battery, solar, home load, grid import, battery flow, daily yield, total yield, and status.
- Animierter Verlaufsgraf fuer Akku, Solar und Netzbezug. / Animated history graph for battery, solar, and grid import.
- Zeitraeume: Aktuell, 24 Stunden, 7 Tage, 30 Tage und individuell. / Graph ranges: current, 24 hours, 7 days, 30 days, and custom.
- Sichtbare Fragezeichen-Hilfen in den Einstellungen. / Visible question-mark help controls in settings.
- Lokale Logdatei fuer Fehleranalyse:
~/Library/Application Support/SolixBar/SolixBar.log. / Local log file for troubleshooting.
Aktuelle Version / Current version: 0.3.20
Versionshinweise stehen in CHANGELOG.md. / See CHANGELOG.md for release notes.
- macOS 14 oder neuer. / macOS 14 or newer.
- Swift-Toolchain oder Xcode Command Line Tools fuer lokale Builds. / Swift toolchain or Xcode command line tools for building locally.
- Optional: Anker SOLIX Hilfsbefehl mit JSON-Ausgabe oder lokaler JSON-Endpunkt fuer Live-Daten. / Optional: a JSON-producing Anker SOLIX helper command or local JSON endpoint for live data.
Direkt mit SwiftPM starten. / Run directly from SwiftPM:
swift run SolixBarApp-Bundle zum Doppelklicken erstellen. / Create a double-clickable app bundle:
sh scripts/package_app.sh
open outputs/SolixBar.appSolixBar unterstuetzt drei Modi. / SolixBar supports three modes:
Demo: erzeugte Beispieldaten zum Testen der Oberflaeche. / Generated sample data for testing the UI.Lokaler JSON-Befehl: fuehrt einen lokalen Befehl aus und liest JSON aus stdout. / Runs a local command and reads JSON from stdout.JSON-URL: laedt JSON von einer lokalen oder entfernten HTTP-Adresse. / Fetches JSON from a local or remote HTTP endpoint.
Das JSON sollte so aussehen. / The JSON should look like this:
{
"siteName": "Anker SOLIX",
"batteryPercent": 82,
"solarWatts": 642,
"homeWatts": 318,
"gridWatts": -86,
"batteryWatts": 238,
"todayKWh": 3.74,
"totalKWh": 427.8,
"status": "Online",
"updatedAt": "2026-07-06T19:30:00Z"
}Anker stellt keine stabile oeffentliche SOLIX API bereit. Dieses Projekt enthaelt ein vorbereitetes Hilfsscript fuer die inoffizielle Community-Bibliothek thomluther/anker-solix-api.
English: Anker does not provide a stable public SOLIX API. This project includes a helper script prepared for the unofficial community library thomluther/anker-solix-api.
Empfohlener lokaler Befehl fuer SolixBar. / Recommended local command for SolixBar:
/Users/holger/Documents/Codex/2026-07-06/bi/scripts/run_solix_snapshot.shDie App kann die lokale ignorierte Zugangsdaten-Datei fuer dich erstellen. Oeffne
Einstellungen -> Datenquelle, waehle Lokaler JSON-Befehl, trage Mail,
Passwort und Land unter SOLIX Login ein und druecke Speichern.
English: The app can create the local ignored credentials file for you. Open
Einstellungen -> Datenquelle, choose Lokaler JSON-Befehl, enter email,
password, and country under SOLIX Login, then press Speichern.
Du kannst jederzeit zu Demo oder JSON-URL wechseln; SolixBar zeigt nur die
Felder an, die fuer den gewaehlten Modus notwendig sind.
English: You can still switch back to Demo or JSON-URL; SolixBar only shows
the fields needed for the selected mode.
SolixBar schreibt diese lokale Datei. / SolixBar writes this local file:
ANKER_SOLIX_USER='you@example.com'
ANKER_SOLIX_PASSWORD='your-password'
ANKER_SOLIX_COUNTRY='DE'Manueller Beispielbefehl nach Ersetzen der Zugangsdaten. / Manual example command after replacing credentials:
ANKER_SOLIX_USER="you@example.com" \
ANKER_SOLIX_PASSWORD="..." \
ANKER_SOLIX_COUNTRY="DE" \
/path/to/python \
scripts/solix_snapshot.pyTrage den Befehl nur dann unter Lokaler JSON-Befehl ein, wenn du die eingebauten SOLIX-Login-Felder nicht nutzt.
English: Put the command into SolixBar settings under Lokaler JSON-Befehl only if you do not use the built-in SOLIX login fields.
Aus Sicherheitsgruenden keine Zugangsdaten committen. Eine spaetere Verbesserung sollte Zugangsdaten im macOS-Schluesselbund speichern.
English: For security, avoid committing credentials. A future improvement should store credentials in the macOS Keychain.
Das Repository schliesst lokale Build-Produkte, gepackte Apps, Python-Laufzeiten und heruntergeladene API-Checkouts bewusst aus.
English: The repository intentionally excludes local build products, packaged apps, Python runtimes, and downloaded API checkouts.