auri 1.1.2

CLI to control Nanoleaf Aurora devices

Auri - Nanoleaf Aurora CLI

A simple, light-weight tool for controlling multiple Aurora devices from the CLI. Supports the most important functionality of the Nanoleaf app (registering new devices, switching effects, changing brightness, on/off,...) as well as an Ambilight feature that is based on the colors of your main display.

Usage

Installation

As it's a Python3-based application, you can install the CLI simply via pip. pip install auri or python3 -m pip install auri (if your default pip is for Python2) are both acceptable ways of installing.

Device Setup

To find and generate credentials for the Nanoleaf Aurora device in your home, make sure your PC/Laptop is in the same network and run auri device setup. Auri will then guide you through the setup for each device it can find.

You can give each device a name and switch the currently active device by running auri device activate <device name>. In general, all commands will only affect the currently active device. If you want a command to apply to a different device, either activate it or target a specific device via adding -a <device name> to you command.

Basic functionality

Switching effects is done via auri effects, like auri effects play rain. There is a best-effort spelling correction to find the effect you meant even if you mistype or only type a part of the effect name.

Switching brightness and other simple values can be done via ex. auri effects set brightness 50. To get the current values, simply use get instead of set.

The effect list uses terminal colors to show a preview of the effect colors, so auri effects list will show you something like this:

Ambilight

There is a built-in ambilight functionality that is based on your primary display. Use auri effects ambi to start a blocking shell that will update the effect each seconds. It needs to create a new effect on the device to do so, which will be called AuriAmbi so you know what it is.

You can customize the behaviour of the ambilight, just use auri effects ambi --help to see which parameters you can play with, though the default settings work quite nice.

The Ambilight functionality only works on MacOS and Windows (untested), but not on Linux due to the dependency on ImageGrab. If you're using Linux and know of a way to get this working, feel free to shoot me a PR.

Alfred Integration

If you're on MacOS, you can also use this CLI to easily build a Alfred workflow to change effects. Simply run auri device images to generate some preview images for all your effects, then create a simple workflow that has auri alfred prompt as a script filter and pipes the result to auri alfred command as a "run script" action.

Contributing

In case you want new features, feel free to implement them and shoot me a PR. The codebase is small and pretty easy to understand, and in case you're missing a feature it's probably not because it's hard to implement but because I didn't think of it.

Acknowledgements

Some of the code has been (in altered form) taken from Anthony Brians GitHub Project "Nanoleaf". Thanks for figuring out the device discovery Anthony!