aurora_core

A Python Library Controls Nanoleaf Light Panels (formerly Aurora)

Usage

• The libaray contains three main classes: Discover, Manager, and Aurora. After getting an Aurora instance, the usage should be straightforward:

aurora.get.name()				#return the name of the panel cluster
aurora.set.on(False)				#turn off the panel cluster
aurora.set.effect('Rainfall')			#set effect to "Rainfall"

• To get an Aurora instance, the easiest way is using the Discover class:

from aurora_core import Discover

def authed_handler(aurora):			#the callback function once a new aurora got authed
	print aurora.get.name(), aurora.get.serial()
	aurora.set.brightness(50)
	
discover = Discover([], authed_handler)		#[] is all auroras need to be ignored
discover.start()

You have to hold the power button for ~5 seconds to give this script permission to access the Light Panels. This script will set the cluster brightness to 50% after finishing authorization.

• Apparently no one want to authenticate/permit access everytime. Manager provides basic Aurora object management, including data persistence:

from aurora_core import Manager
manager = Manager('example_db')			#local data store at `example_db`

for aurora in manager.auroras():		#print out all local aurora names
	print aurora.get.name()
manager.save(new_aurora)			#save new_aurora to local
manager.delete(new_aurora)			#delete new_aurora from local

Please note that the Manager is using pickle internally, so no encryption will be applied on the local storage.