Skip to content

Releases

0.1.0-beta.1 — 2026-11-10

Pre-release

Choose a tag to compare

@github-actions github-actions released this 10 Nov 16:52
a52f269

Release Notes

The beta where the public API is frozen following the R1 hardware rate spike and
pulse protocol characterisation. The streaming rate default moves from an
unverified 20 Hz placeholder to the measured 5 Hz zero-skip optical ceiling on
hardware.

Added

  • pulse method across the crate and CLI: Bulb::pulse, PulseDelta,
    PulseParams, PULSE_SCENE_ID = 248, Pilot::effect, Pilot::is_pulsing,
    and wizlight pulse <target|--all> --delta <N> --duration <MS> (with --json).
    Measured on ESP25_SHRGB_01 fw 1.38.0 to execute transient fades (50–300 ms
    half-cycle) bypassing the ~300 ms setPilot cross-fade ramp.
  • wizlight bench: repeatable setPilot / setState rate sweep, packet-to-photon
    latency probe and interpolation probe with per-step RTT/jitter/drop statistics,
    stderr sync markers for high-frame-rate camera timing, pre-bench state
    restoration, --rates, --mode <auto|rgb|dimming|set-state>, and
    --pulse-durations.
  • CLI broadcast auto-detection derives one target per viable local IPv4 subnet,
    including multi-homed hosts. Loopback, down, link-local and point-to-point
    interfaces are excluded; repeatable --broadcast flags remain an explicit
    override.
  • Complete local-protocol documentation (docs/WIZ_PROTOCOL.md), including
    measured versus inherited behavior, 120 fps optical benchmark results, and
    pulse characterisation.
  • Runnable discovery and five-channel colour examples, plus additional doc-tests
    for the main configuration, transport, CLI and value-type APIs.
  • Shell completion generation for Bash, Zsh, Fish, PowerShell and Elvish, with
    completion files attached to releases and scene-name suggestions where the
    shell generator supports them.

Changed

  • Default streaming interval (DEFAULT_STREAM_INTERVAL in src/stream.rs)
    changed from 50 ms (20 Hz placeholder) to 200 ms (5 Hz), matching the
    physically measured zero-skip optical ceiling.
  • CLI help now starts with the common discovery and control commands, gives
    examples for on, set, pulse and bench, and keeps every command and
    flag documented.

Install wizlight 0.1.0-beta.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/LucasAmion/wizlight-rs/releases/download/v0.1.0-beta.1/wizlight-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/LucasAmion/wizlight-rs/releases/download/v0.1.0-beta.1/wizlight-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install LucasAmion/tap/wizlight

Download wizlight 0.1.0-beta.1

File Platform Checksum
wizlight-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
wizlight-x86_64-apple-darwin.tar.xz Intel macOS checksum
wizlight-x86_64-pc-windows-msvc.zip x64 Windows checksum
wizlight-aarch64-unknown-linux-musl.tar.xz ARM64 MUSL Linux checksum
wizlight-x86_64-unknown-linux-musl.tar.xz x64 MUSL Linux checksum

0.1.0-alpha.4 — 2026-09-08

Pre-release

Choose a tag to compare

@github-actions github-actions released this 08 Sep 21:23
104431f

Release Notes

The alpha where the library surface needed by WiZzard became complete. Live
producers can write without back-pressure, and callers can receive state changes
without polling. The CLI can also address the cold and warm white emitters that
the library already exposed.

Added

  • Bulb::stream() and BulbStream: fire-and-forget setPilot updates behind a
    capacity-one rate limiter. A producer never waits for the network; the newest
    pending frame replaces stale ones, and sent/coalesced/dropped counters make
    that visible. Shutdown flushes the final frame. The 20 Hz default is explicitly
    provisional until the hardware rate spike measures it.
  • PushManager and PushSubscription: one shared UDP listener on :38900, with
    bounded per-MAC syncPilot and firstBeat streams, per-target source-IP
    selection, 20-second registration renewal and awaitable cancellation. A port
    owned by another process returns the typed PushUnavailable::PortInUse, so a
    caller can fall back to polling.
  • PushManager::refresh(), for immediately restoring every active subscription
    after a discovery scan. Measured on both bulbs: discovery's register: false
    clears an existing push target even though it came from another socket.
  • CLI --cold and --warm, separately addressing the two white emitters and
    composing with --rgb / --hsv. A white emitter can also be sent alone, which
    is a white-only write rather than an addition to the colour already showing.

