A tiny Windows tray app that shows your Fox ESS home battery's state of charge in the taskbar.
- The icon shows the battery percentage, coloured green (≥ 50%), amber (≥ 20%) or red, with a fill bar along the bottom.
- A green corner marker means the battery is charging.
!means something went wrong; hover for details. A grey number means the reading is old (for example, just after waking from sleep). - Colours adapt to a light or dark taskbar.
- The tooltip shows charge/discharge power, solar, house load and grid import/export.
- It polls Fox Cloud every 5 minutes by default. Double-click the icon to refresh now.
Not affiliated with or endorsed by Fox ESS. It uses the public Fox ESS Cloud Open API.
- Download
FoxBatteryTaskbar.exe(orFoxBatteryTaskbar-arm64.exefor Windows on ARM) from the latest release. It's a single self-contained file, so you don't need to install .NET. Put it somewhere permanent, e.g.%LOCALAPPDATA%\Programs\FoxBatteryTaskbar\. - Run it. On first run it asks for your Fox Cloud API key.
- Optional: right-click the icon and tick Start with Windows.
Windows 11 hides new tray icons. To keep it visible, drag it from the ^ overflow onto the taskbar. Or go to Settings → Personalization → Taskbar → Other system tray icons and switch Fox Battery Taskbar on.
Right-click the icon ? About / check for updates, download the new exe, choose Exit, then replace the old file. Your settings and key are kept. See CHANGELOG.md for what changed.
- Right-click the icon and untick Start with Windows, then choose Exit.
- Delete the exe.
- Delete
%APPDATA%\FoxBatteryTaskbar(settings and encrypted key). - Optional: revoke the API key in Fox Cloud (User Profile ? API Management).
- Sign in at foxesscloud.com.
- Open your profile (top right) → User Profile → API Management.
- Click Generate API key and paste it into the app.
Settings live in %APPDATA%\FoxBatteryTaskbar\. Use Open settings folder in the tray menu to get there.
| File | Purpose |
|---|---|
apikey.bin |
Your API key, encrypted with Windows DPAPI so only your Windows account can read it. |
settings.json |
Optional settings (below). Created automatically after the first successful read. |
{
"BaseUrl": "https://www.foxesscloud.com",
"DeviceSerial": null,
"PollMinutes": 5
}- BaseUrl:
https://www.foxesscloud.com(Europe/default) orhttps://portal.foxesscloud.us(US). For safety, any other value is ignored and the default is used. See SECURITY.md. - DeviceSerial: your inverter serial number. If it's empty, the app uses the first device on your account.
- PollMinutes: how often to refresh. Values are clamped to 2–1440, because Fox Cloud data only updates every few minutes and the API has a daily call limit.
You can also supply the key with the FOXESS_API_KEY environment variable. It takes priority over the stored key, and the app warns you if you enter a key in the dialog while it's set.
If something goes wrong (network down, Fox Cloud error, unexpected response), the icon shows a red ! with the reason in its tooltip, and the app retries on the next poll.
You need the .NET 10 SDK.
dotnet buildRun the unit tests. They use canned responses in tests/.../Samples, so they need no API key or network:
dotnet testRun a one-off check against your real battery, which prints a reading to the terminal:
dotnet run --project src/FoxBatteryTaskbar -- --testProduce a single self-contained exe in publish/:
dotnet publish src/FoxBatteryTaskbar -c Release -r win-x64 --self-contained -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true -p:EnableCompressionInSingleFile=true -o publishUse -r win-arm64 for an ARM64 build.
- Bump
<Version>inDirectory.Build.propsand add a section to CHANGELOG.md. - Commit, then tag and push, e.g.
git tag -a v0.1.1 -m v0.1.1 && git push origin v0.1.1. - CI builds and tests both architectures, then publishes a GitHub release with the exes,
SHA256SUMS.txtand a build provenance attestation (see.github/workflows/build.yml).
The app icon is generated by tools/make-icon.ps1.
FoxCloudClient.cscallsPOST /op/v0/device/real/query. Each request is signed withmd5(path + "\r\n" + apiKey + "\r\n" + timestampMs), where\r\nis the literal four characters, as Fox's docs specify.BatteryReader.csis the single path from settings + key to a reading, shared by the tray and--test.TrayText.csbuilds the tooltip and keeps it inside Windows' length limit.TrayIconRenderer.csdraws the icon at the taskbar monitor's DPI, so it stays sharp on high-DPI screens, using colours fromTrayPalette.cs.TrayApplicationContext.cswires it together: tray icon, menu, polling, sleep/resume, theme changes and the "Start with Windows"HKCU\...\Runentry.
Issues and pull requests are welcome. main is protected: changes go through a pull request, and the build check (build + tests) must pass. Please run dotnet test before opening a PR.
See SECURITY.md for how the API key is stored and sent, how to verify a download, and how to report a vulnerability.
