litime-ble 0.1.8

Li Time Bluetooth battery reader via BLE (Python, Bleak)

litime-ble

Lightweight Python library and CLI to read Li Time BLE battery statistics.

Install

Install from source:

pip install .

Quick start

Example (synchronous helper):

from litime_ble import BatteryClient

with BatteryClient.sync(address="AA:BB:CC:DD:EE:FF") as client:
    status = client.read_once()
    print(status.json())

CLI

litime-battery read --address AA:BB:CC:DD:EE:FF --json

For protocol details and advanced usage see docs/README.md.

Developer

Run tests

PowerShell

$env:PYTHONPATH = (Resolve-Path src).Path
python -m pytest -q

macOS / Linux

PYTHONPATH=$(pwd)/src python -m pytest -q

Windows (cmd.exe)

set PYTHONPATH=%cd%\src && python -m pytest -q

Linting

ruff check src --fix
ruff check src

License

This project is licensed under the MIT License.
It follows the same license as the original codebase it was based on: litime-bluetooth-battery.

Copyright (c) 2024 Chad Johnson
Copyright (c) 2025 Konnexio Inc.