A Windows and Linux driver in Python for the NZXT Hue+
Support me on patreon: https://www.patreon.com/kusti8
A cross-platform driver in Python for the NZXT Hue+. Supports all functionality except FPS, CPU, and GPU lighting.
There is always an easy exe installer available here: https://github.com/kusti8/hue-plus/releases/latest
You must have
portaudio19-devinstalled! To install it system wide, simply install using pip:
sudo pip3 install hue_plusNow it will be available as
hue_uifor the GUI.
Each mode accepts different arguments, so it's easiest to just read the usage. Basic usage is shown below.
sudo hue fixed FFFFFFwhere FFFFFF is the color in hex.
sudo hue -g 1 fixed FFFFFFwill bring up a color picker to choose a color
sudo hue -c 1 fixed FFFFFFwhere 1 is channel one and 2 is channel two
All help and usage can be found by running
The default hue.py now includes the color selector, simply set -g to however many colors you want
No FPS, CPU temp, or GPU temp, but other than that a perfect replica.
Hue_plus can easily be integrated into existing software. The entire codebase is separated into simple functions that separate all usage and can be directly called. The script provides a simple argument wrapper around them, but they are easily usable. I highly suggest you read through the main
hue.main()to get acquianted with how to use it. Each function is slightly different.
import serial import hue_plus
ser = serial.Serial(args.port, 256000) hue_plus.fixed(ser, 0, 0, 'FF0000') # First argument is ser, second is whether to bring up GUI (0=no), third is channel (0=both) and last is the color
|ser||The serial object, created as shown above|
|gui||How many colors to select in the GUI, 0 is none|
|channel||The channel number to use, 1 or 2, 0 is both|
|color(s)||The color(s) to use. If accepts more than 1 color, then in a list (
|speed||The speed, from 0 (Slowest) to 4 (Fastest). 2 is normal|
|size||The amount of LEDs to shine, from 0-3, where 0=3, 1=4, 2=5, 3=6|
|direction||Supports going backwards, where backwards=1 and forwards=0. Not supported in marquee or cover_marquee|
falseif alternating looks like it is moving
|state||For power mode, either
|mode||For custom mode, either
Hue-plus does not automatically run on startup. This will not be added as a feature, but you should do this manually if you want that. For windows, follow this: http://www.thewindowsclub.com/make-programs-run-on-startup-windows. For Mac/Linux, use cron.
I (the author) hold no liability for any broken or not working Hue+ by running this script. It is provided as is. It worked for me, but your milage may vary