wizlight 1.0.0 copy "wizlight: ^1.0.0" to clipboard
wizlight: ^1.0.0 copied to clipboard

A Dart package for controlling WiZ smart light bulbs over UDP using JSON protocol. Port of wizlightcpp with support for discovery, color control, brightness, scenes, and device management.

Changelog #

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.0 - 2025-11-04 #

Added #

  • Initial release of WizLight Dart package
  • Complete port of wizlightcpp functionality to Dart
  • Bulb class for controlling WiZ smart light bulbs
    • Device discovery via UDP broadcast
    • Basic controls (on/off, reboot)
    • Brightness control (0-100%)
    • RGB color control (0-255 per channel)
    • Color temperature control (1000-8000K)
    • Scene selection (32 preset scenes)
    • Animation speed control (0-100%)
    • Device information queries (status, WiFi config, system config, user config)
  • UDPSocket class for UDP communication with broadcast support
  • WizControl class for command handling and CLI operations
  • CLI tool (bin/wizlight.dart) with support for:
    • All bulb control commands
    • Interactive and CLI modes
    • Help and usage information
    • Verbose logging option
  • Comprehensive unit tests
    • Input validation tests
    • JSON request format tests
    • Response parsing tests
    • Command handling tests
  • Example code demonstrating all features
  • Full API documentation with Dartdoc comments
  • README with detailed usage instructions
  • MIT License

Features #

  • Type Safety: Full null-safety support
  • Input Validation: Range checking for all parameters
  • Error Handling: Proper timeout and error handling
  • Logging: Structured logging with configurable levels
  • Cross-Platform: Works on all Dart-supported platforms

Documentation #

  • Comprehensive README.md with examples
  • API reference documentation
  • Usage examples in example/main.dart
  • Scene list reference
  • Protocol details and troubleshooting guide

Testing #

  • Unit tests for Bulb class
  • Unit tests for WizControl class
  • Request format validation tests
  • Response parsing tests
1
likes
150
points
12
downloads

Documentation

API reference

Publisher

verified publisherhornmicro.com

Weekly Downloads

A Dart package for controlling WiZ smart light bulbs over UDP using JSON protocol. Port of wizlightcpp with support for discovery, color control, brightness, scenes, and device management.

Repository (GitHub)
View/report issues

License

MIT (license)

Dependencies

args, logging

More

Packages that depend on wizlight