{"id":15018187,"url":"https://github.com/zerwuff/homebridge-alphaess","last_synced_at":"2025-08-10T15:15:38.127Z","repository":{"id":64857380,"uuid":"578938807","full_name":"zerwuff/homebridge-alphaess","owner":"zerwuff","description":"Alpha ESS Homebridge Connection","archived":false,"fork":false,"pushed_at":"2025-01-22T15:50:38.000Z","size":7810,"stargazers_count":9,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-09T07:56:00.755Z","etag":null,"topics":["alpha","ess","homebridge","homebridge-plugin","homekit","mqtt","storage","sun","tibber"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zerwuff.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-12-16T08:53:06.000Z","updated_at":"2025-03-07T10:09:40.000Z","dependencies_parsed_at":"2024-04-24T15:31:43.412Z","dependency_job_id":"e73e7e93-7c1d-4063-9ebf-dc9645d29180","html_url":"https://github.com/zerwuff/homebridge-alphaess","commit_stats":{"total_commits":373,"total_committers":15,"mean_commits":"24.866666666666667","dds":"0.19034852546916892","last_synced_commit":"e71e775e7d927edcd746c989f9613f97da3c1907"},"previous_names":["2rw0lff/homebridge-alphaess"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/zerwuff/homebridge-alphaess","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerwuff%2Fhomebridge-alphaess","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerwuff%2Fhomebridge-alphaess/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerwuff%2Fhomebridge-alphaess/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerwuff%2Fhomebridge-alphaess/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zerwuff","download_url":"https://codeload.github.com/zerwuff/homebridge-alphaess/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerwuff%2Fhomebridge-alphaess/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269720444,"owners_count":24464284,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-10T02:00:08.965Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alpha","ess","homebridge","homebridge-plugin","homekit","mqtt","storage","sun","tibber"],"created_at":"2024-09-24T19:51:37.286Z","updated_at":"2025-08-10T15:15:38.063Z","avatar_url":"https://github.com/zerwuff.png","language":"TypeScript","funding_links":["https://ko-fi.com/zerwuff"],"categories":[],"sub_categories":[],"readme":"\n# Alpha - ESS Homebridge Plugin\n\nConnecting Alpha ESS OpenAPI Account with your homebridge and automate!\n\n[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)\n\n\u003cimg src=\"Screen.png\" width=\"800\"/\u003e\n\nThis plugin connects the alpha ess open cloud api (https://open.alphaess.com/) to your homebridge and provides values from the Alpha ESS System as sensors:\n - the current battery percentage (SOC) as humidity sensor (0-100)% \n - the current string power (dc+ac combined) as light sensor (watts = lux) \n - the current feed-in power as light sensor (watts = lux). negative - energy going into the net, positive fetching from the net\n - the current consumed power as light sensor (watts = lux).  \n - a contact sensor that is triggered, when the following thresholds are met:\n   - power poading threshold (the generated sun power), eg. 1500w \n   - soc threshold , eg. 10% \n   this enables smart loading of ev batteries depending on the sun. thresholds are configurable\nMore features:\n\n- mqtt messaging included - push energy \u0026 battery status and trigger status to mqtt\n- image rendering 1: daily status of battery soc, sun power\n- image rendering 2: status of alpha and tibber trigger\n  \n# Support me\n\n- https://ko-fi.com/zerwuff\n\n# Building \n\n -  npm run build \u0026\u0026 npm test\n\n# Releasing\n\n - \nnpm version minor \u0026\u0026 npm publish\n# Features \n\n - Show Battery Percentage  (currently as as humidity sensor to enable percentage view)\n\n\n# Installation in Homebridge:\n\nInstall via plugins in the Homebridge Ui, search for :\n``` \n homebridge-alphaess\n```\n\n# Installation in Homebridge:\nRegister App Id and Secret via \n\nhttps://open.alphaess.com/ and use this for the configuration: \n\n\n # Configuration\n```js\n    plattforms: [\n     {\n            \"name\": \"AlphaEssPlatform\",\n            \"platform\": \"AlphaEssPlatform\",\n            \"alphaUrl\":\"https://openapi.alphaess.com/api\", \n            \"appid\": \"XXXX\",  # https://open.alphaess.com/ -\u003e App Id \n            \"appsecret\": \"XXXX\",  # https://open.alphaess.com/ -\u003e App Secret \n            \"serialnumber\": \"AE31005xxxxxxxx\",    # your Serial number\n            \"logrequestdata\": \"false\",        \n            \"powerLoadingThreshold\": 1500, # generated sun power in watts to enable trigger\n            \"socLoadingThreshold\": 42,     # lower threshold of soc to enable trigger. \n            \"refreshTimerInterval\": 300000,  # refresh time intervall in ms. too low time will block requests by alpha backend.  \n            \"mqtt_url\": \"http://localhost:bla\"\n            \"mqtt_status_topic\": \"/topic_for_alpha_ess_status_information\",  # \n            \"mqtt_trigger_topic_true\": \"/topic/to/on\",\n            \"mqtt_trigger_topic_false\": \"/topic/to/off)\",q\n            \"mqtt_trigger_message_true\": \"ON\",\n            \"mqtt_trigger_message_false\": \"OFF\",\n            \"power_image_filename\":\"/tmp/somefilename.png\", # rendered output of todays statistics (PV \u0026 battery) - for camera / image exposing  \n\n            # tibber : experimental !        \n            \"tibberEnabled\": true,\n            \"tibberUrl\": \"https://api.tibber.com/v1-beta/gql\",\n            \"tibberAPIKey\": \"\u003cyour tibber api key\u003e\",\n            \"tibberThresholdSOC\": 60,  // battery threshold on below that tibber loading is triggered. \n            \"tibberThresholdEur\": 0.02,  // tibber threshold (+/-) in euro that will still enable the tibber trigger. e.g. current tibber price is 20 cents,  [18...22] cents will trigger it  \n            \"triggerImageFilename\": \"/tmp/tibber_image.png\" // rendering image of alpha and tibber trigger          \n        }\n    ],\n\n```\n\nNote: all mqtt_* parameters are optional if you do not want to use an mqtt broker.\n\n##  MQTT Configuration parameters:\n\n - `mqtt_url` : a complete mqtt url, including username or password to the mqtt server. if this is omitted, no connection to mqtt is done and the \nfollowing parameters are ignored.\n\n - `mqtt_status_topic` :  a topic name where alpha ess status data is sent to. currently, upon every data update, the following packet is sent to the topic:\n```js\n  \n  { \n    \"Time\": \"2023-02-27T15:08:20.818\", \n    \"ALPHA\": \n    {\n     \"soc\" : 33 ,        #  % of battery soc\n     \"totalPower\": 5000  # total power of watts from the alpha ess system (ac \u0026 dc combined)\n    } \n  }\n\n```   \n\n - `mqtt_trigger_topic_true` :  a topic name where a trigger information is pushed to if the trigger condition is met \n - `mqtt_trigger_message_true` :  a static message that is pushed to the mqtt_trigger_topic_true indicating that the trigger is met\n - `mqtt_trigger_topic_false` :  a topic name where a trigger information is pushed to if the trigger condition is not met \n - `mqtt_trigger_message_false` :  a static message that is pushed to the mqtt_trigger_topic_true indicating that the trigger is not met\n\n\n\n## Image Rendering\nIf you would like to see the rendered images on your home app, please install the Camera FFMpeg plugin which will show the images as cameras and extend the plattforms configuration like this: \n\n```\n    plattforms: [\n  {\n  // alpha ess configuration\n  },\n\n {\n            \"name\": \"Camera FFmpeg\",\n            \"videoProcessor\": \"/usr/local/bin/ffmpeg\",\n            \"cameras\": [\n                {\n                    \"name\": \"AlphaESS\",\n                    \"unbridge\": false,\n                    \"videoConfig\": {\n                        \"source\": \"-f image2 -loop 1 -s 640x360 -pix_fmt yuvj422p -i /tmp/alpha_power_image.png\",\n                        \"stillImageSource\": \"-i file:///tmp/alpha_power_image.png\",\n                        \"audio\": false\n                    }\n                },\n                {\n                    \"name\": \"Trigger\",\n                    \"unbridge\": false,\n                    \"videoConfig\": {\n                        \"source\": \"-f image2 -loop 1 -s 640x360 -pix_fmt yuvj422p -i /tmp/tibber_image.png\",\n                        \"stillImageSource\": \"-i file:///tmp/tibber_image.png\",\n                        \"audio\": false\n                    }\n                }\n            ],\n            \"platform\": \"Camera-ffmpeg\"\n        }\n]\n```\n\n##  Tibber is new experimental:\n\nProvides a new combined trigger that is raised if Alpha or Tibber trigger is fired. Also, rendering for that trigger is possible.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzerwuff%2Fhomebridge-alphaess","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzerwuff%2Fhomebridge-alphaess","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzerwuff%2Fhomebridge-alphaess/lists"}