{"id":45431602,"url":"https://github.com/kleinrotti/py-senertec","last_synced_at":"2026-02-22T02:01:20.933Z","repository":{"id":62583378,"uuid":"453414767","full_name":"Kleinrotti/py-senertec","owner":"Kleinrotti","description":"Senertec gen2 python library (unofficial).","archived":false,"fork":false,"pushed_at":"2025-01-06T18:31:04.000Z","size":87,"stargazers_count":2,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-12-05T13:27:38.958Z","etag":null,"topics":["dachs","remeha","senertec"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kleinrotti.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}},"created_at":"2022-01-29T14:04:02.000Z","updated_at":"2025-01-06T18:30:44.000Z","dependencies_parsed_at":"2023-01-30T01:16:00.509Z","dependency_job_id":"b91b7db9-35d1-4a2b-a65b-74b524787861","html_url":"https://github.com/Kleinrotti/py-senertec","commit_stats":{"total_commits":68,"total_committers":2,"mean_commits":34.0,"dds":"0.11764705882352944","last_synced_commit":"c4538d71bb7c099827a36b00aa5fc2d62611482c"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/Kleinrotti/py-senertec","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kleinrotti%2Fpy-senertec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kleinrotti%2Fpy-senertec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kleinrotti%2Fpy-senertec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kleinrotti%2Fpy-senertec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kleinrotti","download_url":"https://codeload.github.com/Kleinrotti/py-senertec/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kleinrotti%2Fpy-senertec/sbom","scorecard":{"id":79323,"data":{"date":"2025-08-11","repo":{"name":"github.com/Kleinrotti/py-senertec","commit":"c4803cfb774065f42f8a97f960acccc8b2ebace4"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.6,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/18 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/release.yml:1","Warn: no topLevel permission defined: .github/workflows/tests.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":1,"reason":"dependency not pinned by hash detected -- score normalized to 1","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/Kleinrotti/py-senertec/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/Kleinrotti/py-senertec/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/Kleinrotti/py-senertec/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/Kleinrotti/py-senertec/tests.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/Kleinrotti/py-senertec/tests.yml/main?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/release.yml:24","Warn: pipCommand not pinned by hash: .github/workflows/release.yml:25","Warn: pipCommand not pinned by hash: .github/workflows/tests.yml:21","Info:   0 out of   4 GitHub-owned GitHubAction dependencies pinned","Info:   1 out of   2 third-party GitHubAction dependencies pinned","Info:   0 out of   3 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/release.yml:12"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact 1.0.3 not signed: https://api.github.com/repos/Kleinrotti/py-senertec/releases/193359399","Warn: release artifact 1.0.2 not signed: https://api.github.com/repos/Kleinrotti/py-senertec/releases/192588375","Warn: release artifact 1.0.1 not signed: https://api.github.com/repos/Kleinrotti/py-senertec/releases/192423619","Warn: release artifact 0.5.0 not signed: https://api.github.com/repos/Kleinrotti/py-senertec/releases/99625283","Warn: release artifact 0.4.0 not signed: https://api.github.com/repos/Kleinrotti/py-senertec/releases/98834063","Warn: release artifact 1.0.3 does not have provenance: https://api.github.com/repos/Kleinrotti/py-senertec/releases/193359399","Warn: release artifact 1.0.2 does not have provenance: https://api.github.com/repos/Kleinrotti/py-senertec/releases/192588375","Warn: release artifact 1.0.1 does not have provenance: https://api.github.com/repos/Kleinrotti/py-senertec/releases/192423619","Warn: release artifact 0.5.0 does not have provenance: https://api.github.com/repos/Kleinrotti/py-senertec/releases/99625283","Warn: release artifact 0.4.0 does not have provenance: https://api.github.com/repos/Kleinrotti/py-senertec/releases/98834063"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 17 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-15T05:28:14.222Z","repository_id":62583378,"created_at":"2025-08-15T05:28:14.223Z","updated_at":"2025-08-15T05:28:14.223Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29703254,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T23:35:04.139Z","status":"online","status_checked_at":"2026-02-22T02:00:08.193Z","response_time":110,"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":["dachs","remeha","senertec"],"created_at":"2026-02-22T02:00:56.611Z","updated_at":"2026-02-22T02:01:20.913Z","avatar_url":"https://github.com/Kleinrotti.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# py-senertec\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![PyPI version](https://badge.fury.io/py/py-senertec.svg)](https://badge.fury.io/py/py-senertec)\n\n## Description\n\nThe **py-senertec** library provides a way to communicate with Senertec Dachsportal2 to monitor your energy unit.\nThis library supports read-only communication. So _changing_ values for your energy unit isn't implemented and not planned.\n\n## Requirements\n\n- **Python \u003e=3.10**\n- **Account for Senertec Dachsportal2/Remeha KWK**\n\n## Tested with these devices\n\nI could test with these devices but others should also work:\n\n- Senertec Dachs 0.8\n- Senertec Dachs InnoGen\n- Senertec Dachs Gen2 F5.5\n- Remeha eLecta 300 (technically same as Senertec Dachs 0.8)\n\n## Installation\n\n```sh\n$ pip install py-senertec\n```\n\n## Usage\n\n### Login and initialization\n\n```python\nfrom senertec.client import senertec\nfrom senertec.canipValue import canipValue\nimport json\n\n# Initialize class\nclient = senertec()\n# set your callback function for messages\nclient.messagecallback = self.output\n# login\nclient.login(\"username\", \"password\")\nclient.init()\n```\n\n### Set the callback function\n\nOnce the websocket has been started, data will be transmitted through the websocket.\nTo get the websocket data, you need to add a callback which was done above.\nThe callback function could look like this:\n\n```python\ndef output(self, value: canipValue):\n        print(value.friendlyDataName + \": \" +\n              value.dataValue.__str__() + value.dataUnit)\n```\n\n### Requesting data\n\n```python\nunits = client.getUnits()\n# connect to first unit in the list\nclient.connectUnit(units[0].serial)\n# request all available datapoints from all boards\n# This should only be used for testing, it recommended to use a filter instead\n# Take a look in the examples folder for a detailed example.\nclient.request(None)\n# logout when you're finished\nclient.logout()\n# or disconnect if you want to connect to another unit afterwards\n# client.disconnectUnit()\n```\n\n### Errors of energy unit\n\nErrors can also be read out with a simple function.\nThe errors are read out on the connect function and will only be refreshed on a reconnect.\n\n```python\n# values are returned directly from function\nerrors = client.getErrors()\n```\n\n### The full example can be found [here](https://github.com/Kleinrotti/py-senertec/blob/main/examples/output_data.py)\n\n## Filtering (recommended)\n\nIf you specify a json string in the request() function you can limit what datapoints should be received.\nThis is recommended if you know what data you want from your heating system e.g. power, temperature.\nBy default all datapoints are included which are more than 400 in most cases and receiving them takes some time and\nsometimes not every value will be received.\nThis json string should look like [this](https://github.com/Kleinrotti/py-senertec/blob/main/examples/datapointFilter.json).\nThe json string contains the productGroup at the top and below the datapoints which should be included.\nYou get the productGroup name from the getUnits() function.\n\nYou can also optionally include the boardname for a datapoint in the json.\nThis is usefull if a datapoint exists in multiple boards but you only want e.g. AM027 from board SCB-04@1.\n\n## What are these datapoints?\n\nTake a look at this manual from [Remeha](https://mediacdn.remeha.de/-/media/websites/remehade/downloads/produkte/regenerative-hybrid/gas-hybrid-waerme-und-strom/electa-ace-300/electaace300_bedienungsanleitung_02-23.pdf?v=1\u0026d=20230228T114400Z) (Page 39).\nThere is already a good explanation of how these datapoints are composed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkleinrotti%2Fpy-senertec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkleinrotti%2Fpy-senertec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkleinrotti%2Fpy-senertec/lists"}