airthings-ble
Library to control Airthings devices through BLE, primarily meant to be used in the Home Assistant integration.
Supported devices
This library supports the following Airthings devices:
- Corentium Home 2
- Wave Enhance
- Wave Gen 1
- Wave Mini
- Wave Plus
- Wave Radon
Unsupported devices
Although some other devices have BLE capabilities, they use BLE only for onboarding and configuration. It is not possible to fetch sensor data using this library from, for example:
- Hub
- Renew
- View Plus
- View Pollution
- View Radon
Getting Started
Prerequisites:
- Python 3.12 or newer. CI tests 3.12, 3.13 and 3.14; Home Assistant itself requires 3.14 (docs or reference)
- Poetry
Install dependencies:
poetry install
Run tests:
poetry run pytest
Run the same checks as CI:
poetry run black --check airthings_ble
poetry run pylint airthings_ble
poetry run mypy airthings_ble
See this wiki page for more details on how to test the library with HA.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Release files for airthings-ble 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| airthings_ble-1.3.0.tar.gz | 15.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| airthings_ble-1.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 35.2 kB
Release files / airthings_ble-1.3.0.tar.gz
| Download URL | airthings_ble-1.3.0.tar.gz |
|---|---|
| Size | 15.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4492c3d0f7d38019bdd56e24b65883f438eb0973a6291946a6b5e38c77851104
|
|
BLAKE2b-256 checksum How to use checksums |
c866985a93647899bff921d80ecca193982a9d609ed497544f7390b973548ccc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency logRelease files / airthings_ble-1.3.0-py3-none-any.whl
| Download URL | airthings_ble-1.3.0-py3-none-any.whl |
|---|---|
| Size | 19.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
94ed2616ab40d5a65206e788c29501dbb48061e75ec6be0d9c6266027e79d574
|
|
BLAKE2b-256 checksum How to use checksums |
06adb3341dbcf619c84847d96511b4c8dea13217aca0d52d28000b85558dd33a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency log
