Python language bindings for Embrava BlyncLight devices.
Project description
blync
Control your Embrava BlyncLight from the command-line!
Usage
Use the blync
utility to directly control your Embrava BlyncLight:
$ blync -R # turn the light on with red color and leave it on
$ blync --off # turn the light off
$ blync -RG --dim # turn the light on with yellow color and dim
$ blync -RBG # turn the light on with white color
Colors can be specified by values between 0 and 255 using the lower-case color options or using the upper-case full value options.
$ blync -r 127 # half intensity red
$ blync -r 255 # full intensity red
$ blync -R # also full intensity red
$ blync -r 255 -b 255 -g 255 # full intensity white
$ blync -RBG # full intensity white
If that's not enough fun, there are three builtin color modes:
fli
, throbber
, and rainbow
. All modes continue until the
user terminates with a Control-C or platform equivalent.
$ blync fli
$ blync throbber
$ blync rainbow
Installation
$ python3 -m pip install blynclight
$ python3 -m pip install git+https://github.com/JnyJny/blynclight.git # latest
This module depends on hidapi, which supports Windows, Linux, FreeBSD and MacOS via a Cython module.
Usage:
$ blync [OPTIONS] COMMAND [ARGS]...
Options:
-l, --light-id INTEGER
: Light identifier [default: 0]-r, --red INTEGER
: Red color value range: 0 - 255 [default: 0]-b, --blue INTEGER
: Blue color value range: 0 - 255 [default: 0]-g, --green INTEGER
: Green color value range: 0 - 255 [default: 0]-R, --RED
: Full value red [255]-B, --BLUE
: Full value blue [255]-G, --GREEN
: Full value green [255]-o, --off / -n, --on
: Turn the light off/on. [default: False]-d, --dim
: Toggle bright/dim mode. [default: False]-f, --flash
: Enable flash mode.-p, --play INTEGER
: Select song: 1-15--repeat
: Repeat the selected song. [default: False]--volume INTEGER
: Set the volume: 1-10 [default: 5]-a, --list-available
-v, --verbose
-V, --version
--install-completion
: Install completion for the current shell.--show-completion
: Show completion for the current shell, to copy it or customize the installation.--help
: Show this message and exit.
Commands:
fli
: Flash Light Impressively.rainbow
: BlyncLights Love Rainbows.throbber
: BlyncLight Intensifies.
blync fli
Flash Light Impressively.
This mode cycles light color red, blue, green and then repeats. The user can specify the interval between color changes and the intesity of the colors. Color values specified on the command-line are ignored.
Examples
$ blync fli -n 1 # one second between color changes
$ blync fli -i 128 # light intensity is half as bright
This mode runs until the user interrupts.
Usage:
$ blync fli [OPTIONS]
Options:
-n, --interval FLOAT
: Seconds between flashes. [default: 0.1]-i, --intensity INTEGER
: Integer range: 0 - 255 [default: 255]--help
: Show this message and exit.
blync rainbow
BlyncLights Love Rainbows.
Smoothly transition the color of the light using a rainbow sequence. The user can slow the speed of the color cycling by adding more --slow options to the command line:
Examples
$ blync rainbow -s # slow cycling by 0.1 seconds
$ blync rainbow -ss # slow cycling by 0.15 seconds
This mode runs until the user interrupts.
Usage:
$ blync rainbow [OPTIONS]
Options:
-s, --slow
: Increase color cycle interval by 0.1 seconds.--help
: Show this message and exit.
blync throbber
BlyncLight Intensifies.
This mode increases the intensity of the light color starting with the specified red, green and blue values and ramping the color intensity up and down and repeating. The user can increase the rate of ramp by adding more -f options to the command line:
Examples
$ blync throbber -f # a little faster
$ blync throbber -ff # a little more faster
$ blync -G throbber # throb with a green color
This mode runs until the user interrupts.
Usage:
$ blync throbber [OPTIONS]
Options:
-f, --faster
: Increases speed.--help
: Show this message and exit.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for blynclight-0.10.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | aa5e6728b9286faba20bf0f68e173ca477e2d400e9f78a79562f6f3b477c87b7 |
|
MD5 | a715f39f7cba8dd1e4940046227807f5 |
|
BLAKE2b-256 | 0f14bc74d992b0a61016fd7fdc9ed9b823b15c3521b9d7e4288fb4794d13c03b |