Wiser by Feller API Async Python Library
A modern async Python library to control and integrate Wiser by Feller smart light switches, cover controls, and scene buttons, hvac controls and weather stations into your Python applications.
📦 Installation
pip install aiowiserbyfeller
🧑💻 Usage
import asyncio
import aiohttp
from aiowiserbyfeller import Auth, WiserByFellerAPI
async def main():
async with aiohttp.ClientSession() as session:
auth = Auth(session, "192.168.0.42") # Replace with the IP of your µGateway
api = WiserByFellerAPI(auth)
info = await api.async_get_info()
print(info)
asyncio.run(main())
🧰 Basic Functionality
Wiser by Feller devices (except hvac controllers and weather stations) consist of two parts: The control front and the base module. There are switching base modules (for light switches and cover controllers) and non-switching base modules (for scene buttons and secondary controls).
Because the functionality changes when the same base module is used with a different front, the combination of the two is considered an unique device.
Devices are connected with each other by a proprietary K+ bus system. One (and only one) device acts as a WLAN gateway (called µGateway) to interface with the system.
Learn more about Wiser devices on the official website and API documentation.
🚀 Features
Here's what this library offers:
✨ Easy to use framework
The library abstracts API functionality and allows for easy authentication, interaction with devices and data validation. Work with device classes, allowing for strongly typed implementations. Helper methods and properties abstract as much complexity of the API as possible, while retaining full flexibility.
🚨 Status LEDs
Each front features a configurable RGB LED edge for their buttons, that you would normally configure in the Wiser Home app. They can be configured in color and brightness. For buttons controlling a load, there can be two different brightnesses: One for if the load is on and one for if it is off. For others (e.g. scene buttons) there can only be one brightness, as there is no logical "on" state.
The library offers an intuitive way to update status LEDs without the need for complex back and forth with the API, allowing you to use them to represent other information than just the device state (e.g. completion of the washing machine program or motion in another room).
🔌 WebSockets
The µGateway offers a Websocket connection, allowing for instant updates about state changes. This library offers a convenient way to establish a connection and tap into the update notifications.
🧪 Robust test suite
Extensive unit test coverage ensures high stability and confidence even if new functionality is added.
⚠️ Known Limitations
- The µGateway supports REST and WebSockets only. MQTT exists but is not publicly accessible.
- Device names appear in German only, due to limited international support.
- Status LED updates are slow, as they require multiple API calls.
🔗 Related Projects
- Check out the Home Assistant integration built using this library.
🤝 Contributing
We welcome contributions! To get started:
- Create a virtual environment:
python -m venv .venv - Install dependencies:
pip install ".[test]" - Make your changes.
- Write or update unit tests.
- Run tests with
pytest - Open a Pull Request 🎉
Metadata
Release files for aiowiserbyfeller 2.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aiowiserbyfeller-2.2.2.tar.gz | 69.5 kB | Without provenance | Details for aiowiserbyfeller-2.2.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aiowiserbyfeller-2.2.2-py3-none-any.whl | Python 3 | none | any | Details for aiowiserbyfeller-2.2.2-py3-none-any.whl |
Total release size: 126.7 kB
Release files / aiowiserbyfeller-2.2.2.tar.gz
| Download URL | aiowiserbyfeller-2.2.2.tar.gz |
|---|---|
| Size | 69.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3907d93fbc790e8fc781272eaa49df2757897ea0503ed8603738da2125a752c7
|
|
BLAKE2b-256 checksum How to use checksums |
2f76e45edce662a560f9969820b6f3bdcce389fa644eafb1d5a24b3862978867
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / aiowiserbyfeller-2.2.2-py3-none-any.whl
| Download URL | aiowiserbyfeller-2.2.2-py3-none-any.whl |
|---|---|
| Size | 57.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
25d36aef9132bc1f94866c2b307450a113ebb9bddaf58bdb7f7590c1fbdc2f58
|
|
BLAKE2b-256 checksum How to use checksums |
fc863a77b40320a913d89795fcdb76aea32f5bcb54a1c4d21cb97540b7244e17
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Security for aiowiserbyfeller 2.2.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.