rjenkinsjr / lufo

NodeJS API/CLI for LEDENET UFO WiFi RGBW controllers.

lufo

These NodeJS modules provide an API and CLI for controlling WiFi RGBW controllers made by LEDENET.

Documentation

• API
• CLI

Unimplemented Features

The following features from the mobile app are not implemented and are unlikely to be implemented in the future:

• Remote access and device naming (these are cloud features; this module is intended to be used in closed/controlled environments)
• Device grouping and timers (you can use the API and write your own code to implement these features if you need them)
• Music/disco/camera modes (these features rely on your mobile device's hardware, making it impossible to replicate them)

Credits

• sidoh for developing the Ruby implementation that gave me the inspiration (and a reference to compare against!) to write this module.
• vikstrous for developing a Golang implementation for similar products under different brands, whose documentation on the UDP command protocol proved very useful. Here's a blog post from the author describing ways to hack LED light bulbs made by the same manufacturer (command set is very similar).
• Scapy and Packet Capture by Grey Shirts, which I used to sniff the UDP and TCP behavior (respectively) of the original Android app.

License/Notices

• This code is licensed under the MIT license.
• This code is not developed, maintained or supported in any way by LEDENET.
• I am not affiliated with LEDENET in any capacity.

Changelog

0.3.2

Fixed broken CLI installation. Tested against NodeJS versions 7.10.1 8.11.4 9.11.2 and 10.9.0.

• API
  • Upgraded lodash@4.17.11 to fix CVE-2018-16487.
• CLI
  • Fixed CLI installation bug (#1).
  • Upgraded lodash@4.17.11 to fix CVE-2018-16487.

0.3.0

Added status caching. Tested against NodeJS versions 7.10.1 8.11.4 9.11.2 and 10.9.0.

• API
  • Added status caching. Status cache is used only when mode is static and is invalidated when a builtin or custom function is defined.
• CLI
  • No changes.

0.2.4

Switch from callback-based API to Promise-based API. Tested against NodeJS versions 7.10.1 8.11.4 9.11.2 and 10.9.0.

• API
  • Converted all public-facing methods (and most private methods) to produce/consume Promises
  • Fixed bug in setWifiApDhcp method where the start octet was accidentally used as both start and end octets
  • UFOs no longer program themselves to disconnect when the NodeJS process exits
  • Add examples to README
• CLI
  • Fix --solo handling for red/green/blue/white commands
  • Fix --help formatting
  • Improve error logging
  • Other fixes
• Other
  • Drop support for NodeJS 4/5/6
  • Do not build the gh-pages branch in CircleCI
  • Fix Git tagging during the deploy process
  • Fix permissions on UDP test shell script
  • Add changelog

0.1.0

First release. Tested against NodeJS versions 4.8.7, 5.12.0, 6.13.1, 7.10.1, 8.10.0 and 9.9.0.