Control 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, pr
Real data. Real impact.
Growing
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Control WLED LED strips and matrices via the HTTP JSON API.
All commands require
--host-Hpython3 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~/.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_HOSTexport WLED_HOST=192.168.1.100 python3 scripts/wled.py brightness 255
WLED devices can typically be found via:
wled-<mac>.localIP 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://<current-ip>Using mDNS hostnames (e.g.,
wled-abc123.localNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.