python-aidot-cameras
Control AIDOT WiFi lights and cameras from Python.
This is a camera-capable fork of the upstream lights-only
python-aidot. It adds
live WebRTC video streaming (DTLS and SDES-SRTP paths), snapshots, PTZ, camera
controls, cloud recordings/thumbnails, and two-way (push-to-talk) audio.
This repository is the library (distribution name python-aidot-cameras).
The Home Assistant custom component (custom_components/aidot/) lives in the
companion integration repo
cbrightly/hass-AiDot, which depends
on this library.
Library install
Install from PyPI (the simplest, recommended method):
# lights + camera cloud/control only:
pip install python-aidot-cameras
# add live WebRTC streaming, snapshots, and two-way audio:
pip install python-aidot-cameras[webrtc]
[webrtc] pulls in the extra dependencies (aiortc, av, …) needed for live
streaming, snapshots, and two-way audio. Without it you still get lights plus
the camera cloud/control APIs, but not live media.
For the latest unreleased code, install straight from the GitHub repo instead:
# lights + camera cloud/control only:
pip install "git+https://github.com/cbrightly/python-aidot-cameras"
# add live WebRTC streaming, snapshots, and two-way audio:
pip install "python-aidot-cameras[webrtc] @ git+https://github.com/cbrightly/python-aidot-cameras"
Usage
Open a live WebRTC stream from a camera device client:
session = await device_client.async_open_webrtc_stream(on_frame=cb, timeout=30.0)
# ... session.stop() when done
Two-way (push-to-talk) audio:
session = await device_client.async_open_webrtc_stream(..., talk=True)
await session.async_start_talk(pcm_provider) # provider() -> 320B s16le PCM (20ms @ 8kHz), or None
# ... speak ...
await session.async_stop_talk()
See docs/CAMERAS.md for the full camera API (streaming,
snapshots, recordings, motion polling, two-way audio, and LAN-direct media).
Home Assistant component and CLI
The Home Assistant custom component (custom_components/aidot/) is not part
of this library repo - it lives in the companion integration repo
cbrightly/hass-AiDot, which depends
on this library. See that repo for installing the component (via HACS or by
copying custom_components/aidot/).
The test_camera.py CLI harness and the scripts under tools/ are local
developer/diagnostic tools (they carry hardcoded LAN IPs and are gitignored), so
they are not shipped with the published library.
Environment variables
The library reads the following environment variables.
Credentials
Used by the credential helper (aidot.credentials); they take priority over any
stored credentials file. See src/aidot/credentials.py.
| Variable | Purpose | Default |
|---|---|---|
AIDOT_USERNAME |
AiDot account username/email. Used with AIDOT_PASSWORD. |
(none) |
AIDOT_PASSWORD |
AiDot account password. Used with AIDOT_USERNAME. |
(none) |
AIDOT_COUNTRY |
Account region/country code. | US |
Camera streaming / tuning
Optional knobs read by the camera client (aidot.camera.client). Defaults are
chosen to work out of the box; override only when tuning.
| Variable | Purpose | Default |
|---|---|---|
AIDOT_SPROP_DIR |
Directory where captured SPS/PPS (sprop) parameter sets are cached. Set this to a writable path (e.g. for Home Assistant) if the default location is read-only. | <package dir> |
AIDOT_DISABLE_HIGHPORT_FIX |
If set (any value), disables the DTLS high-port USE-CANDIDATE nomination fix and falls back to upstream aioice behavior (used to measure the baseline connect rate). |
unset (fix enabled) |
AIDOT_FAST_CONNECT |
Enables LAN-direct "fast connect" mode (STUN-only, skips several cloud signaling waits) when set to a truthy value. | unset (off) |
AIDOT_PERSISTENT_MQTT |
Reuse ONE account-level persistent MQTT connection for device commands, attribute fetches, AND stream-open signaling (matching the official app) instead of connecting per operation, cutting cloud connect churn. On by default (the app's behaviour; live soak cut SDES NO_MEDIA ~57%→~19%); set to 0/false/no/off to disable. |
enabled (on) |
AIDOT_SDES_ADAPTIVE |
Adaptive fast-with-fallback for the SDES keepalive loop: try the fast path first (skip livePlay waits + TURN relay pre-alloc) and fall back to the full relay path if a fast attempt delivers no media. A per-device cache skips the fast attempt on later views once it has failed for a camera. Truthy value enables. | unset (off) |
AIDOT_SDES_FAST_LIVEPLAY |
Don't block on the livePlayResp wait for eligible SDES cameras (~4.5 s faster cold start), going straight to webrtcReq/ICE — what the official app does (it never waits for livePlayResp). Role-reversal models (A001064 PTZ) always excluded for correctness. On by default; set to 0/false/no/off to disable. |
enabled (on) |
AIDOT_SERVE_RELAY |
Holds the public stream port via an internal relay that proxies to ffmpeg, so the first (cold) view connects instead of failing while ffmpeg can't pre-bind the port. Set to 0 to serve ffmpeg directly. |
1 (enabled) |
AIDOT_MAX_CONCURRENT_OPENS |
Caps how many stream opens run concurrently. | 2 |
AIDOT_MAX_CONCURRENT_STREAMS |
Caps how many cameras stream at once. | 3 |
AIDOT_STREAM_IDLE_S |
Seconds of stream idle before an idle release. | 120 |
AIDOT_SDES_IDLE_RELEASE |
Set to 0 to disable idle release for SDES streams. |
1 (enabled) |
AIDOT_ICE_DISCONNECT_S |
ICE-disconnect debounce, in seconds, before tearing down. | 8 |
AIDOT_DTLS_RETRY_GATE_S |
Minimum spacing, in seconds, between DTLS open retries. | 15 |
AIDOT_BUSY_RETRY_S |
Delay, in seconds, before retrying when a camera reports busy. | 45 |
AIDOT_LIVESTREAM_PARAM |
Set to 0 to skip the cloud liveStreamParam pre-connect that provisions battery cameras' live-stream sessions before signaling (without it, battery cameras like the L2 models reject streaming with -50019). |
1 (enabled) |
AIDOT_GOP_PLI_S |
Interval, in seconds, between PLI (keyframe) requests. | 2.0 |
AIDOT_SDES_PLI_GAPS |
Comma-separated second offsets for the early PLI (keyframe-request) burst on SDES cameras, to pull the first keyframe in faster on cold start. | 0,1.5,2,3 |
AIDOT_AUDIO_TARGET_DBFS |
Target loudness (dBFS) for two-way audio normalization. | -15 |
AIDOT_AUDIO_MAXGAIN_DB |
Maximum gain (dB) applied by the audio normalizer. | 30 |
AIDOT_AUDIO_MINGAIN_DB |
Minimum gain (dB) applied by the audio normalizer. | -12 |
AIDOT_AUDIO_GATE_DBFS |
Noise-gate threshold (dBFS) for two-way audio. | -45 |
AIDOT_SDES_SERVE_AUDIO |
Serve audio on SDES cameras (on by default — a silence-base mix keeps the audio encoder fed so battery-camera audio streams smoothly). Set to 0/false/no/off to disable. |
on |
AIDOT_SDES_AUDIO_GAIN_DB |
Gain (dB) applied when SDES audio is served. | -8 |
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file python_aidot_cameras-0.7.36.tar.gz.
File metadata
- Download URL: python_aidot_cameras-0.7.36.tar.gz
- Upload date:
- Size: 240.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
77f0b8058b50536a87754d6c05025696145071c4f45e9f8de2352abc71b883ef
|
|
| MD5 |
63d0acca839612eae375d3aae416acbe
|
|
| BLAKE2b-256 |
fc6751392058f8d1057180f74022cae7c106ed7cfd98a52b0f68e6033d288b7f
|
Provenance
The following attestation bundles were made for python_aidot_cameras-0.7.36.tar.gz:
Publisher:
publish.yml on cbrightly/python-aidot-cameras
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
python_aidot_cameras-0.7.36.tar.gz -
Subject digest:
77f0b8058b50536a87754d6c05025696145071c4f45e9f8de2352abc71b883ef - Sigstore transparency entry: 1855645236
- Sigstore integration time:
-
Permalink:
cbrightly/python-aidot-cameras@cada1ef014b0465ca3784db4d4ef3efa53f2ca4e -
Branch / Tag:
refs/tags/v0.7.36 - Owner: https://github.com/cbrightly
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@cada1ef014b0465ca3784db4d4ef3efa53f2ca4e -
Trigger Event:
release
-
Statement type:
File details
Details for the file python_aidot_cameras-0.7.36-py3-none-any.whl.
File metadata
- Download URL: python_aidot_cameras-0.7.36-py3-none-any.whl
- Upload date:
- Size: 220.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fed90553915731f4bd61b77f591cecc09c449f47ac4544137fafc948a690a573
|
|
| MD5 |
74618b023301f09b2f9894aacbb835d8
|
|
| BLAKE2b-256 |
fb1bebaeebcd8785557fc6a687483752d4fd45b2c4ba3978f757af419cef5ff0
|
Provenance
The following attestation bundles were made for python_aidot_cameras-0.7.36-py3-none-any.whl:
Publisher:
publish.yml on cbrightly/python-aidot-cameras
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
python_aidot_cameras-0.7.36-py3-none-any.whl -
Subject digest:
fed90553915731f4bd61b77f591cecc09c449f47ac4544137fafc948a690a573 - Sigstore transparency entry: 1855645320
- Sigstore integration time:
-
Permalink:
cbrightly/python-aidot-cameras@cada1ef014b0465ca3784db4d4ef3efa53f2ca4e -
Branch / Tag:
refs/tags/v0.7.36 - Owner: https://github.com/cbrightly
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@cada1ef014b0465ca3784db4d4ef3efa53f2ca4e -
Trigger Event:
release
-
Statement type:
