Skip to content

Stable v1.0.0

Latest
Compare
Choose a tag to compare
@DevSrijit DevSrijit released this 10 Nov 19:28
f1fa92d

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 from wled.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 and run, maintaining synchronization with on-screen content.

Improvements

  • Color Correction Persistence: Calibration data is now saved to calibration_cache.json using save_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 adjusting matrix_width and matrix_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