This is a simple CLI application you can use to control your Bluetooth Low Energy (BLE) lamp.
The project offers the following functionality:
lampify was tested with the lamp Victoria Lighting Losange/PL500, hovewer a lot of chinese lamps have common control algorithm, so lampify should be compatible with all BLE lamps that can be controlled via Android applications from the list below (the list may be incomplete).
Developed by XuRenNan
Developed by ShangHai All Link Microelectronics Co., Ltd
This is the list of packages providing the files required to compile lampify. Be aware that package names usually do vary across different linux distributions.
Arch Linux
Debian / Ubuntu
The compilation process is pretty simple:
git clone https://github.com/MasterDevX/lampify.git
cd lampify
make
To install (places executable in /usr/local/bin and sets up permissions):
sudo make install
To uninstall (removes executable from /usr/local/bin):
sudo make uninstall
The syntax of provided CLI interface can be retrieved by running lampify without arguments:
[ user@archlinux ~ ] $ lampify
Lampify 1.0.0 by MasterDevX
Made in Ukraine
Usage:
lampify <mode> <action> [parameter]
Available modes:
q quiet (without notifications)
v verbose (with notifications)
Available actions:
setup connect to the lamp
on turn the lamp on
off turn the lamp off
cold <0..9> set cold brightness
warm <0..9> set warm brightness
dual <0..9> set dual brightness
Before you can control your lamp, you have to perform an initial setup so the lamp will remember the unique ID of your device generated by lampify. The ID is being generated based on your machine's hostname.
To perform the initial setup:
Within a few seconds after powering the lamp on, send a setup signal from your device:
lampify q setup
Turn the lamp on (without notification):
lampify q on
Turn the lamp off (with notification):
lampify v off
Set warm temperature and brightness to 5 (without notification):
lampify q warm 5
Set cold temperature and brightness to 2 (with notification):
lampify v cold 2