nanoleaf 0.3.0

Support The Project

This is a pet project, and I’m doing it because I need API support just as badly as you do. But, if it really does make your life better, I’d appreciate a cup of coffee.

BTC: 1Gr31rgb6UXEdXwbwQGUsadcd7AnY7okXT
LTC: Lajqnm28UipLbzJqvyy4tRQFf39xQy6B48

pip install nanoleaf --upgrade

Finding IP Address

For most people, the IP address that the Aurora uses to communicate is the one assigned by your router, but this might not necessarily be true depending on your network setup. Either way, you can get this by using the setup class. After about 90 seconds, this will return a list of the IP address of every Aurora found on the network.

from nanoleaf import Setup

ipAddressList = Setup.find_auroras()

Generate Auth Token

To generate an auth token, you must first press and hold the power button on the Aurora for about 5-7 seconds, until the white LED flashes briefly. Then, call the Setup class like so:

from nanoleaf import Setup

token = Setup.generate_auth_token("192.168.1.129")

Be sure to store this auth token somewhere for future use. If you lose this token, you’ll have to generate another. Personally, I just keep it in the scripts I’ve written that call this library.

Turn on and set to an effect

from nanoleaf import Aurora

my_aurora = Aurora("169.254.123.123", "5EvbR2FjfmYfAkEtOkEnolnZbe6qOB")
my_aurora.on = True
my_aurora.effect = "Violets Are Blue"

Set multiple Auroras to the same random effect

left_side = Aurora("192.168.1.56", "5EvbR2FjfmYfAkEtOkEnolnZbe6qOB")
right_side = Aurora("192.168.1.78", "fAkeR2FjfmYfAkEtOkEnolnZtOkEn")
right_side.effect_random()
left_side.effect = rightSide.effect

Add a new effect

Presently, you must create your own raw dict that exactly matches the structure found on the API documentation. Methods of making this much easier are planned for future updates.

effect_data = {
    "command": "add",
    "animName": "My Random Animation",
    "animType": "random",
    "colorType": "HSB",
    "animData": None,
    "palette": [
        {
            "hue": 0,
            "saturation": 100,
            "brightness": 100
        },
        {
            "hue": 120,
            "saturation": 100,
            "brightness": 100
        },
        {
            "hue": 240,
            "saturation": 100,
            "brightness": 100
        }
    ],
    "brightnessRange": {
        "minValue": 25,
        "maxValue": 100
    },
    "transTime": {
        "minValue": 25,
        "maxValue": 100
    },
    "delayTime": {
        "minValue": 25,
        "maxValue": 100
    },
    "loop": True
}

my_aurora.effect_add_raw(effect_data)

Delete an effect

my_aurora.effect_delete("My Random Animation")