[](https://github.com/UpDryTwist/coolledx-driver/graphs/commit-activity)
[](https://pypi.python.org/pypi/coolledx-driver/)
[](https://pypi.python.org/pypi/coolledx-driver/)
[](https://pypi.python.org/pypi/coolledx-driver/)
[](http://coolledx-driver.readthedocs.io/?badge=latest)
[](https://github.com/UpDryTwist/coolledx-driver/issues?q=archived:false+is:issue+is:open+sort:updated-desc+label%3A%22help%20wanted%22%2C%22good%20first%20issue%22)
[](https://lbesson.mit-license.org/)
[](https://www.buymeacoffee.com/updrytwist)
# CoolLEDX Driver
This package implements a Python driver for the CoolLEDX LED strips (i.e., those strips
that are controlled by the CoolLED1248 app). The strips receive commands via Bluetooth,
and can generally be programmed to display text (which is actually just a rendered image
of the text), images, or animations. You can get these strips pretty cheaply on AliExpress
-- just be sure that you see a picture of the CoolLED1248 app on the product page, as this
driver won't work with any other sort of strip. That said, they're pretty ubiquitous, at
least at the time of this writing (December 2023).
## Usage
You need to have a functioning Bluetooth device. This package uses [Bleak](https://github.com/hbldh/bleak)
for all its Bluetooth interactions, so you should be able to use any system supported
by Bleak . . . but it hasn't been tested on anything other than Windows 11 (and soon
Ubuntu on a Pi).
## Roadmap
* [ ] Write some bare-bones documentation, at least
* [ ] Ensure this is tested out on a Raspberry Pi (my end target device)
* [ ] Add a simple REST listener app to allow driving this remotely
## Credits and Sources
#### Main Kudos
This project could not possibly exist without the work done by [CrimsonClyde](https://git.team23.org/CrimsonClyde)
in reverse engineering the CoolLEDX protocol at [LED FaceShields](https://git.team23.org/CrimsonClyde/led-faceshields). Much
of the code in this project is directly derived from that code, and almost all of the
insights were from that work. That repository has a bunch of useful information about
the underlying protocol.
#### The Source?
I believe that these LEDs are made by [Juntong Technology](http://www.jotus-tech.com/en/). I think that
the app itself is made by some 3rd party. I sent an email to the contact at Juntong, but
never got a reply, so not sure. If anyone has a contact, I'd love to get connected, as I
really like their strips!
For source code related to the app, which was helpful in some questions I had about
the protocol (but, honestly, not too much there, and a headache to read), you could try:
* [iOS App (Crosby) Source](https://gitee.com/juntong-iOS/CROSBY_Combine/blob/master/CROSBY_Combine/Classess/Tools/BluetoothManager.m)
* [Some other source that seems to poke the device](https://gitee.com/ifdef/WxBLETools/blob/master/utils/ble.js)
#### Sniffing the CoolLED1248 App
For some of my protocol analysis, I found it useful to do the following:
* Turn on BLE logging on my Android phone (under developer options) to save a log capture.
Be sure to turn it on right before you start the capture, then turn it off immediately,
so that you're not collecting a ton of junk information.
* Run the CoolLED1248 app and send commands to the LED strip
* Pull the log file from the phone to my PC using the ADB interface
* Analyze it with Wireshark (just put a filter on the MAC address of the LED strip)
This helped me get over some spots where I was a bit lost in the handshakes, or making
some bad assumptions about what was or was not working.
Raw data
{
"_id": null,
"home_page": "https://github.com/UpDryTwist/coolledx-driver",
"name": "coolledx",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.11,<3.13",
"maintainer_email": "",
"keywords": "coolled,coolledx,led,sign,coolled1248",
"author": "UpDryTwist",
"author_email": "tathamg@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/90/6a/3d15bbdb5f9b2cdbbff4957abd7b15b93f8a62c25295b8a5b8cb9a304242/coolledx-0.1.0.tar.gz",
"platform": null,
"description": "\n[](https://github.com/UpDryTwist/coolledx-driver/graphs/commit-activity)\n[](https://pypi.python.org/pypi/coolledx-driver/)\n[](https://pypi.python.org/pypi/coolledx-driver/)\n[](https://pypi.python.org/pypi/coolledx-driver/)\n[](http://coolledx-driver.readthedocs.io/?badge=latest)\n[](https://github.com/UpDryTwist/coolledx-driver/issues?q=archived:false+is:issue+is:open+sort:updated-desc+label%3A%22help%20wanted%22%2C%22good%20first%20issue%22)\n[](https://lbesson.mit-license.org/)\n[](https://www.buymeacoffee.com/updrytwist)\n\n# CoolLEDX Driver\n\nThis package implements a Python driver for the CoolLEDX LED strips (i.e., those strips\nthat are controlled by the CoolLED1248 app). The strips receive commands via Bluetooth,\nand can generally be programmed to display text (which is actually just a rendered image\nof the text), images, or animations. You can get these strips pretty cheaply on AliExpress\n-- just be sure that you see a picture of the CoolLED1248 app on the product page, as this\ndriver won't work with any other sort of strip. That said, they're pretty ubiquitous, at\nleast at the time of this writing (December 2023).\n\n## Usage\n\nYou need to have a functioning Bluetooth device. This package uses [Bleak](https://github.com/hbldh/bleak)\nfor all its Bluetooth interactions, so you should be able to use any system supported\nby Bleak . . . but it hasn't been tested on anything other than Windows 11 (and soon\nUbuntu on a Pi).\n\n## Roadmap\n\n* [ ] Write some bare-bones documentation, at least\n* [ ] Ensure this is tested out on a Raspberry Pi (my end target device)\n* [ ] Add a simple REST listener app to allow driving this remotely\n\n\n## Credits and Sources\n\n#### Main Kudos\n\nThis project could not possibly exist without the work done by [CrimsonClyde](https://git.team23.org/CrimsonClyde)\nin reverse engineering the CoolLEDX protocol at [LED FaceShields](https://git.team23.org/CrimsonClyde/led-faceshields). Much\nof the code in this project is directly derived from that code, and almost all of the\ninsights were from that work. That repository has a bunch of useful information about\nthe underlying protocol.\n\n#### The Source?\n\nI believe that these LEDs are made by [Juntong Technology](http://www.jotus-tech.com/en/). I think that\nthe app itself is made by some 3rd party. I sent an email to the contact at Juntong, but\nnever got a reply, so not sure. If anyone has a contact, I'd love to get connected, as I\nreally like their strips!\n\nFor source code related to the app, which was helpful in some questions I had about\nthe protocol (but, honestly, not too much there, and a headache to read), you could try:\n\n* [iOS App (Crosby) Source](https://gitee.com/juntong-iOS/CROSBY_Combine/blob/master/CROSBY_Combine/Classess/Tools/BluetoothManager.m)\n* [Some other source that seems to poke the device](https://gitee.com/ifdef/WxBLETools/blob/master/utils/ble.js)\n\n#### Sniffing the CoolLED1248 App\n\nFor some of my protocol analysis, I found it useful to do the following:\n* Turn on BLE logging on my Android phone (under developer options) to save a log capture.\n Be sure to turn it on right before you start the capture, then turn it off immediately,\n so that you're not collecting a ton of junk information.\n* Run the CoolLED1248 app and send commands to the LED strip\n* Pull the log file from the phone to my PC using the ADB interface\n* Analyze it with Wireshark (just put a filter on the MAC address of the LED strip)\n\nThis helped me get over some spots where I was a bit lost in the handshakes, or making\nsome bad assumptions about what was or was not working.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Driver for the CoolLEDX LED signs (signs managed by CoolLED1248 app)",
"version": "0.1.0",
"project_urls": {
"Documentation": "https://coolledx-driver.readthedocs.io/en/latest/",
"Homepage": "https://github.com/UpDryTwist/coolledx-driver",
"Repository": "https://github.com/UpDryTwist/coolledx-driver"
},
"split_keywords": [
"coolled",
"coolledx",
"led",
"sign",
"coolled1248"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "33b5a13c357d48036f94b65e5f5c8da93284ef90e3c0e42066773341ac7dbe2b",
"md5": "dd6e152f1f4e2af70a4838fe4813d05e",
"sha256": "a0591aaae7bb84d41725e0f68c03869247a5564b663b4f2a19b01cac57aa970d"
},
"downloads": -1,
"filename": "coolledx-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "dd6e152f1f4e2af70a4838fe4813d05e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11,<3.13",
"size": 15852,
"upload_time": "2023-12-24T13:28:00",
"upload_time_iso_8601": "2023-12-24T13:28:00.196289Z",
"url": "https://files.pythonhosted.org/packages/33/b5/a13c357d48036f94b65e5f5c8da93284ef90e3c0e42066773341ac7dbe2b/coolledx-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "906a3d15bbdb5f9b2cdbbff4957abd7b15b93f8a62c25295b8a5b8cb9a304242",
"md5": "f09e744158fdbad10652b4e44b41ce62",
"sha256": "4180d3f50af252bf86eef80d65bd551f9fb109781526e101ca2ffb27d4ce73b4"
},
"downloads": -1,
"filename": "coolledx-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "f09e744158fdbad10652b4e44b41ce62",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11,<3.13",
"size": 14511,
"upload_time": "2023-12-24T13:28:02",
"upload_time_iso_8601": "2023-12-24T13:28:02.416920Z",
"url": "https://files.pythonhosted.org/packages/90/6a/3d15bbdb5f9b2cdbbff4957abd7b15b93f8a62c25295b8a5b8cb9a304242/coolledx-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-24 13:28:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "UpDryTwist",
"github_project": "coolledx-driver",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "coolledx"
}
JSON
