Attributes¶
We touched on modifying light attributes in the getting started section; in this section we will look at some more advanced means Hueman can modify the state of lights offering a greater degree of flexibility.
Relative Values and Percentages¶
The following attributes (and their aliases) can be modified using percentages and relative values:
- bri
- hue
- sat
- ct
Supported operations are:
Absolute percentage:
% hueman -a bri:100% # set brightness to 255
Relative percentage:
% hueman -a bri:~50% # set brightness to 50% of current value, 127
Addition and Subtraction:
% hueman -a bri:+23 # increase brightness by 23 -> 150 % hueman -a bri:-50 # decreate brightness by 50 -> 100
You can also do relative percentage addition and substraction:
% hueman -a bri:-50% # decreate brightness by 50% -> 50 % hueman -a bri:+200% # increase brightness by 200% -> 150
These values are also clippped within their known ranges, to avoid any weird behaviour:
% hueman -a bri:500 # brightness is set to known max, 255
Fancy Durations¶
The default unit for transitiontime
is tenths of a second, not very Hueman at all. Hueman understands seconds and minutes:
% hueman -a bright transitiontime:900 # 900 tenths of a second (or 90 seconds, or one and a half minutes)
% hueman -a bright time:1m30s # as above, but much more readable
Note that time
is simply an alias of transitiontime
, both keys will accept either format of duration.