Repository navigation
Releases
0.1.0-beta.1 — 2026-11-10
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
pulsemethod across the crate and CLI:Bulb::pulse,PulseDelta,
PulseParams,PULSE_SCENE_ID = 248,Pilot::effect,Pilot::is_pulsing,
andwizlight pulse <target|--all> --delta <N> --duration <MS>(with--json).
Measured onESP25_SHRGB_01fw 1.38.0 to execute transient fades (50–300 ms
half-cycle) bypassing the ~300 mssetPilotcross-fade ramp.wizlight bench: repeatablesetPilot/setStaterate 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--broadcastflags remain an explicit
override. - Complete local-protocol documentation (
docs/WIZ_PROTOCOL.md), including
measured versus inherited behavior, 120 fps optical benchmark results, and
pulsecharacterisation. - 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_INTERVALinsrc/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 foron,set,pulseandbench, 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 | shInstall 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/wizlightDownload 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
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()andBulbStream: fire-and-forgetsetPilotupdates 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.PushManagerandPushSubscription: one shared UDP listener on:38900, with
bounded per-MACsyncPilotandfirstBeatstreams, per-target source-IP
selection, 20-second registration renewal and awaitable cancellation. A port
owned by another process returns the typedPushUnavailable::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'sregister: false
clears an existing push target even though it came from another socket.- CLI
--coldand--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
setPilotacknowledgement being mistaken for the reply being awaited.
Known gaps
watchandbenchremain 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 | shInstall 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/wizlightDownload 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
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 acurl | 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.ymlis now generated bydist
fromdist-workspace.toml, rather than hand-written. Publishing to crates.io
and the pre-release test gate moved intopublish-crates.ymlandverify.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 | shInstall 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/wizlightDownload 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
What's Changed
- Correct the install instructions for a prerelease by @LucasAmion in #9
- Add CLI scaffold and parser tests by @LucasAmion in #10
- Make the CLI scaffold's plumbing real rather than declared by @LucasAmion in #12
- Add the missing --version, and keep rustdoc out of --help by @LucasAmion in #13
- Add typed pilot builder and protocol methods by @LucasAmion in #11
- Derive what a bulb can do from its moduleName by @LucasAmion in #14
- Add the scene table, measured on hardware by @LucasAmion in #15
- Record RGB+CW conversion as a non-goal, not a gap by @LucasAmion in #17
- Make
discovera command rather than a stub by @LucasAmion in #18 - Address bulbs by MAC, and give the commands something to do by @LucasAmion in #19
- Release 0.1.0-alpha.2 by @LucasAmion in #20
Full Changelog: v0.1.0-alpha.1...v0.1.0-alpha.2
v0.1.0-alpha.1
What's Changed
- Run CI on every push by @LucasAmion in #2
- Add the mock UDP bulb test harness by @LucasAmion in #1
- Keep the version out of the MSRV job name by @LucasAmion in #3
- Add the UDP transport and
Bulb::request()by @LucasAmion in #4 - Correct the mock bulb against the hardware it imitates by @LucasAmion in #5
- Add discovery by UDP broadcast by @LucasAmion in #6
- Add the release workflow and cut 0.1.0-alpha.1 by @LucasAmion in #7
- Check every feature configuration at the MSRV by @LucasAmion in #8
New Contributors
- @LucasAmion made their first contribution in #2
Full Changelog: https://github.com/LucasAmion/wizlight-rs/commits/v0.1.0-alpha.1