lyte 0.1.0__tar.gz

lyte-0.1.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: lyte
+Version: 0.1.0
+Summary: Small dependency-free Python client for Twinkly generation 2 lights
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: numpy>=2.4.6
+Requires-Dist: pydantic
+
+# lyte
+
+Small, dependency-free Python client for Twinkly lights born
+from personal frustration.
+
+I was the principle developer on the classic Bibliopixel package but
+the copyright holder decided to call it in, and so I left the project
+but I want to preserve my animations for the lights I have.
+
+But the only library for the Twinkly protocol uses all sorts of heavy dependencies,
+in particular zeromq, which means only one client per network, which is silly.
+
+This package uses the reverse engineering work of the xled package but in
+a new a stripped build.
+
+This is a proof of concept with:
+
+- UDP discovery on port 5555
+- HTTP authentication and JSON API calls on port 80
+- generation 2 realtime UDP frames on port 7777
+
+Run the diagnostic script from a checkout:
+
+```sh
+python3 scripts/lyte_diagnostic.py
+```
+
+If UDP discovery is blocked by the network, pass the light controller IP:
+
+```sh
+python3 scripts/lyte_diagnostic.py --host 192.168.1.50
+```
+
+Run the Hamiltonian streamer:
+
+```sh
+python3 scripts/lyte_hamiltonian.py --host 192.168.1.50 --speed 80
+```
+
+Increase playback speed:
+
+```sh
+python3 scripts/lyte_hamiltonian.py --host 192.168.1.50 --speed 80
+```

lyte-0.1.0/README.md

@@ -0,0 +1,44 @@
+# lyte
+
+Small, dependency-free Python client for Twinkly lights born
+from personal frustration.
+
+I was the principle developer on the classic Bibliopixel package but
+the copyright holder decided to call it in, and so I left the project
+but I want to preserve my animations for the lights I have.
+
+But the only library for the Twinkly protocol uses all sorts of heavy dependencies,
+in particular zeromq, which means only one client per network, which is silly.
+
+This package uses the reverse engineering work of the xled package but in
+a new a stripped build.
+
+This is a proof of concept with:
+
+- UDP discovery on port 5555
+- HTTP authentication and JSON API calls on port 80
+- generation 2 realtime UDP frames on port 7777
+
+Run the diagnostic script from a checkout:
+
+```sh
+python3 scripts/lyte_diagnostic.py
+```
+
+If UDP discovery is blocked by the network, pass the light controller IP:
+
+```sh
+python3 scripts/lyte_diagnostic.py --host 192.168.1.50
+```
+
+Run the Hamiltonian streamer:
+
+```sh
+python3 scripts/lyte_hamiltonian.py --host 192.168.1.50 --speed 80
+```
+
+Increase playback speed:
+
+```sh
+python3 scripts/lyte_hamiltonian.py --host 192.168.1.50 --speed 80
+```

lyte-0.1.0/lyte/__init__.py

@@ -0,0 +1,87 @@
+"""Small dependency-free Lyte client."""
+
+from .bibliopixel import (
+    Alternates,
+    ColorChase,
+    ColorFade,
+    ColorFill,
+    ColorPattern,
+    ColorWipe,
+    FireFlies,
+    HalvesRainbow,
+    LarsonScanner,
+    LinearRainbow,
+    PartyMode,
+    PixelPingPong,
+    Pulse,
+    Rainbow,
+    RainbowCycle,
+    SaberBlade,
+    Searchlights,
+    Twinkle,
+    Wave,
+    WhiteTwinkle,
+)
+from .client import LyteClient
+from .discovery import DiscoveredDevice, discover
+from .errors import (
+    AuthenticationError,
+    DiscoveryError,
+    LyteError,
+    ProtocolError,
+)
+from .hamiltonian import HamiltonianCounter, HamiltonianStreamer, hamiltonian_colors
+from .random_walk import RandomWalk
+from .retry import RetryConfig, retry_call
+from .session import (
+    authenticate_with_retry,
+    led_count_from_gestalt,
+    read_gestalt,
+    send_frame_with_retry,
+    set_mac_from_gestalt,
+    set_off_mode_with_retry,
+    set_realtime_mode_with_retry,
+)
+
+__all__ = [
+    "AuthenticationError",
+    "Alternates",
+    "ColorChase",
+    "ColorFade",
+    "ColorFill",
+    "ColorPattern",
+    "ColorWipe",
+    "FireFlies",
+    "HalvesRainbow",
+    "DiscoveredDevice",
+    "DiscoveryError",
+    "HamiltonianCounter",
+    "HamiltonianStreamer",
+    "hamiltonian_colors",
+    "LarsonScanner",
+    "LinearRainbow",
+    "PartyMode",
+    "PixelPingPong",
+    "ProtocolError",
+    "Pulse",
+    "Rainbow",
+    "RainbowCycle",
+    "RandomWalk",
+    "SaberBlade",
+    "Searchlights",
+    "LyteClient",
+    "LyteError",
+    "RetryConfig",
+    "Twinkle",
+    "Wave",
+    "WhiteTwinkle",
+    "authenticate_with_retry",
+    "discover",
+    "retry_call",
+    "led_count_from_gestalt",
+    "read_gestalt",
+    "send_frame_with_retry",
+    "set_off_mode_with_retry",
+    "set_mac_from_gestalt",
+    "set_realtime_mode_with_retry",
+]