python-aidot-cameras 0.7.8__tar.gz → 0.7.10__tar.gz

python_aidot_cameras-0.7.10/MANIFEST.in

@@ -0,0 +1 @@
+include src/aidot/py.typed

python_aidot_cameras-0.7.10/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: python-aidot-cameras
+Version: 0.7.10
+Summary: Control AiDot/Leedarson WiFi lights and cameras (WebRTC streaming, two-way audio, PTZ, controls)
+Author-email: cbrightly <chris.brightly@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/cbrightly/python-aidot-cameras
+Project-URL: Issue Tracker, https://github.com/cbrightly/python-aidot-cameras/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp
+Requires-Dist: paho-mqtt>=2.0
+Requires-Dist: cryptography
+Requires-Dist: pycryptodome
+Requires-Dist: dacite
+Provides-Extra: webrtc
+Requires-Dist: aiortc>=1.9.0; extra == "webrtc"
+Requires-Dist: av; extra == "webrtc"
+Requires-Dist: pylibsrtp; extra == "webrtc"
+Requires-Dist: pyopenssl; extra == "webrtc"
+Requires-Dist: numpy; extra == "webrtc"
+Requires-Dist: Pillow; extra == "webrtc"
+Dynamic: license-file
+
+# python-aidot-cameras
+
+Control AIDOT WiFi lights **and cameras** from Python.
+
+This is a camera-capable fork of the upstream lights-only
+[`python-aidot`](https://github.com/Aidot-Development-Team/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`](https://github.com/cbrightly/hass-AiDot), which depends
+on this library.
+
+## Library install
+
+Install from PyPI (the simplest, recommended method):
+
+```bash
+# 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:
+
+```bash
+# 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:
+
+```python
+session = await device_client.async_open_webrtc_stream(on_frame=cb, timeout=30.0)
+# ... session.stop() when done
+```
+
+Two-way (push-to-talk) audio:
+
+```python
+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`](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`](https://github.com/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`](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_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_GOP_PLI_S` | Interval, in seconds, between PLI (keyframe) requests. | `2.0` |
+| `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` | Set to `1` to serve audio on SDES cameras (off by default). | `0` (off) |
+| `AIDOT_SDES_AUDIO_GAIN_DB` | Gain (dB) applied when SDES audio is served. | `-8` |

python_aidot_cameras-0.7.10/README.md

@@ -0,0 +1,111 @@
+# python-aidot-cameras
+
+Control AIDOT WiFi lights **and cameras** from Python.
+
+This is a camera-capable fork of the upstream lights-only
+[`python-aidot`](https://github.com/Aidot-Development-Team/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`](https://github.com/cbrightly/hass-AiDot), which depends
+on this library.
+
+## Library install
+
+Install from PyPI (the simplest, recommended method):
+
+```bash
+# 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:
+
+```bash
+# 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:
+
+```python
+session = await device_client.async_open_webrtc_stream(on_frame=cb, timeout=30.0)
+# ... session.stop() when done
+```
+
+Two-way (push-to-talk) audio:
+
+```python
+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`](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`](https://github.com/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`](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_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_GOP_PLI_S` | Interval, in seconds, between PLI (keyframe) requests. | `2.0` |
+| `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` | Set to `1` to serve audio on SDES cameras (off by default). | `0` (off) |
+| `AIDOT_SDES_AUDIO_GAIN_DB` | Gain (dB) applied when SDES audio is served. | `-8` |

python_aidot_cameras-0.7.10/pyproject.toml

@@ -0,0 +1,77 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "python-aidot-cameras"
+version = "0.7.10"
+description = "Control AiDot/Leedarson WiFi lights and cameras (WebRTC streaming, two-way audio, PTZ, controls)"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "cbrightly", email = "chris.brightly@gmail.com" }]
+requires-python = ">=3.11"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "aiohttp",
+    "paho-mqtt>=2.0",
+    "cryptography",
+    "pycryptodome",
+    "dacite",
+]
+
+[project.optional-dependencies]
+webrtc = [
+    "aiortc>=1.9.0",
+    "av",
+    "pylibsrtp",
+    "pyopenssl",
+    "numpy",
+    "Pillow",
+]
+
+[project.urls]
+Homepage = "https://github.com/cbrightly/python-aidot-cameras"
+"Issue Tracker" = "https://github.com/cbrightly/python-aidot-cameras/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+aidot = ["py.typed"]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 88
+
+[tool.ruff.lint]
+# High-signal rules only; opinionated style (quotes, trailing commas, missing
+# annotations/docstrings, magic values) is intentionally left to the formatter.
+select = ["F", "E4", "E7", "E9", "W", "B", "ASYNC", "RUF", "UP", "SIM", "PIE", "RET", "PERF"]
+ignore = [
+    "E501",                                  # line length: formatter's job
+    "E701", "E741",                          # multiple-statements / ambiguous name: cosmetic
+    "UP035", "UP006", "UP007", "UP045", "UP037", "UP031",  # typing/format style (keep broad compat)
+    "E702",                                  # multiple-statements (semicolon): cosmetic
+    "SIM102", "SIM103", "SIM105", "SIM108", "SIM117",  # collapsible/ternary/suppress/nested: stylistic
+    "ASYNC109", "ASYNC240",                  # timeout-param design; os.path.join is non-blocking
+    "RET504", "RET505", "RET506",            # return-style: stylistic
+    "PERF203", "PERF401",                    # try/except in loop, manual comprehension: stylistic
+    "PIE810",                                # multiple startswith/endswith: stylistic
+    "RUF001", "RUF003", "RUF059",            # ambiguous-unicode (intentional ×), unused-unpacked: cosmetic
+    "B904",                                  # raise-without-from: traceback-chaining style (not enforced)
+    "B008",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["B", "RUF", "SIM", "PERF", "ASYNC", "F811", "PIE", "E731", "E702"]
+# Re-export modules: imports are intentional public re-exports / back-compat shims.
+"__init__.py" = ["F401"]
+# device_client.py re-exports from camera.client mid-file (avoids a circular import).
+"**/device_client.py" = ["F401", "E402"]
+# Inherited ffmpeg streaming engine is process-based (Popen / subprocess poll /
+# SDP file write); a full non-blocking refactor needs on-device testing.
+"src/aidot/camera/client.py" = ["ASYNC110", "ASYNC220", "ASYNC221", "ASYNC230"]

{python_aidot_cameras-0.7.8 → python_aidot_cameras-0.7.10}/src/aidot/aes_utils.py

@@ -31,11 +31,11 @@ def aes_decrypt(ciphertext, key):
 
 def aes_decrypt_to_json(ciphertext: bytes, key: Optional[bytes] = None) -> dict[str, Any]:
     """Decrypt AES encrypted data and parse to JSON.
-    
+
     Args:
         ciphertext: AES encrypted data
         key: AES key (optional, if None, assumes data is already decrypted)
-    
+
     Returns:
         Parsed JSON dict
     """

{python_aidot_cameras-0.7.8 → python_aidot_cameras-0.7.10}/src/aidot/camera/__init__.py

@@ -2,4 +2,4 @@
 
 from .client import CameraMixin, WebRTCSession, SdesSession
 
-__all__ = ["CameraMixin", "WebRTCSession", "SdesSession"]
+__all__ = ["CameraMixin", "SdesSession", "WebRTCSession"]