{"id":40080436,"url":"https://github.com/dave-code-ruiz/elkbledom","last_synced_at":"2026-08-06T08:52:34.088Z","repository":{"id":37686194,"uuid":"497924778","full_name":"dave-code-ruiz/elkbledom","owner":"dave-code-ruiz","description":"Home Assistant custom component for LED STRIP NAMED ELK- , MELK- , LEDBLE or XROCKER","archived":false,"fork":false,"pushed_at":"2026-04-24T12:33:57.000Z","size":393,"stargazers_count":178,"open_issues_count":3,"forks_count":46,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-04-24T14:33:33.245Z","etag":null,"topics":["hacs-custom","hacs-integration","home-assistant","home-automation","led-controller","ledstrips","light"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dave-code-ruiz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-05-30T12:02:30.000Z","updated_at":"2026-04-24T12:34:01.000Z","dependencies_parsed_at":"2023-02-01T03:50:23.581Z","dependency_job_id":"a748c983-cc5b-4582-b273-5c27f5386fa2","html_url":"https://github.com/dave-code-ruiz/elkbledom","commit_stats":null,"previous_names":[],"tags_count":56,"template":false,"template_full_name":null,"purl":"pkg:github/dave-code-ruiz/elkbledom","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dave-code-ruiz%2Felkbledom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dave-code-ruiz%2Felkbledom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dave-code-ruiz%2Felkbledom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dave-code-ruiz%2Felkbledom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dave-code-ruiz","download_url":"https://codeload.github.com/dave-code-ruiz/elkbledom/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dave-code-ruiz%2Felkbledom/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36331750,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-08-06T04:43:03.162Z","status":"ssl_error","status_checked_at":"2026-08-06T04:43:02.660Z","response_time":54,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacs-custom","hacs-integration","home-assistant","home-automation","led-controller","ledstrips","light"],"created_at":"2026-01-19T09:06:27.010Z","updated_at":"2026-08-06T08:52:34.075Z","avatar_url":"https://github.com/dave-code-ruiz.png","language":"Python","funding_links":["https://www.buymeacoffee.com/davecoderuiz"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# ELK-BLEDOM Integration for Home Assistant\n\n[![hacs_badge](https://img.shields.io/badge/HACS-Default-41BDF5.svg)](https://github.com/hacs/integration)\n[![GitHub Release](https://img.shields.io/github/release/dave-code-ruiz/elkbledom.svg)](https://github.com/dave-code-ruiz/elkbledom/releases)\n[![License](https://img.shields.io/github/license/dave-code-ruiz/elkbledom.svg)](LICENSE)\n[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-donate-yellow.svg)](https://www.buymeacoffee.com/davecoderuiz)\n\n## Support\n\nIf you find this integration useful, consider supporting the development:\n\n\u003ca href=\"https://www.buymeacoffee.com/davecoderuiz\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" height=\"60\"\u003e\n\u003c/a\u003e\n\n**Control your Bluetooth LED strips and bulbs directly from Home Assistant**\n\n[Installation](#installation) • [Supported Devices](#-supported-devices) • [Features](#-features) • [Configuration](#-configuration) • [Troubleshooting](#-troubleshooting)\n\n\u003c/div\u003e\n\n---\n\n## Overview\n\nThis Home Assistant integration allows you to control Bluetooth Low Energy (BLE) LED strips, bulbs, and light bars that use the **ELK-BLEDOM**, **MELK**, **LEDBLE**, and similar protocols. These devices are commonly sold under various brands and controlled via mobile apps like:\n\n-  **duoCo Strip** ([Play Store](https://play.google.com/store/apps/details?id=shy.smartled))\n-  **Lotus Lantern** ([Play Store](https://play.google.com/store/apps/details?id=wl.smartled))\n-  **Lotus Lamp X** ([Play Store](https://play.google.com/store/apps/details?id=com.szelk.ledlamppro))\n-  **Happy Lighting**\n\n---\n\n## Supported Devices\n\nThis integration currently supports the following device models:\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### ELK Family\n- **ELK-BLEDOM**\n- **ELK-BLEDOB** \n- **ELK-BLEDDM**\n- **ELK-BLE**\n- **ELK-BTC**\n- **ELK-BULB** \n- **ELK-BULB2** \n- **ELK-LAMPL** \n- **MELK**\n- **MELK-OA10**\n- **MELK-OC10**\n- **MELK-OF10**\n- **MELK-OG10**\n- **MELK-OA21**\n- **LEDBLE**\n- **LED-**\n- **JACKYLED**\n- **XROCKER**\n- **DMRRBA-007** \n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003e **Note**: These devices use specific Bluetooth UUIDs:\n\u003e - Write UUID: `0000fff3-...` or `0000ffe1-...`\n\u003e - Read UUID: `0000fff4-...` or `0000ffe2-...`\n\n### Where to Buy\n\n-  [Amazon LED Strips](https://www.amazon.es/gp/product/B00VFME0Q2) (Example)\n-  [LED Light Bar](https://www.amazon.es/bedee-Regulable-Inteligente-Bluetooth-Dormitorio/dp/B0BNPMGR1H) (Example)\n-  [MELK Strip](https://www.amazon.es/distancia-Bluetooth-aplicaci%C3%B3n-sincronizaci%C3%B3n-habitaci%C3%B3n/dp/B09VC77GCZ) (Example)\n-  [ELK BTC Strip](https://www.amazon.com/dp/B0F5PMW91X?) (Example)\n- Search for \"ELK-BLEDOM\", \"MELK LED\", or \"Bluetooth LED Strip\" on your local Amazon\n\n---\n\n## Installation\n\n### Method 1: HACS (Recommended)\n\n1. Open **HACS** in your Home Assistant\n2. Go to **Integrations**\n7. Search for **\"elkbledom\"** in HACS\n8. Click **Download**\n9. Restart Home Assistant\n\n### Method 2: Manual Installation\n\n1. Download the latest release from [GitHub](https://github.com/dave-code-ruiz/elkbledom/releases)\n2. Extract and copy the `custom_components/elkbledom` folder to your Home Assistant `config/custom_components/` directory\n3. Restart Home Assistant\n\n---\n\n## Dependencies\n\n### System Requirements\n\nThis integration requires **Bluetooth support** on your Home Assistant installation. The integration uses:\n\n- **Home Assistant Bluetooth integration** (built-in, enabled by default in recent versions)\n- **Python BLE libraries** (automatically installed)\n\n### Optional: Manual Bluetooth Tools\n\nIf you want to manually test or troubleshoot Bluetooth connections, you can install `gattool`:\n\n**Debian/Ubuntu/Raspberry Pi OS:**\n```bash\nsudo apt-get update\nsudo apt-get install bluez bluez-tools\n```\n\n**Fedora:**\n```bash\nsudo dnf install bluez-deprecated\n```\n\n**Arch Linux:**\n```bash\nparu -S bluez-deprecated-tools\n# or\nyay -S bluez-deprecated-tools\n```\n\n### Python Requirements\n\nThe integration automatically installs these dependencies:\n\n```\nbleak\u003e=0.21.0\nbleak-retry-connector\u003e=3.1.0\nhome-assistant-bluetooth\u003e=1.10.0\n```\n\nFor development or manual installation, you can install them with:\n\n```bash\npip install -r requirements.txt\n```\n\n---\n\n## Check Device Compatibility\n\n### Quick Compatibility Check\n\nYour device is likely compatible if:\n- Device name starts with: `ELK-BLE`, `MELK`, `LEDBLE`, or `XROCKER`\n- Controlled by apps: duoCo Strip, Lotus Lantern, Lotus Lamp X, or Happy Lighting\n- Has Bluetooth Low Energy (BLE) connectivity\n\n### Advanced Compatibility Check with gattool\n\nIf you want to verify compatibility manually, use `gattool`:\n\n```bash\ngatttool -I\n```\n\nThen connect to your device (replace `XX:XX:XX:XX:XX:XX` with your device's MAC address):\n\n```bash\n[LE]\u003e connect XX:XX:XX:XX:XX:XX\nAttempting to connect to XX:XX:XX:XX:XX:XX\nConnection successful\n[XX:XX:XX:XX:XX:XX][LE]\u003e primary\nattr handle: 0x0001, end grp handle: 0x0003 uuid: 00001800-0000-1000-8000-00805f9b34fb\nattr handle: 0x0004, end grp handle: 0x0009 uuid: 0000fff0-0000-1000-8000-00805f9b34fb\n\n[XX:XX:XX:XX:XX:XX][LE]\u003e characteristics\nhandle: 0x0002, char properties: 0x12, char value handle: 0x0003, uuid: 00002a00-0000-1000-8000-00805f9b34fb\nhandle: 0x0005, char properties: 0x10, char value handle: 0x0006, uuid: 0000fff4-0000-1000-8000-00805f9b34fb\nhandle: 0x0008, char properties: 0x06, char value handle: 0x0009, uuid: 0000fff3-0000-1000-8000-00805f9b34fb\n```\n\n**Check the UUIDs:**\n\n| UUID Pattern | Compatibility | Repository |\n|--------------|---------------|------------|\n| `0000fff3-...` or `0000ffe1-...` | **Compatible** | This repository |\n| `0000ff01-...` | Use different integration | [lednetwf_ble](https://github.com/raulgbcr/lednetwf_ble) |\n| `0000ffd5-...`, `0000ffd9-...`, etc. | Use different integration | [led_ble](https://www.home-assistant.io/integrations/led_ble/) |\n\n### Using BTScan for Unsupported Devices\n\nIf your device isn't supported yet, you can help add support:\n\n```bash\ngit clone https://github.com/dave-code-ruiz/elkbledom\ncd elkbledom\npip install -r requirements.txt\npython3 BTScan.py\n```\n\nThis will scan for BLE devices and create a JSON file with technical information. Then:\n\n1. [Create a new issue](https://github.com/dave-code-ruiz/elkbledom/issues/new) on GitHub\n2. Attach the generated JSON file\n3. Include device name, brand, and purchase link if available\n\nFor more advanced users, check out our [BLE Sniffing Guide](sniffing_ble_device.md) to help reverse-engineer the protocol.\n\n---\n\n\n## Quick Start Guide\n\n### Step 1: Enable Bluetooth\n\nEnsure Bluetooth is enabled on your Home Assistant device:\n1. Go to **Settings** → **System** → **Hardware**\n2. Verify Bluetooth is detected\n3. If not, check your hardware supports Bluetooth or add a USB Bluetooth adapter\n\n### Step 2: Install Integration\n\nFollow the [Installation](#-installation) instructions above.\n\n### Step 3: Add Your Device\n\n1. Go to **Settings** → **Devices \u0026 Services** → **Integrations**\n2. Click **+ Add Integration**\n3. Search for **\"elkbledom\"**\n4. Select your device from the discovered list\n5. Watch your light toggle to confirm connection\n6. Click **Submit**\n\n### Step 4: Control Your Lights\n\nYour LED device is now available as a `light` entity in Home Assistant!\n\n---\n\n## Troubleshooting\n\n### Common Issues\n\n#### 1. Device Not Discovered\n\n**Problem**: Your LED device doesn't appear in the discovered devices list.\n\n**Solutions**:\n- Ensure the device is powered on and within Bluetooth range (~10 meters)\n- Disconnect the device from any mobile app\n- Restart the Bluetooth service in Home Assistant\n- Check if your device name starts with `ELK-BLE`, `MELK`, `LEDBLE`, or similar\n- Manually scan for BLE devices using `bluetoothctl` or the BTScan.py script\n\n#### 2. Connection Failed / Out of Slots Error\n\n**Problem**: \n```\nBleakOutOfConnectionSlotsError: Failed to connect after 9 attempt(s): \nNo backend with an available connection slot that can reach address\n```\n\n**Solutions**:\n- Only ONE device can connect to the LED strip at a time\n- Close the mobile app completely (force stop on Android)\n- Disconnect from `gatttool` if you used it for testing\n- Wait 30 seconds and try again\n- Power cycle the LED strip\n\n#### 3. MELK Devices - Initialization Required\n\n**Problem**: MELK devices don't respond to commands after setup.\n\n**Solution**: MELK devices require initialization commands. Send these via `gatttool` (replace MAC address):\n\n```bash\nsudo gatttool -b XX:XX:XX:XX:XX:XX --char-write-req -a 0x0009 -n 7e0783\nsudo gatttool -b XX:XX:XX:XX:XX:XX --char-write-req -a 0x0009 -n 7e0404\n```\n\nAfter sending these commands:\n1. Restart the LED strip (power off/on)\n2. Reload the integration in Home Assistant\n3. The device should now work normally\n\nSee [Issue #11](https://github.com/dave-code-ruiz/elkbledom/issues/11) for more details.\n\n#### 4. State Not Updating\n\n**Problem**: Changes made via IR remote or mobile app don't reflect in Home Assistant.\n\n**Explanation**: This is a known limitation. The integration doesn't support live state polling.\n\n**Workaround**: \n- Control the lights exclusively through Home Assistant\n- Use HA automations instead of physical remotes\n\n#### 5. Interference with TV Remote or Other Devices\n\n**Problem**: LED strip changes randomly when using TV remote or other IR devices.\n\n**Explanation**: Some cheap LED controllers respond to generic IR signals.\n\n**Solution**:\n- Block the IR receiver on the LED controller (small piece of tape)\n- Control exclusively via Bluetooth/Home Assistant\n- Replace the controller with a better quality one\n\n#### 6. Slow Response / Disconnects\n\n**Problem**: Lights are slow to respond or frequently disconnect.\n\n**Solutions**:\n- Reduce the disconnect delay in configuration (try 60 seconds)\n- Move the Home Assistant device closer to the LED strip\n- Check for Bluetooth interference (WiFi routers, microwaves, etc.)\n- Use a USB Bluetooth adapter with better range\n- Set disconnect delay to `0` (never disconnect) for instant response\n- **Use ESPHome Bluetooth Proxy**: Deploy [ESPHome Bluetooth proxy](https://esphome.io/components/bluetooth_proxy.html) devices (ESP32) closer to your LED strips for extended range and better reliability\n  - ESP32 devices act as Bluetooth bridges\n  - Significantly improves range and connection stability\n  - Cost-effective solution (~$5-10 per ESP32 device)\n  - Multiple proxies can cover larger areas\n\n---\n\n## Enable Debug Logging\n\nIf you're experiencing issues, enable debug logging to get more detailed information:\n\n**Add to `configuration.yaml`:**\n\n```yaml\nlogger:\n  default: info\n  logs:\n    custom_components.elkbledom: debug\n```\n\n**Restart Home Assistant**, reproduce the issue, then check the logs:\n- Go to **Settings** → **System** → **Logs**\n- Look for entries with `custom_components.elkbledom`\n- Include relevant log entries when [creating an issue](https://github.com/dave-code-ruiz/elkbledom/issues)\n\n---\n\n## Configuration\n\n### Initial Setup\n\n1. Go to **Settings** → **Devices \u0026 Services** → **Integrations**\n2. Click **+ Add Integration**\n3. Search for **\"elkbledom\"**\n4. The integration will automatically discover nearby ELK-BLEDOM devices\n5. Select your device from the list\n6. The setup will validate the connection by toggling the light (make sure it's in range!)\n7. Complete the setup\n\n\u003e **Note**: Repeat the setup process for each light you want to add.\n\n### Configuration Options\n\nAfter setup, you can configure additional options:\n\n#### Available Settings\n\n| Setting | Description | Default | Options |\n|---------|-------------|---------|---------|\n| **Reset color on turn on** | When the LED turns on, reset to white color | `false` | `true` / `false` |\n| **Disconnect delay (seconds)** | Time before disconnecting from the device when idle | `120` | `0` = Never disconnect\u003cbr\u003e`30-300` = Seconds |\n| **Brightness mode** | How brightness is controlled | `auto` | `auto` = Automatic detection\u003cbr\u003e`rgb` = RGB scaling\u003cbr\u003e`native` = Device native |\n| **Model** | Override auto-detected device model | Auto-detected | `ELK-BLEDOB`, `ELK-BLEDOM`, `MELK`, `LEDBLE`, `XROCKER`, etc. |\n| **Effects class** | Change the effects list/behavior | Default | Varies by device model |\n\n#### How to Change Settings\n\n1. Go to **Settings** → **Devices \u0026 Services** → **Integrations**\n2. Find your **elkbledom** device\n3. Click **Configure**\n4. Adjust the settings\n5. Click **Submit**\n\n#### Setting Recommendations\n\n- **Reset color on turn on**: Enable if you want consistent behavior (always starts with white)\n- **Disconnect delay**: \n  - Set to `0` for instant response but higher battery drain on battery-powered hubs\n  - Set to `120-180` seconds for balance between responsiveness and efficiency\n  - Set to `300+` seconds if you rarely control the lights\n- **Brightness mode**:\n  - Use `auto` for most devices (automatically detects the best method)\n  - Use `rgb` if brightness control doesn't work properly\n  - Use `native` for devices with dedicated brightness support\n- **Model**:\n  - Leave as auto-detected unless device is misidentified\n  - Useful if you have a compatible device with a non-standard name\n  - Change only if commands don't work with auto-detected model\n- **Effects class**:\n  - Leave as default for standard device behavior\n  - Change if your device has different effect IDs than expected\n  - Useful for devices with custom firmware or regional variants\n\n---\n\n## Features\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Supported Features\n\n**Automatic Discovery**\n- Automatically finds ELK-BLEDOM devices\n- No need to manually find MAC addresses\n\n**Power Control**\n- Turn lights on/off\n\n**Color Control**\n- Full RGB color support\n- Color temperature (warm/cool white)\n- White mode\n\n**Brightness Control**\n- Adjustable brightness (0-100%)\n- Multiple brightness modes (RGB scaling, native)\n\n**Effects**\n- Built-in light effects\n- Adjustable effect speed\n- Effect selection\n- **EFFECTS** - 22 standard effects (jump, crossfade, blink)\n- **EFFECTS_MELK** - 16 MELK-specific effects\n- **EFFECTS_MELK_Ox** - 13 MELK-Ox series effects\n- **EFFECTS_DMRRBA** - 9 DMRRBA effects (flash, breath, candle)\n- **EFFECTS_STRIPX** - 228 advanced effects (music-reactive, chase, fire, fade, pulse, elevator, rainbow)\n\n**Multiple Devices**\n- Control multiple lights independently\n- Each device configured separately\n\n**Music Reactive** (select models)\n- Microphone-based effects\n- Adjustable sensitivity\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Current Limitations\n\n**Live State Polling**\n- External control (IR remote, mobile app) changes are NOT reflected in Home Assistant\n- State updates only work when controlled through HA\n\n**Segments/Zones** (coming soon)\n- Multi-zone RGB strips not yet supported\n- Single zone control only\n\n**Simultaneous Connections**\n- Only one device (HA or mobile app) can connect at a time\n- Disconnect from mobile app before using HA\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## Usage Examples\n\n### Basic Control\n\n#### Turn On/Off Button\n\n```yaml\ntype: button\nname: Turn On LED Strip\ntap_action:\n  action: toggle\nentity: light.elk_bledom\nshow_icon: true\nshow_name: true\n```\n\n#### Set Specific Color\n\n```yaml\ntype: button\nname: Red\ntap_action:\n  action: call-service\n  service: light.turn_on\n  target:\n    entity_id: light.elk_bledom\n  data:\n    rgb_color: [255, 0, 0]\n    brightness: 255\nshow_icon: true\nshow_name: true\n```\n\n### Advanced Automations\n\n#### Sunrise Simulation\n\n```yaml\nautomation:\n  - alias: \"Wake Up Light\"\n    trigger:\n      - platform: time\n        at: \"07:00:00\"\n    action:\n      - service: light.turn_on\n        target:\n          entity_id: light.elk_bledom\n        data:\n          brightness: 1\n          rgb_color: [255, 147, 41]  # Warm orange\n      - delay: \"00:00:01\"\n      - repeat:\n          count: 30\n          sequence:\n            - service: light.turn_on\n              target:\n                entity_id: light.elk_bledom\n              data:\n                brightness: \u003e\n                  {{ (repeat.index * 8) | int }}\n            - delay: \"00:01:00\"  # Fade over 30 minutes\n```\n\n#### Motion-Activated Night Light\n\n```yaml\nautomation:\n  - alias: \"Bedroom Night Light\"\n    trigger:\n      - platform: state\n        entity_id: binary_sensor.bedroom_motion\n        to: \"on\"\n    condition:\n      - condition: time\n        after: \"22:00:00\"\n        before: \"06:00:00\"\n    action:\n      - service: light.turn_on\n        target:\n          entity_id: light.elk_bledom\n        data:\n          brightness: 10\n          rgb_color: [255, 100, 0]  # Dim warm light\n      - delay: \"00:05:00\"\n      - service: light.turn_off\n        target:\n          entity_id: light.elk_bledom\n```\n\n#### Scene Button Panel\n\n```yaml\ntype: vertical-stack\ncards:\n  - type: horizontal-stack\n    cards:\n      - type: button\n        name: Relax\n        icon: mdi:weather-sunset\n        tap_action:\n          action: call-service\n          service: light.turn_on\n          target:\n            entity_id: light.elk_bledom\n          data:\n            rgb_color: [255, 120, 0]\n            brightness: 150\n      - type: button\n        name: Energize\n        icon: mdi:white-balance-sunny\n        tap_action:\n          action: call-service\n          service: light.turn_on\n          target:\n            entity_id: light.elk_bledom\n          data:\n            rgb_color: [0, 150, 255]\n            brightness: 255\n  - type: horizontal-stack\n    cards:\n      - type: button\n        name: Focus\n        icon: mdi:lightbulb-on\n        tap_action:\n          action: call-service\n          service: light.turn_on\n          target:\n            entity_id: light.elk_bledom\n          data:\n            color_temp: 250  # Cool white\n            brightness: 255\n      - type: button\n        name: Movie\n        icon: mdi:movie-open\n        tap_action:\n          action: call-service\n          service: light.turn_on\n          target:\n            entity_id: light.elk_bledom\n          data:\n            rgb_color: [100, 0, 150]\n            brightness: 50\n```\n\n---\n\n## Contributing\n\nContributions are welcome! Here's how you can help:\n\n### Adding Support for New Devices\n\n1. **Capture BLE traffic** using our [BLE Sniffing Guide](custom_components/elkbledom/sniffing_ble_device.md)\n2. **Analyze the protocol** and identify command structures\n3. **Add model to `models.json`** following existing patterns\n4. **Test thoroughly** with your physical device\n5. **Submit a Pull Request** with your changes\n\n### Reporting Bugs\n\n1. [Create a new issue](https://github.com/dave-code-ruiz/elkbledom/issues/new)\n2. Include:\n   - Device model and brand\n   - Home Assistant version\n   - Debug logs (see [Enable Debug Logging](#-enable-debug-logging))\n   - Steps to reproduce\n\n### Sharing Device Information\n\nHelp expand device support by running BTScan:\n\n```bash\npython3 BTScan.py\n```\n\nShare the generated JSON in a new issue!\n\n---\n\n## Known Issues\n\n| Issue | Status | Workaround |\n|-------|--------|------------|\n| Live state polling not supported | Won't Fix | Control only via HA |\n| Only one connection at a time | Limitation | Disconnect mobile app before using HA |\n| TV remote interference | Won't Fix | Cover IR receiver on controller |\n| MELK requires initialization | In Progress | See troubleshooting section |\n| Segment control not available | Planned | Coming in future update |\n\nFor more details, check the [GitHub Issues](https://github.com/dave-code-ruiz/elkbledom/issues) page.\n\n---\n\n## Credits\n\nThis integration wouldn't be possible without the amazing work from these projects and contributors:\n\n### Core Inspirations\n- [Home Assistant LED BLE Integration](https://www.home-assistant.io/integrations/led_ble/) - Official HA BLE LED integration\n- [ha-triones](https://github.com/sysofwan/ha-triones) - Triones LED controller integration\n- [elkbledom-fastlink](https://github.com/Satimaro/elkbledom-fastlink) - Protocol analysis and device support\n\n### Protocol Analysis\n- [ELK-BLEDOM Controller](https://github.com/TheSylex/ELK-BLEDOM-bluetooth-led-strip-controller/) - TheSylex's controller project\n- [bledom_controller](https://github.com/FreekBes/bledom_controller/) - Python-based controller\n- [ELK-BLEDOM Analysis](https://github.com/FergusInLondon/ELK-BLEDOM/) - Reverse engineering work\n- [BLE RGB LED Strip Controller](https://github.com/arduino12/ble_rgb_led_strip_controller) - Arduino implementation\n- [DynamicLedStrips](https://github.com/lilgallon/DynamicLedStrips) - Dynamic effects implementation\n- [JACKYLED Controller](https://github.com/kquinsland/JACKYLED-BLE-RGB-LED-Strip-controller) - Alternative controller analysis\n\n### Documentation\n- [Linux Things Blog](https://linuxthings.co.uk/blog/control-an-elk-bledom-bluetooth-led-strip) - Control guide and protocol details\n\n### Special Thanks\n\n- All contributors who have submitted device information, bug reports, and pull requests\n- The Home Assistant community for continued support and feedback\n- Everyone who has helped reverse-engineer protocols for new device models\n\n---\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## Support\n\nIf you find this integration useful, consider supporting the development:\n\n\u003ca href=\"https://www.buymeacoffee.com/davecoderuiz\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" height=\"60\"\u003e\n\u003c/a\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made for the Home Assistant Community**\n\n[Report Bug](https://github.com/dave-code-ruiz/elkbledom/issues) • [Request Feature](https://github.com/dave-code-ruiz/elkbledom/issues) • [Contribute](https://github.com/dave-code-ruiz/elkbledom/pulls)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdave-code-ruiz%2Felkbledom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdave-code-ruiz%2Felkbledom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdave-code-ruiz%2Felkbledom/lists"}