Package: auri
Auri - Nanoleaf Aurora CLIA 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.UsageInstallationAs it's a Python3-based application, you can install the CLI simply viapip.pip install auriorpython3 -m pip install auri(if your default pip is for Python2) are both acceptable ways of installing.Please note that only Python >= 3.6 is supported due toPillows version constraints, though you're of course free to clone, downgrade the dependency inrequirements.txt, and install it manually if you need to run it on older versions.Device management and setupTo find and generate credentials for the Nanoleaf Aurora device in your home, make sure your PC/Laptop is in the same network and runauri device setup. Auri will then guide you through the setup for each device it can find and allow you to set a name for each device in your home. Auri saves the device data and access tokens in a small file in your application config folder, so you only have to do this once.You can switch the currently active device by runningauri 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, eitherauri device activateit or target a specific device likeauri -a <device name> play Flames.Playing and changing effectsSwitching effects is done viaauri play, likeauri play rain. There is a best-effort spelling correction to find the effect you meant even if you mistype or only provide a part of the effect name. The most common operations are easily accessible, for exampleon,off,brighteranddarkerwill do exactly what you'd expect.auri listwill show you all available effects including a small color preview in the terminal.AmbilightThere is a built-in ambilight functionality that is based on your primary display. Useauri ambito toggle theambimode that will update the effect each seconds. It needs to create a new effect on the device to do so, which will be calledAuriAmbiso you know what it is.You can customize the behaviour of the ambilight, just check your config file (see "Device management and setup") to see which parameters you can play with, though the default settings should work quite nicely without any tuning. The Ambilight functionality only works on MacOS and Windows, but not on Linux due to the dependency onImageGrab. If you're using Linux and know of a way to get this working, feel free to shoot me a PR.Alfred IntegrationIf you're on MacOS, you can also use this CLI to easily build aAlfredworkflow to change effects and have preview images for each effect in your search bar. Simply runauri alfred imagesto generate some preview images for all your effects, then create a simple workflow that hasauri alfred promptas a script filter and pipes the result toauri alfred commandas a "run script" action.ContributingIn 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.AcknowledgementsSome of the code has been (in altered form) taken fromAnthony Brians GitHub Project "Nanoleaf". Thanks for figuring out the device discovery Anthony!