Skip to content
A simple javascript library that provides simple API to control Luxafor devices
Branch: master
Clone or download
Pull request Compare This branch is 3 commits behind iamthefox:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


A simple library to control your Luxafor device via node.js

About Luxafor

Luxafor is an LED indicator that connects to your computer through a USB port or via Bluetooth, and shows your availability or notifies you about important information, like incoming emails or calendar reminders.

Its Hardware Api is open, allowing developers to control the device through their own applications.

You can go to to get more information about it.


npm install luxafor-api --save


const Luxafor = require('luxafor-api');

// api call to change the color
let opts = {
    defaults: {
        wave: {
            type: 2,
            speed: 90,
            repeat: 5
device = new Luxafor(options);

Target LEDs

Led Code
all 0xFF
top row 0x41
bottom row 0x42
led #1-6 0x01 - 0x06


setColor(color, target)

Set target led's color. When target is not provided it assumes we want to change color for all leds.

fadeTo(color, target, speed = 20)

Similar to setColor, the only difference it will transition smoothly from previous color to the one specified.

speed is a number 0-255 that represents the speed of the transition, 0 is the quickest 255 is the slowest.

flash(color, target, speed = 180, repeat = 5)

Flash color for an amount of times specified in repeat parameter.

speed 0 to 255 number determines delay between each blink

repeat 0 to 255 number amount of times to blink before returning to previous state

wave(color, type = 2, speed = 90, repeat = 5)

Starts a wave that goes through all the leds with the pattern specified in type variable

There are 4 types available:

  • 1 - short wave
  • 2 - long wave
  • 3 - overlapping short wave
  • 4 - overlapping long wave


Turns off all leds


returns the object with all available targets


returns available wave types

Note: each one of those methods will return (bool) true when command was successfully executed or new Error object when it fails.

You can’t perform that action at this time.