The FastLED library for colored LED animation on Arduino. Please direct questions/requests for help to the FastLED Reddit community: We'd like to use github "issues" just for tracking library bugs / enhancements.
Alternatives To Fastled
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
4 days ago420mitC++
The FastLED library for colored LED animation on Arduino. Please direct questions/requests for help to the FastLED Reddit community: We'd like to use github "issues" just for tracking library bugs / enhancements.
Cylon3,685339865 years ago47April 22, 201644otherJavaScript
JavaScript framework for robotics, drones, and the Internet of Things (IoT)
3 months ago83lgpl-3.0C++
Arduino library for controlling single-wire LED pixels (NeoPixel, WS2812, etc.)
Blinker Library2,473
2 months ago6mitC++
An IoT Solution,Blinker library for embedded hardware. Works with Arduino, ESP8266, ESP32.
Audio Reactive Led Strip2,449
9 months ago104mitPython
:musical_note: :rainbow: Real-time LED strip music visualization using Python and the ESP8266 or Raspberry Pi
4 months ago4mitC++
WS2812 FX Library for Arduino and ESP8266
a year ago96otherC++
A RESTful environment for Arduino
21 hours ago22gpl-3.0G-code
NightDriver client for ESP32
Duino9516545 years ago10April 21, 201435JavaScript
:bulb: Arduino framework for node.js
2 years ago10gpl-3.0C
Light weight library to control WS2811/WS2812 based LEDS and LED Strings for 8-Bit AVR microcontrollers.
Alternatives To Fastled
Select To Compare

Alternative Project Comparisons


arduino-library-badge build status Documentation Reddit

This is a library for easily & efficiently controlling a wide variety of LED chipsets, like the ones sold by Adafruit (NeoPixel, DotStar, LPD8806), Sparkfun (WS2801), and AliExpress. In addition to writing to the LEDs, this library also includes a number of functions for high-performing 8-bit math for manipulating your RGB values, as well as low level classes for abstracting out access to pins and SPI hardware, while still keeping things as fast as possible.

We have multiple goals with this library:

  • Quick start for new developers - hook up your LEDs and go, no need to think about specifics of the LED chipsets being used
  • Zero pain switching LED chipsets - you get some new LEDs that the library supports, just change the definition of LEDs you're using, et. voila! Your code is running with the new LEDs.
  • High performance - with features like zero cost global brightness scaling, high performance 8-bit math for RGB manipulation, and some of the fastest bit-bang'd SPI support around, FastLED wants to keep as many CPU cycles available for your LED patterns as possible

Getting Started

Install the library using either the .zip file from the latest release or by searching for "FastLED" in the libraries manager of the Arduino IDE. See the Arduino documentation on how to install libraries for more information.

How quickly can you get up and running with the library? Here's a simple blink program:

#include <FastLED.h>
#define NUM_LEDS 60
void setup() { FastLED.addLeds<NEOPIXEL, 6>(leds, NUM_LEDS); }
void loop() {
	leds[0] = CRGB::White;; delay(30);
	leds[0] = CRGB::Black;; delay(30);

Help and Support

If you need help with using the library, please consider visiting the Reddit community at There are thousands of knowledgeable FastLED users in that group and a plethora of solutions in the post history.

If you are looking for documentation on how something in the library works, please see the Doxygen documentation online at

If you run into bugs with the library, or if you'd like to request support for a particular platform or LED chipset, please submit an issue at

Supported LED Chipsets

Here's a list of all the LED chipsets are supported. More details on the LED chipsets are included on our wiki page

  • Adafruit's DotStars - aka APA102
  • Adafruit's Neopixel - aka WS2812B (also WS2811/WS2812/WS2813, also supported in lo-speed mode) - a 3 wire addressable LED chipset
  • TM1809/4 - 3 wire chipset, cheaply available on
  • TM1803 - 3 wire chipset, sold by RadioShack
  • UCS1903 - another 3 wire LED chipset, cheap
  • GW6205 - another 3 wire LED chipset
  • LPD8806 - SPI based chipset, very high speed
  • WS2801 - SPI based chipset, cheap and widely available
  • SM16716 - SPI based chipset
  • APA102 - SPI based chipset
  • P9813 - aka Cool Neon's Total Control Lighting
  • DMX - send rgb data out over DMX using Arduino DMX libraries
  • SmartMatrix panels - needs the SmartMatrix library (pixelmatix/SmartMatrix)
  • LPD6803 - SPI based chpiset, chip CMODE pin must be set to 1 (inside oscillator mode)

HL1606, and "595"-style shift registers are no longer supported by the library. The older Version 1 of the library ("FastSPI_LED") has support for these, but is missing many of the advanced features of current versions and is no longer being maintained.

Supported Platforms

Right now the library is supported on a variety of Arduino compatible platforms. If it's ARM or AVR and uses the Arduino software (or a modified version of it to build) then it is likely supported. Note that we have a long list of upcoming platforms to support, so if you don't see what you're looking for here, ask, it may be on the roadmap (or may already be supported). N.B. at the moment we are only supporting the stock compilers that ship with the Arduino software. Support for upgraded compilers, as well as using AVR Studio and skipping the Arduino entirely, should be coming in a near future release.

  • Arduino & compatibles - straight up Arduino devices, Uno, Duo, Leonardo, Mega, Nano, etc...
  • Arduino Yún
  • Adafruit Trinket & Gemma - Trinket Pro may be supported, but haven't tested to confirm yet
  • Teensy 2, Teensy++ 2, Teensy 3.0, Teensy 3.1/3.2, Teensy LC, Teensy 3.5, Teensy 3.6, and Teensy 4.0 - Arduino compatible from with some extra goodies (note the Teensy LC, 3.2, 3.5, 3.6, 4.0 are ARM, not AVR!)
  • Arduino Due and the digistump DigiX
  • RFDuino
  • SparkCore
  • Arduino Zero
  • ESP8266 using the Arduino board definitions from - please be sure to also read for information specific to the 8266.
  • The wino board -
  • ESP32 based boards

What types of platforms are we thinking about supporting in the future? Here's a short list: ChipKit32, Maple, Beagleboard

What about that name?

Wait, what happened to FastSPI_LED and FastSPI_LED2? The library was initially named FastSPI_LED because it was focused on very fast and efficient SPI access. However, since then, the library has expanded to support a number of LED chipsets that don't use SPI, as well as a number of math and utility functions for LED processing across the board. We decided that the name FastLED more accurately represents the totality of what the library provides, everything fast, for LEDs.

For more information

Check out the official site for links to documentation, issues, and news

TODO - get candy

Popular Arduino Projects
Popular Led Projects
Popular Hardware Categories

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
C Plus Plus