Awesome Open Source
Awesome Open Source

doctormord's Responsive Led Control

I mixed the work of McLighting, Russell and Jake's "Grisworld" with FastLED (FastLED library 3.1.3 as of this writing), the colorjs colorpicker, color spectrums created via FastLED Palette Knife, and some additional strip animations (included in the Arduino Sketch above).

FastLED 3.1.3 library:

McLighting library:

Russel's implementation:

Jakes's "Grisworld" Led Controller

jscolor Color Picker:

FastLED Palette Knife:


If you aren't familiar with how to setup your ESP8266, see the readme on McLighting's git. It's well written and should get you up and running.

In short you will:

  1. Configure the Arduino IDE to communicate with the ESP8266
  2. Upload the sketch (from this repo) The sketch is setup for a 120 pixel WS2812B GRB LED Strip.
    (change the applicable options in "definitions.h" to your desire)
  3. Patch FastLED Library
// Note, you need to patch FastLEDs in order to use this.  You'll get an
// error related to <avr\pgmspace.h>. Saves more than 3k given the palettes
// Simply edit <fastled_progmem.h> and update the include (Line ~29):

#if (defined(__AVR__))
#include <avr\pgmspace.h>
#include <pgmspace.h>
  1. On first launch, the ESP8266 will advertise it's own WiFi network for you to connect to, once you connect to it, launch your browser and the web interface is self explanatory. (If the interface doesn't load, type in "" into your browser and hit go)
  2. Once the ESP is on your wifi network, you can then upload the required files for the web interface by typing the in IP address of the ESP followed by "/edit" (i.e. Then upload the files from the folder labeled "upload these" from this repo. (Or use ESP8266 filesystem uploader, see below)
  3. Once you have finished uploading, type in the IP of the ESP into your browser and you should be up and running!

Forked from Russel, i removed Adafruit Neopixel references and library calls.

Uploading SPIFFS data all at once

Use ESP8266FS plugin to upload all files from /data to SPIFFS.

Arduino ESP8266 filesystem uploader

Improvements/changes so far:

  • new effect: Fire (from WS2812FX)

  • new effect: RainbowFire

  • new effect: Fireworks [single color, rainbow, random] (from McLightning, ported to used FastLED instead off Adafruit Neopixel)

  • new settings for effects in webinterface *.htm

  • speedup the UI alot by pulling the materialize stuff (.css/.js) from server and using .gz compressed files for the rest

  • made the UI more responsive with grouped sections and buttons

  • added some more palettes

  • integrated Arduino OTA

  • included setup of LED-count and maximum allowed LED-current to web-interface and EEprom, so different strings don't need changs in source-code

Large Screen (Desktop)

Large Screen

Small Screen (Mobile)

Small Screen

I edited clockless_esp8266.h (in the FastLED platforms folder) and kept getting flickering until I incremented the WAIT_TIME up to 18us. (also I did "#define FASTLED_INTERRUPT_RETRY_COUNT 3" inside my sketch).

For reference, interrupts issue:


As per the original McLighting and Jake's "Grisworld" project, this project is released under the GNU LESSER GENERAL PUBLIC LICENSE Version 3, 29 June 2007.

Griswold is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as 
published by the Free Software Foundation, either version 3 of 
the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with this program.  If not, see <>.

Portions of @jake-b "Griswold" LED controller original README

I bought 1000 WS2811 nodes for my outdoor Christmas light installation this year. Based on the "Russell's FASTLEDs" project by @russp81, which is in turn based on the "McLighting" project by @toblum

It seemed necessary to name the thing after Clark Griswold, but really just to differentiate this fork from the originals.

@russp81 mixed the work of @toblum with the @FastLED (FastLED library 3.1.3 as of this writing), the colorjs colorpicker, color spectrums created via FastLED Palette Knife, and some additional strip animations.


  • Palettes stored as binary files on SPIFFS. See below for more information on this.
  • Display name of the current palette file in the web interface.
  • Added ArduinoOTA support so I can update the firmware over WiFi, which will be important when its installed outside.
  • Added the ability to store the settings in EEPROM and restore on boot.
  • Merged the jscolor interface into the original McLighting interface
  • Updated the McLighting interface to retrieve the current settings from the device, and update the UI with the current settings, rather than always default to the defaults.
  • General code formatting clean-up.
  • Added “RemoteDebug” library for serial console over telnet. (Optional #define)
  • Fixed divide-by-zero error that occurs when fps=0 by preventing fps=0 from the UI.
  • Updates to the “animated palette” function, now you can select a single palette, or the existing randomized palette after time delay.
  • Rearchitected things a bit, now the colormodes.h functions render one single frame, and do not block the main thread.
  • Added back the wipe and tv animations from the original McLighting project (removed in LEDLAMP_FASTLEDs)
  • Modified TV animation to add some flicker (I like it better)
  • Added “effect brightness” setting to allow you to dim the main effect independently of glitter.

Palettes on SPIFFS

Normally, you use PaletteKnife to generate arrays with the palette info. You then compile this data into your project. I wanted to be able to update the palettes without recompiling, so I moved them to files in SPIFFS (/palettes directory). There is a little python program that basically takes the logic from PaletteKnife and outputs a binary file with the palette data instead. Load these binary files to SPIFFS using the Arduino ESP8266 filesystem uploader or manually.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
c (14,552
esp8266 (256
responsive-design (56
esp8266-arduino (42
materializecss (15
ws2812b (15

Find Open Source By Browsing 7,000 Topics Across 59 Categories