Fixed

  • Raw channel writes now reject an all-zero group before the wire. The bulb
    silently discards all five zeroes, then may acknowledge another field in the
    request as though the colour had worked.
  • The mock bulb now matches the measured channel behavior: r/g/b/c/w
    are one replacing instruction, omitted channels go dark, and values outside a
    byte are truncated rather than range-checked.
  • A streaming writer and a reliable reader can share one bulb socket without a
    setPilot acknowledgement being mistaken for the reply being awaited.

Known gaps

  • watch and bench remain CLI stubs. Their library foundations now exist, but
    rendering push deltas and the repeatable rate/latency diagnostic are separate
    work.
  • The 20 Hz stream limit is a working value, not the result of the R1 spike.
  • The CLI still does not derive every subnet broadcast address automatically or
    report discovery results as they arrive.

Install wizlight 0.1.0-alpha.4

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/LucasAmion/wizlight-rs/releases/download/v0.1.0-alpha.4/wizlight-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/LucasAmion/wizlight-rs/releases/download/v0.1.0-alpha.4/wizlight-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install LucasAmion/tap/wizlight

Download wizlight 0.1.0-alpha.4

File Platform Checksum
wizlight-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
wizlight-x86_64-apple-darwin.tar.xz Intel macOS checksum
wizlight-x86_64-pc-windows-msvc.zip x64 Windows checksum
wizlight-aarch64-unknown-linux-musl.tar.xz ARM64 MUSL Linux checksum
wizlight-x86_64-unknown-linux-musl.tar.xz x64 MUSL Linux checksum

0.1.0-alpha.3 — 2026-08-26

Pre-release

Choose a tag to compare

@github-actions github-actions released this 26 Aug 18:12
6d65c5f

Release Notes

The alpha that changes how the CLI is installed rather than what it does: there
is no library or protocol change here. Getting wizlight no longer requires a
Rust toolchain and a from-source build.

Added

  • Prebuilt binaries on every release, for macOS (Apple Silicon and Intel),
    Linux (x86-64 and arm64) and Windows (x86-64), alongside a curl | sh
    installer, a PowerShell installer and a Homebrew formula. Installing no longer
    needs a Rust toolchain and a from-source build.
  • The Linux binaries are statically linked against musl, so they carry no
    glibc floor. A gnu build on the CI image would have required glibc 2.35,
    excluding RHEL 9 and derivatives, Debian 11, Ubuntu 20.04 and Alpine.

Changed

  • release.yml is now generated by dist
    from dist-workspace.toml, rather than hand-written. Publishing to crates.io
    and the pre-release test gate moved into publish-crates.yml and verify.yml,
    which it calls; CI checks the generated workflow is current.

Install wizlight 0.1.0-alpha.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/LucasAmion/wizlight-rs/releases/download/v0.1.0-alpha.3/wizlight-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/LucasAmion/wizlight-rs/releases/download/v0.1.0-alpha.3/wizlight-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install LucasAmion/tap/wizlight

Download wizlight 0.1.0-alpha.3

File Platform Checksum
wizlight-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
wizlight-x86_64-apple-darwin.tar.xz Intel macOS checksum
wizlight-x86_64-pc-windows-msvc.zip x64 Windows checksum
wizlight-aarch64-unknown-linux-musl.tar.xz ARM64 MUSL Linux checksum
wizlight-x86_64-unknown-linux-musl.tar.xz x64 MUSL Linux checksum

v0.1.0-alpha.2

v0.1.0-alpha.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 26 Aug 01:29
fb5e186

What's Changed

Full Changelog: v0.1.0-alpha.1...v0.1.0-alpha.2

v0.1.0-alpha.1

v0.1.0-alpha.1 Pre-release
Pre-release

Choose a tag to compare

@LucasAmion LucasAmion released this 15 Aug 03:01
08a4900

What's Changed

New Contributors

Full Changelog: https://github.com/LucasAmion/wizlight-rs/commits/v0.1.0-alpha.1