# homewizard-climate-websocket
API/Websocket to control Homewizard Climate devices
---
This library allows you to control your Homewizard Climate devices. There are a multitude of brands that use Homewizard apps for their smart controls.
This was developed in oder to be used in a [Home Assistant](https://www.home-assistant.io/) integration. It has not been thoroughly tested or worked with as a standalone code.
### Supported Devices
This library is in an early stage of development and only works for the following device types returned from the Homewizard Climate API:
- `heaterfan`
It has been tested on the following devices (even though it might work on others too):
- [Princess Smart Heating and Cooling Tower (01.347000.01.001)](https://www.princesshome.eu/en-gb/princess-01-347000-01-001-smart-heating-and-01.347000.01.001)
![](https://www.princesshome.eu/product/image/large/01.347000.01.001_3.jpg)
## Quick start
There's no separate `requirements.txt` file, the dependencies can be found and installed in `setup.py`
```
username = os.environ["HW_CLIMATE_USERNAME"]
password = os.environ["HW_CLIMATE_PASSWORD"]
api = HomeWizardClimateApi(username, password)
api.login()
devices = api.get_devices()
ws = HomeWizardClimateWebSocket(api, devices[0])
ws.connect_in_thread() # There's also a blocking `connect`
time.sleep(5)
```
## Installation
**Stable Release (PyPi):** `pip install homewizard_climate_websocket`<br>
**Local Development:** `pip install .`
## Development
Any help to increase the number of supported devices is much appreciated as I only had access to the one mentioned above.
See [CONTRIBUTING.md](CONTRIBUTING.md) for information related to developing the code.
Raw data
{
"_id": null,
"home_page": "https://github.com/mepla/homewizard_climate_websocket",
"name": "homewizard-climate-websocket",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "homewizard_climate_websocket",
"author": "Mepla",
"author_email": "soheil.nasirian@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/17/8b/8f0400332cd67b76f77b08449a4560806931148375d9b95b0aa9c42d3ddb/homewizard_climate_websocket-0.0.10.tar.gz",
"platform": null,
"description": "# homewizard-climate-websocket\n\nAPI/Websocket to control Homewizard Climate devices\n\n---\n\nThis library allows you to control your Homewizard Climate devices. There are a multitude of brands that use Homewizard apps for their smart controls.\n\nThis was developed in oder to be used in a [Home Assistant](https://www.home-assistant.io/) integration. It has not been thoroughly tested or worked with as a standalone code.\n\n### Supported Devices\nThis library is in an early stage of development and only works for the following device types returned from the Homewizard Climate API:\n\n- `heaterfan`\n\nIt has been tested on the following devices (even though it might work on others too):\n- [Princess Smart Heating and Cooling Tower (01.347000.01.001)](https://www.princesshome.eu/en-gb/princess-01-347000-01-001-smart-heating-and-01.347000.01.001)\n\n![](https://www.princesshome.eu/product/image/large/01.347000.01.001_3.jpg)\n\n## Quick start\nThere's no separate `requirements.txt` file, the dependencies can be found and installed in `setup.py`\n\n```\nusername = os.environ[\"HW_CLIMATE_USERNAME\"]\npassword = os.environ[\"HW_CLIMATE_PASSWORD\"]\napi = HomeWizardClimateApi(username, password)\napi.login()\ndevices = api.get_devices()\nws = HomeWizardClimateWebSocket(api, devices[0])\nws.connect_in_thread() # There's also a blocking `connect`\ntime.sleep(5)\n```\n\n## Installation\n\n**Stable Release (PyPi):** `pip install homewizard_climate_websocket`<br>\n**Local Development:** `pip install .`\n\n## Development\nAny help to increase the number of supported devices is much appreciated as I only had access to the one mentioned above.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for information related to developing the code.\n\n\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "API/Websocket to control Homewizard Climate devices",
"version": "0.0.10",
"split_keywords": [
"homewizard_climate_websocket"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e853236cb663b705706dd391c3c57ad354df4d9ce202c2394951bd1cc4f68e03",
"md5": "9aec664de6c9b43908faa5bf03c68ce4",
"sha256": "e34356df871cfe443fdee79656acdb34bfa4278fbc434fc0a2bdf0eb1282d7fe"
},
"downloads": -1,
"filename": "homewizard_climate_websocket-0.0.10-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "9aec664de6c9b43908faa5bf03c68ce4",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.7",
"size": 10933,
"upload_time": "2023-02-04T12:23:52",
"upload_time_iso_8601": "2023-02-04T12:23:52.911016Z",
"url": "https://files.pythonhosted.org/packages/e8/53/236cb663b705706dd391c3c57ad354df4d9ce202c2394951bd1cc4f68e03/homewizard_climate_websocket-0.0.10-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "178b8f0400332cd67b76f77b08449a4560806931148375d9b95b0aa9c42d3ddb",
"md5": "df44e7a24b034ab6b5cd65c58ed20f22",
"sha256": "492a6d77615026a1ae3cfe2abc3550581456da6b3b151c97a436d1622bc2275f"
},
"downloads": -1,
"filename": "homewizard_climate_websocket-0.0.10.tar.gz",
"has_sig": false,
"md5_digest": "df44e7a24b034ab6b5cd65c58ed20f22",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 14937,
"upload_time": "2023-02-04T12:23:54",
"upload_time_iso_8601": "2023-02-04T12:23:54.263219Z",
"url": "https://files.pythonhosted.org/packages/17/8b/8f0400332cd67b76f77b08449a4560806931148375d9b95b0aa9c42d3ddb/homewizard_climate_websocket-0.0.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-04 12:23:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "mepla",
"github_project": "homewizard_climate_websocket",
"lcname": "homewizard-climate-websocket"
}