{"id":44154207,"url":"https://github.com/8none1/bj_led","last_synced_at":"2026-02-09T04:47:17.927Z","repository":{"id":211323548,"uuid":"721636923","full_name":"8none1/bj_led","owner":"8none1","description":"Home Assistant custom integration for BJ_LED devices","archived":false,"fork":false,"pushed_at":"2024-03-23T10:42:25.000Z","size":182,"stargazers_count":33,"open_issues_count":0,"forks_count":18,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-10-10T10:25:07.972Z","etag":null,"topics":["bj-led","ble","bluetooth","home-assistant","home-automation","led-strips"],"latest_commit_sha":null,"homepage":"https://www.whizzy.org","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/8none1.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}},"created_at":"2023-11-21T13:20:06.000Z","updated_at":"2025-09-01T23:29:09.000Z","dependencies_parsed_at":"2023-12-11T20:25:32.164Z","dependency_job_id":"51da6db7-8dd0-41cf-9382-a52d959f2ec4","html_url":"https://github.com/8none1/bj_led","commit_stats":null,"previous_names":["8none1/bj_led"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/8none1/bj_led","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8none1%2Fbj_led","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8none1%2Fbj_led/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8none1%2Fbj_led/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8none1%2Fbj_led/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/8none1","download_url":"https://codeload.github.com/8none1/bj_led/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8none1%2Fbj_led/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29256799,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T04:11:57.159Z","status":"ssl_error","status_checked_at":"2026-02-09T04:11:56.117Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["bj-led","ble","bluetooth","home-assistant","home-automation","led-strips"],"created_at":"2026-02-09T04:47:17.314Z","updated_at":"2026-02-09T04:47:17.923Z","avatar_url":"https://github.com/8none1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BJ_LED\n\nHome Assistant custom integration for BJ_LED devices controlled by the MohuanLED app over Bluetooth LE.\n\nThese were the cheapest Bluetooth controlled LEDs I could find on AliExpress.  5M of 5050 LEDs for £2.67.  The app is basic, but it works.  The IR remote is basic, but it works.  The lights connect to a USB port.\n\n![image](https://github.com/8none1/bj_led/assets/6552931/686eff8b-ab87-4327-b784-ed91d695f957)\n\n![image](https://github.com/8none1/bj_led/assets/6552931/74e43dbb-92ab-4d58-bf10-55d789e259d4)\n\nI figured it should be pretty easy to get them working, and it was.  I have no intention of adding this to HACS in any official capacity, but it should work when you add this repo as a custom repo in HACS.\n\nThere are some btsnoop HCI logs in the `bt_snoops` folder if you want to examine them.\n\n## Bluetooth LE commands\n\n`69 96 06 01 01`                 - On\n`69 96 02 01 00`                 - Off\n\n### Colours\n\n```\n|---------| -------------------- header\n|         | ||------------------ red\n|         | || ||--------------- green\n|         | || || ||------------ blue\n|         | || || || ||--------- white\n69 96 05 02 7f 00 00 7f        - red\n69 96 05 02 00 7f 00 7f        - green\n69 96 05 02 00 00 7f 7f        - blue\n69 96 05 02 ff ff ff ff        - white\n```\n\nIn fact, you only need to provide RGB and can skip the last byte.  Since these strips don't have an white LED, it's easier to make sense of the shorter packet.\n\n### Mode\n\n```\n|-----|------------------------- header\n|     |     |------------------- mode\n|     |     |  ||--------------- speed\n69 96 03 03 02 01\n69 96 03 03 01 01\n```\n\nMode are numbered `00` to `15`.\n\nSpeed is 01 fast to 0a slow.  There are values accepted above this, but strange things happen.\n\n## Supported devices\n\nThis has only been tested with a single generic LED strip from Ali Express.\n\nIt reports itself as `BJ_LED` over Bluetooth LE.  The app is called `MohuanLED`.\nMAC address seem to start `FF:FF:xx:xx:xx:xx`.\n\n## Supported Features in this integration\n\n- On/Off\n- RGB colour\n- Brightness (see known issues)\n- Fancy colour Modes (not speed)\n- Automatic discovery of supported devices\n\n## Not supported and not planned\n\n- Microphone interactivity\n- Timer / Clock functions\n- Discovery of current light state\n\nThe timer/clock functions are understandable from the HCI Bluetooth logs but adding that functionality seems pointless and I don't think Home Assistant would support it any way.\n\nThe discovery of the light's state requires that the device be able to tell us what state it is in.  The BT controller on the device does report that it has `notify` capabilities but I have not been able to get it to report anything at all.  Perhaps you will have more luck.  Until this is solved, we have to use these lights in `optimistic` mode and assume everything just worked.  Looking at HCI logs from the Android app it doesn't even try to enable notifications and never receives a packet from the light.\n\n## Known Issues\n\n- Brightness handling is very basic.  Brightness is handled by scaling the colour values.  Changing the brightness while an effect is showing will stop the effect.  This should be easy enough to fix, just I haven't done it yet.\n\n## Installation\n\n### Requirements\n\nYou need to have the bluetooth component configured and working in Home Assistant in order to use this integration.\n\n### HACS\n\nAdd this repo to HACS as a custom repo.  Click through:\n\n- HACS -\u003e Integrations -\u003e Top right menu -\u003e Custom Repositories\n- Paste the Github URL to this repo in to the Repository box\n- Choose category `Integration`\n- Click Add\n- Restart Home Assistant\n- BJ_LED devices should start to appear in your Integrations page\n\n## Credits\n\nThis integration was possible thanks to the work done by raulgbcr in this repo:\n\n\u003chttps://github.com/raulgbcr/lednetwf_ble\u003e\n\nwhich in turn is thanks to:\n\n\u003chttps://github.com/dave-code-ruiz/elkbledom\u003e for most of the base code adapted to this integration.\n\n## Other projects that might be of interest\n\n- [iDotMatrix](https://github.com/8none1/idotmatrix)\n- [Zengge LEDnet WF](https://github.com/8none1/zengge_lednetwf)\n- [iDealLED](https://github.com/8none1/idealLED)\n- [BJ_LED](https://github.com/8none1/bj_led)\n- [ELK BLEDOB](https://github.com/8none1/elk-bledob)\n- [HiLighting LED](https://github.com/8none1/hilighting_homeassistant)\n- [BLELED LED Lamp](https://github.com/8none1/ledble-ledlamp)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F8none1%2Fbj_led","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F8none1%2Fbj_led","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F8none1%2Fbj_led/lists"}