Picoleaf CLI

Use picoleaf to control Nanoleaf light panels.

Setup

1. Find Nanoleaf IP: Check router or use mDNS: dns-sd -Z _nanoleafapi
2. Generate token: Hold power button 5-7 sec until LED flashes, then within 30 sec run: curl -iLX POST http://<ip>:16021/api/v1/new
3. Create config file ~/.picoleafrc:

   host=<ip>:16021
   access_token=<token>
   

Power

• picoleaf on - Turn on
• picoleaf off - Turn off

Brightness

• picoleaf brightness <0-100> - Set brightness percentage

Colors

• picoleaf rgb <r> <g> <b> - Set RGB color (0-255 each)
• picoleaf hsl <hue> <sat> <light> - Set HSL color
• picoleaf temp <1200-6500> - Set color temperature in Kelvin

Examples

• Warm dim light: picoleaf on && picoleaf brightness 30 && picoleaf temp 2700
• Bright blue: picoleaf on && picoleaf brightness 100 && picoleaf rgb 0 100 255
• Turn off: picoleaf off

Notes

• Default port is 16021
• Token generation requires physical access to the Nanoleaf controller
• Multiple commands can be chained with &&