Releases: DevSrijit/WLED-Ambient-Lighting
Releases · DevSrijit/WLED-Ambient-Lighting
Stable v1.0.0
Release Notes for WLED Ambient Lighting Controller v1.0.0
We are excited to announce the release of WLED Ambient Lighting Controller v1.0, delivering an immersive ambient lighting experience that transforms your environment by extending on-screen visuals to a WLED-enabled LED matrix.
New Features
- Real-Time Screen Capture: Seamlessly captures your screen using
capture_and_process
fromwled.py
to reflect live color dynamics onto your LED matrix. - Advanced Color Processing: Implements Gaussian blurring and spatial smoothing through
spatial_smooth
to ensure smooth color transitions and reduce bleeding between LEDs. - Dynamic Color Flow: Introduces fluid-like motion effects with improved dynamics using
apply_color_flow
, enhancing the natural movement of light across your setup. - Comprehensive Calibration: Offers a guided calibration process via
start_calibration
, ensuring accurate color representation between your display and LED matrix. - Enhanced Performance: Optimized for responsiveness with minimal latency by utilizing multithreading in
start
andrun
, maintaining synchronization with on-screen content.
Improvements
- Color Correction Persistence: Calibration data is now saved to
calibration_cache.json
usingsave_calibration
, allowing for consistent color accuracy across sessions. - Configurable Settings: Added support for customizable settings via
wled_config.json
, enabling adjustments to matrix dimensions and orientation. - Robust Error Handling: Improved stability with enhanced exception handling in
update_wled
to prevent crashes during network disruptions.
Installation
Ensure you have Python 3.x installed along with the required libraries:
pip install numpy mss opencv-python requests scipy pillow
Usage
Run the ambient lighting controller with your WLED device's IP address:
python wled.py --ip <WLED_DEVICE_IP>
Replace <WLED_DEVICE_IP>
with the IP address of your WLED-enabled LED matrix.
Calibration
For optimal color accuracy, initiate the calibration process:
python wled.py --ip <WLED_DEVICE_IP> --calibrate
Configuration
Customize your setup by editing
wled_config.json
:
{
"orientation": {
"flip_horizontal": true,
"flip_vertical": true,
"rotate": 270,
"start_corner": "top_left",
"serpentine": true
},
"matrix_width": 12,
"matrix_height": 6
}
Known Issues
- High CPU Usage: If you experience performance issues, consider lowering the
update_rate
or adjustingmatrix_width
andmatrix_height
in the configuration file.
Acknowledgments
Special thanks to the contributors and the open-source community for making this release possible.
Full Changelog: https://github.com/DevSrijit/WLED-Ambient-Lighting/commits/Stable