Skip to main content

BleBox Python UniAPI

https://img.shields.io/pypi/v/blebox_uniapi.svg

Python API for accessing BleBox smart home devices

Features

  • supports 11 BleBox smart home devices

  • contains functional/integration tests

  • every device supports at least minimum functionality for most common automation needs

  • insight of integration level are accesible from file box_types.py

    (devices with apiLevel lower than defined in BOX_TYPE_CONF will not be supported but higher will)

Contributions are welcome!

Credits

History

2.5.1 (2026-04-21)

  • fix: multisensor current and energy sensor scales

2.5.0 (2024-08-20)

2.4.2 (2024-06-04)

2.4.1 (2024-06-04)

  • fix: rectify ambiguity around powerConsumption and wind sensor types

2.4.0 (2024-06-03)

2.3.0 (2024-03-13)

2.2.2 (2024-02-07)

  • fixed wind reading units to get proper raw m/s value (division by 10, see PR #150)

2.2.1 (2024-01-26)

  • fixed support for power measurement capabilities of switchBox and switchBoxD devices

2.2.0 (2023-08-29)

  • added last_reset to energy sensor class

  • added BasicAuth support to http client

2.1.4 (2023-01-03)

  • added tilt position support for cover.Shutter

  • added Wind for wind sensor of multisensors

  • added Energy sensor class for power consumption tracking

  • implementing default_api_level for
    • dimmerBox

    • wLightBox

    • wLightBoxS

2.1.3 (2022-10-27)

  • thermoBox boost mode doesn’t corrupt state

2.1.2 (2022-10-17)

  • fixed CCT, CCTx2 modes for wLightBox v1 & v2

2.1.1 (2022-10-11)

  • added support for thermoBox devices:
    • added thermoBox config to BOX_TYPE_CONFIG

    • Climate uses factory method implementation

    • added test coverage

2.1.0 (2022-08-05)

  • added support for multiSensor API:
    • airQuality moved to sensor module

    • new binary_sensor module, introducing Rain class

2.0.2 (2022-07-06)

  • added query_string property in Button class

  • fixed test assertions after changes in error raised ValueError

2.0.1 (2022-06-01)

  • used ValueError type instead of BadOnValueError in methods:

    • evaluate_brightness_from_rgb

    • apply_brightness

    • normalise_elements_of_rgb

    • _set_last_on_value

    • async_on

2.0.0 (2022-06-21)

  • extended support for color modes in wLightBox devices

  • initial support for tvLiftBox device

  • major backward-incompatible architectural changes to enable dynamic configuration of devices

  • removed products.py module and replaced with factory method on Box class

  • general overhaul of public interfaces

1.3.3 (2021-05-12)

  • fix support for wLightBoxS with wLightBox API

  • fix state detection in gateBox

1.3.2 (2020-04-2)

  • use proper module-level logger by default

  • fix formatting

1.3.1 (2020-04-2)

  • never skip command requests

  • improve error messages

1.2.0 (2020-03-30)

  • expose device info

  • always add ip/port in connection errors

  • fixed gateController support

  • support for sauna min/max temp

1.1.0 (2020-03-24)

  • fix bad wLightBox API path

  • wrap api calls in semaphore (to serialize reqests to each box)

  • throttle updates to 2/second (to avoid unnecessary requests)

  • rework error handling and hierarchy (for cleaner usage)

  • use actual device name (to help recognize the device)

  • handle asyncio.TimeoutError (to handle timeout-related errors nicely)

  • properly re-raise exceptions (to avoid lengthy call stacktraces)

  • rename wLightBoxS feature to “brightness”

1.1.0 (2020-03-24)

  • fix switchBox support

  • fix minimum position handling

  • drop Python 3.6 support (still may work)

  • misc fixes, cleanup and increased test coverage

1.0.0 (2020-03-24)

  • Fixed wLightBox issues

  • Fixed wLightBoxS issues

  • Fixed shutterBox issues

  • Handle unknown shutterBox position

  • Improved error handling + lots of new diagnostics

  • Increased tests and test coverage (almost 100%)

  • Lots of rework

0.1.1 (2020-03-15)

  • Fixed switchBox support (newer API versions)

0.1.0 (2020-03-10)

  • First release on PyPI.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

blebox_uniapi-2.5.7.tar.gz (58.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

blebox_uniapi-2.5.7-py2.py3-none-any.whl (32.9 kB view details)

Uploaded Python 2Python 3

File details

Details for the file blebox_uniapi-2.5.7.tar.gz.

File metadata

  • Download URL: blebox_uniapi-2.5.7.tar.gz
  • Upload date:
  • Size: 58.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for blebox_uniapi-2.5.7.tar.gz
Algorithm Hash digest
SHA256 4262ae1353de4dbdb0338c6f256f5c9f9dc6787f45488407eb5e8fb361d81e46
MD5 444fc31401bb81b83047167482de8532
BLAKE2b-256 f9d5f820aabde802bc5d13c45afb62806b23f8e4d5d95894ffa70ac2b3ebacb7

See more details on using hashes here.

Provenance

The following attestation bundles were made for blebox_uniapi-2.5.7.tar.gz:

Publisher: release.yml on blebox/blebox_uniapi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file blebox_uniapi-2.5.7-py2.py3-none-any.whl.

File metadata

  • Download URL: blebox_uniapi-2.5.7-py2.py3-none-any.whl
  • Upload date:
  • Size: 32.9 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for blebox_uniapi-2.5.7-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 291e64c8a5eeb2dbd1865bdb9a478d0d991af73ac56b31c6a7a8c4f7a5477303
MD5 4cab72231bdb1cb19cc1238e5f532c33
BLAKE2b-256 00ad255529a85bd2d39fce372b25c6fdecf0914af2db98b2f94eef1e13bf29a6

See more details on using hashes here.

Provenance

The following attestation bundles were made for blebox_uniapi-2.5.7-py2.py3-none-any.whl:

Publisher: release.yml on blebox/blebox_uniapi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

2.5.7 This release

2 files

2.5.6

2 files

2.5.5

2 files

2.5.4

2 files

2.5.3

2 files

2.5.2

2 files

2.5.1

2 files

2.5.0

2 files

2.4.2

2 files

2.4.1

2 files

2.4.0

2 files

2.3.0

2 files

2.2.2

2 files

2.2.1

2 files

2.2.0

2 files

2.1.4

2 files

2.1.3

2 files

2.1.2

2 files

2.1.1

2 files

2.1.0

2 files

2.0.2

2 files

2.0.1

2 files

2.0.0

2 files

1.3.3

2 files

1.3.2

2 files

1.3.1

2 files

1.3.0

2 files

1.2.0

2 files

1.1.0

2 files

1.0.0

2 files

0.1.1

2 files

0.1.0

2 files

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