Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/paulfantom/yaal
Yet Another Ambient Lighting
https://github.com/paulfantom/yaal
Last synced: 4 days ago
JSON representation
Yet Another Ambient Lighting
- Host: GitHub
- URL: https://github.com/paulfantom/yaal
- Owner: paulfantom
- License: other
- Created: 2016-06-05T20:00:08.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-09-23T17:11:19.000Z (over 8 years ago)
- Last Synced: 2024-11-01T09:29:22.716Z (about 2 months ago)
- Language: Python
- Size: 129 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.GPL
Awesome Lists containing this project
README
Yet Another Ambient Lighting
============================
About
-----
Probably the cheapest ambient lighting your monitor can get.
Requirements
------------
- WS2812b LED strip
- Digistump
- python2
- python2-pyserial
- python2-pyqt5 [optional]
Setup
-----
1. Install your WS2812b LED strip with Digistump as a controller.
- Position LED strip to start from **bottom left** corner of your screen.
2. Modify `LEDS_ARRAY` variable in `main.py` file.
- 'L' is LED
- '.' is nothing
`LEDS_ARRAY` **must represent positioning of your LEDs behind the monitor if you want to use this program as Ambilight replacement.** Otherwise you can write only L's for LEDs, ex. `LLLLL` for 5 LEDs.
3. Find name of your display.
- on linux use command `xrandr | grep " connected" | awk '{print $1}'` to find connected displays, ex. `DP1-1`
4. Modify `SCREEN` variable in `main.py` to previously found name of screen. _This is not needed if you are not using Ambilight function_
5. Copy `50-ambilight.rules` to `/etc/udev/rules.d/` or change `DEVICE` variable in `main.py` to serial port on which program will communicate with Digistump
6. Connect Digistump, wait couple of seconds, and run `main.py`
Callibration
------------
Use variables `MIN_RGB` and `MAX_RGB` in `main.py` to set minimum and maximum values for each color.
Usage
-----
Run: `python2 main.py COMMAND` where `COMMAND` is one of the following:
```
off - disable all LEDs
color/colour/rgb [red] [green] [blue] - set color
white [brightness] - light all leds with white color
led POS [red] [green] [blue] - light one led at POSition
avg/mean - screen average color
edge/movie - screen edge color (ambilight)
fade - smoothly fade between colors
rainbow/spectrum [circular/hasselhoff] - show rainbow
kit/knight/hasselhoff - K.I.T. from 'Knight Rider'
countdown SECONDS [red] [green] [blue] - fancy countdown
```
Values written in UPPERCASE are required. Values in brackets are optional.
Other
-----
Package `python2-pyqt5` is needed to quickly grab screenshots.
Code was tested on linux with KDE5 and may not work on other platforms.
Max frame rate is around 25-30fps due to the limitations of the DigistumpCDC library. However, it is enough.