Skip to content

README.md

Latest commit

 

History

History
105 lines (78 loc) · 4.21 KB

README.md

File metadata and controls

105 lines (78 loc) · 4.21 KB

HA Findn LED BLE

GitHub Release GitHub Activity License

Project Maintenance Ko-fi Boosty

Home assistant integration to integrate with LED BLE devices, controlled via apps developed by FINDN LTD (MR STAR and SYMPHONY LIGHT).

Example of compatible device: LED strip on Ozon

This integration will set up the following platforms.

Platform Description
light LED BLE device controlled by this integration.

Installation

HACS (Recommended)

  1. Open HACS in your Home Assistant instance
  2. Click on "Integrations"
  3. Click the three dots in the top right corner and select "Custom repositories"
  4. Add https://github.com/hirotasoshu/ha-findn-led-ble as repository, select "Integration" as category
  5. Click "Add"
  6. Find "Findn LED BLE" in the list and click "Download"
  7. Restart Home Assistant
  8. In the HA UI go to "Settings" -> "Devices & Services" click "+" and search for "Findn LED BLE"

Manual Installation

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called findn_led_ble.
  4. Download all the files from the custom_components/findn_led_ble/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. In the HA UI go to "Settings" -> "Devices & Services" click "+" and search for "Findn LED BLE"

Features

This integration supports the following features:

  • Turn on/off - Control the power state of your LED strip
  • Brightness control - Adjust brightness from 1 to 255
  • RGB color control - Set any RGB color
  • HS color control - Set color using hue and saturation
  • 58 built-in effects - Including colorful animations, running water effects, tailing effects, and more

Available Effects

The integration includes 58 pre-configured effects such as:

  • Automatic loop, Symphony, Colorful energy
  • 7 colors effects (strobe, gradient, opening-closing, etc.)
  • Running water effects (7 colors, red-green, blue-purple, etc.)
  • Tailing effects (7 colors, red, green, blue, etc.)
  • Running effects (all colors)
  • And many more!

Using the set_effect Service

You can set effects with optional direction control using the findn_led_ble.set_effect service.

Example service call:

service: findn_led_ble.set_effect
target:
  entity_id: light.led_strip
data:
  effect: "7 colors flowing water"
  direction: forward # optional: forward or backward

Turn off effect:

service: findn_led_ble.set_effect
target:
  entity_id: light.led_strip
data:
  effect: "off"

Contributions are welcome

If you want to contribute to this please read the Contribution guidelines
⚡