Skip to main content

Wiser by Feller API Async Python Library

aioWiserbyfeller codecov PyPI - Version GitHub License

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.

🤝 Contributing

We welcome contributions! To get started:

  1. Create a virtual environment: python -m venv .venv
  2. Install dependencies: pip install ".[test]"
  3. Make your changes.
  4. Write or update unit tests.
  5. Run tests with pytest
  6. 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)

Source distribution for aiowiserbyfeller 2.2.2
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)

Table of built distributions (wheels) for aiowiserbyfeller 2.2.2
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

2.2.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page