wledControl WLED LED controllers via HTTP API. Use when a user asks to control WLED lights, LED strips, or ESP-based LED controllers. Supports power on/off, brightness, colors (RGB), effects, palettes, presets, and device status.
Install via ClawdBot CLI:
clawdbot install rowbotik/wledControl WLED LED strips and matrices via the HTTP JSON API.
All commands require --host (or -H) with the WLED device IP/hostname.
python3 scripts/wled.py -H <ip> power # Get power state
python3 scripts/wled.py -H <ip> power on # Turn on
python3 scripts/wled.py -H <ip> power off # Turn off
python3 scripts/wled.py -H <ip> brightness # Get current brightness
python3 scripts/wled.py -H <ip> brightness 255 # Max brightness
python3 scripts/wled.py -H <ip> brightness 128 # 50% brightness
python3 scripts/wled.py -H <ip> color 255 0 0 # Red
python3 scripts/wled.py -H <ip> color 0 255 0 # Green
python3 scripts/wled.py -H <ip> color 0 0 255 # Blue
python3 scripts/wled.py -H <ip> color 255 255 255 # White
python3 scripts/wled.py -H <ip> effects # List all effects with IDs
python3 scripts/wled.py -H <ip> effect 0 # Solid color
python3 scripts/wled.py -H <ip> effect 9 # Rainbow
python3 scripts/wled.py -H <ip> effect 9 -s 200 # Rainbow, fast speed
python3 scripts/wled.py -H <ip> effect 9 -i 128 # Rainbow, medium intensity
python3 scripts/wled.py -H <ip> palettes # List all palettes with IDs
python3 scripts/wled.py -H <ip> palette 6 # Set Party palette
python3 scripts/wled.py -H <ip> presets # List saved presets
python3 scripts/wled.py -H <ip> preset 1 # Load preset #1
python3 scripts/wled.py -H <ip> status # Full device status
See references/api.md for complete API documentation.
Avoid passing --host every time by creating a config file at ~/.wled/config.json:
{
"bedroom": "192.168.1.100",
"kitchen": "192.168.1.101",
"living_room": "wled-abc123.local"
}
Then use aliases:
python3 scripts/wled.py -H bedroom brightness 255
python3 scripts/wled.py -H kitchen color 255 0 0
Or set the WLED_HOST environment variable:
export WLED_HOST=192.168.1.100
python3 scripts/wled.py brightness 255
WLED devices can typically be found via:
wled-.local IP addresses change over time. To avoid updating your config, set a static IP on your WLED device:
Option 1: Router-based (easiest)
Option 2: On-device
http://Using mDNS hostnames (e.g., wled-abc123.local) also avoids IP trackingβrouters resolve these automatically.
Generated Mar 1, 2026
Users can integrate WLED with smart home systems to automate lighting based on schedules, motion sensors, or voice commands via assistants like Alexa or Google Home. This enables energy savings and convenience by turning lights on/off or adjusting colors for different times of day or activities.
Event planners or venues use WLED to create dynamic lighting effects for parties, concerts, or themed events by controlling colors, effects, and brightness in real-time. This enhances ambiance and engagement without needing specialized hardware, using simple scripts or manual adjustments.
Retail stores employ WLED to highlight products or create seasonal displays by adjusting lighting colors and effects to attract customers. It allows for quick changes to match promotions or store themes, improving visual merchandising with low-cost LED strips.
Offices use WLED to optimize lighting for productivity and well-being, such as setting bright white light for focus or warm tones for relaxation. Integration with scheduling tools can automate transitions throughout the workday to reduce eye strain and boost morale.
Students or hobbyists utilize WLED in educational settings to learn about IoT, programming, and electronics by controlling LED strips for projects like art installations or science demonstrations. It provides hands-on experience with APIs and network configuration in a practical context.
Sell pre-configured WLED kits with LED strips, controllers, and setup guides, targeting DIY enthusiasts and small businesses. Revenue comes from product sales and optional premium support for installation and troubleshooting, leveraging the skill's ease of use.
Offer managed lighting automation services for homes or businesses, using the skill to remotely control and schedule WLED devices. Revenue is generated through monthly subscriptions for monitoring, updates, and custom effect programming, with tiered plans based on features.
Provide consulting services to integrate WLED into existing smart home or commercial systems, such as linking with other IoT platforms or developing custom scripts. Revenue streams include one-time project fees and ongoing maintenance contracts for complex setups.
π¬ Integration Tip
Set up a static IP or mDNS hostname for your WLED device to avoid connection issues, and use the config file or environment variable to simplify command execution without repeatedly specifying the host.
Control Sonos speakers (discover/status/play/volume/group).
Control Philips Hue lights/scenes via the OpenHue CLI.
Control Eight Sleep pods (status, temperature, alarms, schedules).
BluOS CLI (blu) for discovery, playback, grouping, and volume.
Control Home Assistant smart home devices, run automations, and receive webhook events. Use when controlling lights, switches, climate, scenes, scripts, or any HA entity. Supports bidirectional communication via REST API (outbound) and webhooks (inbound triggers from HA automations).
Use when integrating with Tesla's official Fleet API to read vehicle/energy device data or issue remote commands (e.g. start HVAC preconditioning, wake vehicle, charge controls). Covers onboarding (developer app registration, regions/base URLs), OAuth token flows (third-party + partner tokens, refresh rotation), required domain/public-key hosting, and using Tesla's official vehicle-command/tesla-http-proxy for signed vehicle commands.