Zendure EV Guard

How does it work?

Prerequisites

Installation

1. Unzip the archive

Extract the contents of the ZIP file into the directory of your choice, for example:

• Windows: C:\ZendureEvGuard\
• Linux: /home/ZendureEvGuard/
• macOS: /Applications/ZendureEvGuard/

2. Execution permissions (Linux / macOS only)

On Linux and macOS, you must make the file executable before running it:

chmod +x ZendureEvGuard
./ZendureEvGuard

3. Configure appsettings.json

Open the appsettings.json file located next to the executable and fill in your settings (see the section below).

4. Launch the program

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

The program displays the connection information at startup. Use P to pause manually, R to resume, and Ctrl+C twice to stop cleanly.

# Linux
sudo sh install-linux.sh

# macOS
sudo sh install-macos.sh

# Windows (PowerShell as administrator)
powershell -ExecutionPolicy Bypass -File .\install-windows.ps1

[Unit]
Description=ZendureEvGuard - EV Charging Battery Protection Daemon
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
WorkingDirectory=/home/ZendureEvGuard
ExecStart="/home/ZendureEvGuard/ZendureEvGuard"
Restart=on-failure
RestartSec=10
TimeoutStopSec=120
SyslogIdentifier=zendure-evguard
Environment=DOTNET_ENVIRONMENT=Production

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now zendure-evguard

# Voir le statut
sudo systemctl status zendure-evguard

# Voir les logs en temps reel
sudo journalctl -u zendure-evguard -f

# Redemarrer apres une mise a jour
sudo systemctl restart zendure-evguard

Configuration: appsettings.json

Here are all the settings you can configure. The Shelly and ZendureDevice sections are required.

Messages new in 1.3.12

The language of everything you read: emails, Pushover, Telegram, end-of-charge reports. Technical logs remain in English, so that an error message can still be searched for.

Mind the placement: this key goes under the Messages section, never at the root of the file. On Linux, a Language key placed at the root is overwritten by the system's LANGUAGE environment variable, and your messages switch back to English without warning.

"Messages": {
  "Language": "fr"
}

Shelly required

Configuration of your Shelly Pro 3EM. This is the sensor that measures your home's electricity consumption.

Smappee charging station optional

The Smappee charging station can be used in two ways:

• As an EV detection source (alternative to Shelly): if Shelly is disabled, Smappee becomes the power measurement source for detecting EV charging. Detection is done via the Smappee cloud API (5-minute blocks, less responsive than Shelly in real time).
• In parallel with Shelly: if Shelly is active as the detection source, Smappee can still be enabled to continuously display consumption information (solar, home, grid) and information about your Smappee EV Wall (charging power, status, etc.) in the logs.

Battery Zendure required

Configuration of your Zendure SolarFlow 2400 AC hub or others. The IP address can be found in the Zendure app.

EvDetection

Settings for detecting your electric vehicle's charging. The algorithm uses a hysteresis: several consecutive readings above the threshold are needed to confirm charging, and several readings below it are needed to confirm that it has stopped.

Energy new in 1.3.12

At the end of each charge, the program tells you how many kWh have been used. Give it the price of your kWh and it adds the amount. It's indicative, not an invoice: nobody measures the charging station itself, and the price is fixed even though yours may not be.

The use case I'm thinking of: several cars plug in at your place, and each one needs to know what it has used.

The report gives figures for two energies. The one measured at the meter, which is a fact. And the vehicle's estimated share, which subtracts the house's usual consumption: an estimate, and a maximum when your panels were exporting at the time of plugging in.

Charge terminee : 1h03 | 11,30 kWh au compteur (3,16 EUR) |
~11,30 kWh pour le vehicule (3,16 EUR) | pointe 14627 W | moyenne 11169 W

Notification optional

Receive emails when your batteries pause, resume, or in case of an error. Configure your SMTP server.

Pushover optional

Push notifications on your phone via Pushover. Create an application on pushover.net to obtain your API Token.

Telegram optional

Notifications via a Telegram bot. Create a bot with @BotFather and retrieve your Chat ID.

Since 1.2.0, you can notify several groups at once: two people via a first bot, three others via a second. Each send is isolated, an unreachable recipient no longer prevents the others from receiving the message.

"Telegram": {
  "Enabled": true,
  "RateLimitMinutes": 15,
  "Bots": [
    {
      "Name": "Famille",
      "BotToken": "123456:AAExxxxxxxxxxxxxxxxxxxx",
      "ChatIds": [ "11111111", "22222222" ]
    },
    {
      "Name": "Voisins",
      "BotToken": "789012:BBEyyyyyyyyyyyyyyyyyyyy",
      "ChatIds": [ "33333333", "44444444", "55555555" ]
    }
  ]
}

The old form, with a single BotToken and ChatId values separated by semicolons, continues to work. If you don't change anything in your configuration, your notifications continue exactly as before.

Monitoring optional

Update optional

License after the trial

After the 30-day trial period, add your secret key to activate the PRO license. Your key can be found in your account at top right > "My Account". The license renews automatically in the background.

Minimal configuration example

Here is a ready-to-use example. Simply replace the IP addresses with those of your devices:

{
  "Messages": {
    "Language": "fr"
  },
  "Energy": {
    "PricePerKwhCents": 28
  },
  "Shelly": {
    "Enabled": true,
    "Host": "192.168.1.50"
  },
  "ZendureDevice": {
    "Host": "192.168.1.127",
    "Port": 80,
    "DefaultOutputLimit": 2400,
    "DefaultMinSoc": 100
  },
  "EvDetection": {
    "PowerThresholdWatts": 5000
  },
  "Subscription": {
    "SecretKey": "d79d24cc-eb02-48d7-94f8-xxxxxxxxxxxx"
  }
}

With this configuration, the program monitors your Shelly, detects any consumption above 5,000W (for example), and restores your batteries with a minimum of 10% (100 ÷ 10) and a maximum output of 2400W. The Subscription section is empty by default: the program works in trial mode for 30 days. To activate the PRO licence, add your secret key from your account at the top right.

Free trial & subscription