Software to control Bluetooth LED Strips like QHM-0A9E
- Dark Mode
- Connect Button and Power Toggle
- Single Colour Control
- Hex Colour Control
- Custom Colour Saves
- Pulsing and Flashing Control
- Frequency Control
- Alert SOS (Sounds from Hitman 3)
- Media Player with LED Sync
- Keyboard Shortcuts
- Settings with Custom Operation Codes
Please read the Wiki.
LightCraft can be installed on Windows using the Installer file provided in the Releases section. You may also choose to run the source code yourself. Run the lightcraft.py file. Please read important notes below. Here are the requirements:
Install via the requirements.txt. I highly recommend you create a virtual environment (like conda).
pip install -r requirements.txt
or simply paste the following in terminal
pip install customtkinter, CTkColorPicker, bleak, pillow, pygame, pynput, mutagen, opencv-python
Clone this Repository by
git clone https://akashcraft/LED-Controller.git
This version will not be developed further. Use it for a light weight option if you just want to send custom commands to your LED Strips. Please read the Wiki for more information.
If you plan to run the project locally, you will need to modify the CTkColorPicker package as the stock package is modified to add functionality to LightCraft. Find the file in the repository and overwrite the stock file.
LightCraft stores its settings and custom operation codes data in the Settings.txt which must be located in the same project folder. If this is not possible, LightCraft will attempt to re-create the files during the pre-GUI checks. Resources folder contains all the GUI elements and this folder must not be deleted. LightCraft will not load the GUI in that case.
Since the application is not signed with an Apple Developer certificate (to avoid the annual $100 Apple Developer Program fee), macOS may block it from opening by default. To proceed, please manually approve the application using one of the following methods:
Option 1 — Remove Quarantine via Command Line
-
Open Terminal.
-
Run the following command:
xattr -d com.apple.quarantine /path/to/LightCraft.app
Option 2 — Use Sentinel If you are using Sentinel (https://github.com/alienator88/Sentinel):
- Open Sentinel.
- Locate the blocked application in the quarantine or security list.
- Approve or allow the application.
- Relaunch the application.
Option 3 — Allow from System Settings
- Attempt to open the application once.
- Open System Settings → Privacy & Security.
- Scroll to the Security section.
- Click Open Anyway next to the blocked application.
After completing one of the above steps, the application should open normally.
You are free to download and edit the source code files however you like. Should you wish to publish this in your project or socials, please provide appropriate credits.
You can add this as your references (or description) if you like:
Source Code: https://github.com/akashcraft/LED-Controller
Website: akashcraft.ca
If you like my work and would like to donate me, I would really appreciate it!
