🍎 macOS 11 Big Sur or later

macOS Installation

A double-click installer sets everything up and registers a start-on-login service — no Terminal required.

📥 givenergy-dashboard-mac.zip

Apple Silicon & Intel · macOS 11+ · Requires Python 3.9+ (see Step 1)

Note: the app isn't code-signed (Apple charges an annual fee for that on a free project), so on first launch macOS will ask you to confirm. It's a one-time right-click → Open — see Step 2.

Install Python (if you don't have it)

The dashboard runs on Python. Recent macOS versions don't include it by default. Grab the latest installer from python.org/downloads and run it.

If you use Homebrew, you can instead run:

brew install python

Already have Python 3.9 or later? Skip to Step 2.

Unzip and run the installer

Unzip givenergy-dashboard-mac.zip anywhere — your Desktop is fine. Then double-click setup-mac.command.

If macOS blocks it ("unidentified developer"): right-click (or Control-click) setup-mac.command → Open → Open. You only need to do this once.

Prefer the Terminal? Open Terminal, drag the unzipped folder onto the window to cd into it, then run:

bash setup-mac.command

Let it set up

The installer runs automatically and will:

Create a Python environment in ~/Library/Application Support/ACBCGivEnergyDashboard
Install all required packages (needs internet access)
Generate the app icons
Register a start-on-login service (launchd) that runs in the background and restarts itself if it ever stops
Open the dashboard in your browser

No admin password is needed — everything installs in your own user folder.

Set your inverter IP

Open the dashboard's ⚡ Settings screen and enter your inverter's IP address, or edit the config file directly:

~/Library/Application Support/ACBCGivEnergyDashboard/config.ini

Find your inverter's IP in your router's connected-devices list — usually labelled GivEnergy or SA-xxxx.

Open the dashboard

On the Mac itself:

http://localhost:7890

From your phone or another device on the same network, use the Mac's IP address instead of localhost.

The dashboard runs in the background and starts automatically each time you log in. To start or stop it by hand, use start-dashboard.command and stop-dashboard.command in the install folder.

Change the admin password

The Settings screen is protected by a password. The default is password — change it on first use via the ⚡ Settings screen.

Add to your phone (optional)

Open http://<your-mac-ip>:7890 in your phone's browser.

iPhone (Safari): Share → Add to Home Screen → opens full-screen with no browser chrome.

Android (Chrome): menu (⋮) → Add to Home Screen.

Upgrading

Updating to a new version

Upgrades never touch your settings or history. Your config.ini and history.db are always preserved.

Download the new mac zip, unzip it, and run setup-mac.command again. It detects the existing install, keeps your settings and history, and refreshes the application files.

Management

Uninstalling

Open Terminal and run:

launchctl unload ~/Library/LaunchAgents/com.acbcsoftware.givenergy.plist
rm ~/Library/LaunchAgents/com.acbcsoftware.givenergy.plist
rm -rf ~/Library/Application\ Support/ACBCGivEnergyDashboard

Troubleshooting

Common issues

"python3: command not found"

Install Python from python.org (or brew install python) and run the installer again.

"setup-mac.command can't be opened"

That's macOS Gatekeeper on an unsigned app. Right-click (or Control-click) the file → Open → Open. You only need to do this the first time.

Dashboard shows "Connecting…" and never loads

Check the inverter IP in config.ini. The Mac and inverter must be on the same network. The log is at ~/Library/Application Support/ACBCGivEnergyDashboard/dashboard.log.