# Illuminated Butterfly Wall Art

## Overview

![](https://cdn-learn.adafruit.com/assets/assets/000/135/344/medium800thumb/leds_butterfly_gif_large.jpg?1739818922)

Make animated wall art, powered by pebble-style LEDs, and controlled by a Mini Sparkle Motion. The body is made out of corrugated plastic which is easy to work with by hand. This will be mounted behind an artist's canvas, providing excellent LED diffusion and a subtle texture.

## Parts
### Mini Sparkle Motion - WLED-friendly ESP32 NeoPixel LED Driver

[Mini Sparkle Motion - WLED-friendly ESP32 NeoPixel LED Driver](https://www.adafruit.com/product/6160)
The **Adafruit Sparkle Motion Mini** &nbsp;is part of our&nbsp;series of "Sparkle Motion" boards, that are our attempt to make the&nbsp;best small&nbsp;WLED-friendly smart LED driving board in the whole world. Our resident mermaid, <a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/6160)
[Related Guides to the Product](https://learn.adafruit.com/products/6160/guides)
![Angled Shot of the Mini Sparkle Motion ESP32Mini.](https://cdn-shop.adafruit.com/640x480/6160-00.jpg)

### Adafruit NeoPixel Pebble / Seed LED Strand - 200 LEDs - 2" Pitch

[Adafruit NeoPixel Pebble / Seed LED Strand - 200 LEDs - 2" Pitch](https://www.adafruit.com/product/6024)
We have all&nbsp;sorts of LED strips for a wide range of needs.&nbsp;[_Chonky_](https://www.adafruit.com/product/3869)&nbsp;strips? We got those!&nbsp;[Strips with alligator...](https://www.adafruit.com/?q=neopixel%20alligator%20clips%20stripping%20wires)

In Stock
[Buy Now](https://www.adafruit.com/product/6024)
[Related Guides to the Product](https://learn.adafruit.com/products/6024/guides)
![Demo Shot of the LED RGB Pebble Pixel, Addressable string light/DC5V, 200 LED/pcs.](https://cdn-shop.adafruit.com/640x480/6024-03.jpg)

The power supply below provides an all-in-one solution.&nbsp;

### Wall Power Supply with USB C - 5V 3A Output and Switch

[Wall Power Supply with USB C - 5V 3A Output and Switch](https://www.adafruit.com/product/5802)
We love the Raspberry Pi 4 and 5, with their fancy new USB Type C power connectors. Now we have an even&nbsp;_better_&nbsp;power supply that can be used with either Pi 4 or even a Pi 5 with 5V output, 3A of current to handle builds with accessories and displays. This flat square body...

Out of Stock
[Buy Now](https://www.adafruit.com/product/5802)
[Related Guides to the Product](https://learn.adafruit.com/products/5802/guides)
![5V 3A Switching Power Supply with USB C - RA](https://cdn-shop.adafruit.com/640x480/5802-02.jpg)

-OR-

You can also use an old mobile phone power supply to the wall and an appropriate cable. If the wall power is USB A, the following cable may work well (be careful of length depending on where you mount your art).

### Pink and Purple Woven USB A to USB C Cable - 2 meters long

[Pink and Purple Woven USB A to USB C Cable - 2 meters long](https://www.adafruit.com/product/5044)
This cable is not only super-fashionable, with a woven pink and purple Blinka-like pattern, it's also made for USB C for our modernized breakout boards, Feathers and more.&nbsp; [If you want something just like it but for Micro B, we have a B...](https://www.adafruit.com/product/4111)

Out of Stock
[Buy Now](https://www.adafruit.com/product/5044)
[Related Guides to the Product](https://learn.adafruit.com/products/5044/guides)
![Angled shot of a pink/purple woven USB cable plugged into a laptop port and a small dev board.](https://cdn-shop.adafruit.com/640x480/5044-04.jpg)

Additionally, you'll need a stretched artists canvas, some corrugated plastic (for example Coroplast), duct tape, four small screws, and a USB C power supply. Some optional black cardstock will help make your art more defined if you have white corrugated plastic.

Optional

### 2.54mm/0.1" Pitch Terminal Block - 4-pin

[2.54mm/0.1" Pitch Terminal Block - 4-pin](https://www.adafruit.com/product/2137)
After a long day out harvesting in the terminal block fields, we've returned with a veritable bounty of these very nice and compact 2.54mm/0.1" terminal blocks in a variety of sizes.

Our harvest of terminal blocks is great news&nbsp;since nothing makes a project harder to...

In Stock
[Buy Now](https://www.adafruit.com/product/2137)
[Related Guides to the Product](https://learn.adafruit.com/products/2137/guides)
![Angled shot of black 4-pin 2.54mm terminal block.](https://cdn-shop.adafruit.com/640x480/2137-03.jpg)

## Tools & Materials

You'll need:

- craft knife
- soldering iron
- screwdriver
- Duct tape
- Artist's canvas
- Small wood screws x4

# Illuminated Butterfly Wall Art

## Electronics

To make the butterfly wing pattern symmetrical, the LEDs are placed in identical, but mirrored, layouts. You can get display the same pattern in both halves by connecting the two strands to the same data line. In order to connect both halves of the Pebble stands to the power and data pins, you first need to combine their wires.

The power of one strip should be connected to the power of the other. The two grounds should also be connected, as should the two data-in lines.

This image shows how you'll connect them:

![](https://cdn-learn.adafruit.com/assets/assets/000/134/963/medium800/leds_schematic.png?1738581728)

Danger: Finding which wires are which can be tricky. For the LED Pebbles, there are no very obvious markings. Erin St. Blaine has written a guide page which helps identify which wires are which.

### Sparkle Motion Skirt with 2D Mapping - Electronics Assembly

[Sparkle Motion Skirt with 2D Mapping](https://learn.adafruit.com/sparkle-motion-skirt-with-2d-mapping)
[Electronics Assembly](https://learn.adafruit.com/sparkle-motion-skirt-with-2d-mapping/electronics-assembly)
As shown in the Fritzing diagram above, you'll want to trim some wire back on each input side of the Pebble LED line and twist the same lines together such that you now have each like wire connected on the input sides of each strand. These three wires are then connected to the respective pads on the Mini Sparkle Motion: **5V** , **G/Ground** and the Pebble **Data in** to pin **32**.

You can solder straight onto the Mini Sparkle Motion, or add [a screw terminal block connector](https://www.adafruit.com/product/2137) (not included, sold separately) to the Mini Sparkle Motion and screw in the wires to make it easy to attach or detach the controller.

There are troubleshooting steps on Erin's page if later in the build the lights are not acting as intended.

### 2.54mm/0.1" Pitch Terminal Block - 4-pin

[2.54mm/0.1" Pitch Terminal Block - 4-pin](https://www.adafruit.com/product/2137)
After a long day out harvesting in the terminal block fields, we've returned with a veritable bounty of these very nice and compact 2.54mm/0.1" terminal blocks in a variety of sizes.

Our harvest of terminal blocks is great news&nbsp;since nothing makes a project harder to...

In Stock
[Buy Now](https://www.adafruit.com/product/2137)
[Related Guides to the Product](https://learn.adafruit.com/products/2137/guides)
![Angled shot of black 4-pin 2.54mm terminal block.](https://cdn-shop.adafruit.com/640x480/2137-03.jpg)

![](https://cdn-learn.adafruit.com/assets/assets/000/135/205/medium800/leds_a.png?1739222005)

The build above shows three colored wires connected to each Pebble LED strand end and then leading to the Mini Sparkle Motion, without a terminal block.

# Illuminated Butterfly Wall Art

## Build

The physical build is made up of two parts:

- a mask that slots into the back of your canvas
- a box that holds the LEDs

The box is cut from one sheet of corrugated plastic. It will fold up and slot into the back of the canvas and secured with four screws

## Cut the Mask

A butterfly shape will be used to mask out some of the light from the LEDs, leaving just an image of a butterfly -- a little like a reverse silhouette.

First, you need an image of a butterfly. Below is one that you can download, or you can search for your own. You'll need to scale this to the appropriate size for your canvas and print it out on a sheet of paper.

[butterfly_shape.svg](https://cdn-learn.adafruit.com/assets/assets/000/134/949/original/butterfly_shape.svg?1738334304)
![](https://cdn-learn.adafruit.com/assets/assets/000/134/943/medium800/leds_cutting-bits.jpg?1738322094)

Cut a sheet of your corrugated plastic to fit inside the back of the canvas. This should be very snug, and if anything, slightly oversized.

Once you have this cut out, tape the butterfly shape in the middle, and use a craft knife to cut out the shape. It is easiest to do several light passes with a craft knife rather than a single hard pass.

If your corrugated plastic is translucent, you might want to cut the same shape out of dark paper or card to block more of the light. Here you can see that I've used a bit of tape to hold the dark paper and corrugated plastic together

![](https://cdn-learn.adafruit.com/assets/assets/000/135/237/medium800/leds_new_1.jpg?1739272679)

Warning: Be careful when using a craft knife to avoid cuts. Suitable eye protection would be prudent also.

## Build the box

You can 'score' the corrugated plastic using a light pass of a craft knife -- this makes it bend easily in exactly the place you want. It takes a bit of practice to get this right, and the bits you cut out from the butterfly are ideal for cutting practice.

&nbsp;

![](https://cdn-learn.adafruit.com/assets/assets/000/134/944/medium800/leds_score_and_bend.jpg?1738322289)

The cuts you need to make for the box are shown in the image below.

- Red lines are scores on the front
- Blue lines are scores on the back
- Black lines are through-cuts

Exact dimensions aren't given as it's based off the actual size of the canvas, which will vary a bit from manufacturer to manufacturer. This will be detailed shortly.

The length of the two side folds isn't critical. These are used for screwing the plastic sheet to the canvas.

![](https://cdn-learn.adafruit.com/assets/assets/000/134/951/medium800/leds_backing-cuts-cropped.png?1738335110)

Start by scoring the inner rectangle. This is the same size as the mask, so you can use it as a template. The outer square should be about 1.25 inches (3cm) bigger, so make sure there's space for this.

Tape the mask to the middle of a section of corrugated plastic making sure that there is sufficient space on all sides. Once you've scored this, you can work outwards by measuring and cutting.

The two blue scores on the side should be approximately half the length of the side, leaving about a quarter at the top and bottom. The blue scores need to sit on the wood of the canvas, so they need to be the same distance in as the wood is thick.

![](https://cdn-learn.adafruit.com/assets/assets/000/135/238/medium800/leds_new_4.jpg?1739273638)

## Attach the LEDs

Corrugated plastic is, in some ways, easy to work with, but it does have one problem: not much sticks to it. CA glue holds a bit, and there are some specialized adhesives. However, I've had the most success with duct tape.

Your two strings of LEDs should be positioned in an exact mirror image of each other. This way whatever pattern you display will be mirrored perfectly on each wing. Zig zag the strands up the sheet in the way shown in the photo. Ideally, you want the LEDs on one layer to fall between the LEDs on the layer below. This will prevent any dark spots.

![](https://cdn-learn.adafruit.com/assets/assets/000/134/945/medium800/leds_mounted.JPG?1738322508)

## Bringing Everything Together
The control board can be held in place by a bit of tape that's stuck back on itself.

![leds_sparkle_motion_mounted.jpg](https://cdn-learn.adafruit.com/assets/assets/000/135/245/medium640/leds_sparkle_motion_mounted.jpg?1739275991)

Your USB cable for powering the project needs to run from the wall USB power source and pass through the plastic sheet to the Mini Sparkle Motion board. Cut a cross in at the appropriate place for passing the cable (don't forget to account for the fact that part of the plastic will be covered by the wood of the canvas).

![leds_USB_cable.jpg](https://cdn-learn.adafruit.com/assets/assets/000/135/244/medium640/leds_USB_cable.jpg?1739276139)

You'll need a way of hanging your art on the wall. I used picture wire, but you could use string or even regular hookup wire. You'll need to make two small cuts on either side of the picture that you can thread the wire through and twist it to keep it secure.

![leds_cable.jpg](https://cdn-learn.adafruit.com/assets/assets/000/135/243/medium640/leds_cable.jpg?1739275275)

Fold the sheet in to make a box. This should fit snugly inside the canvas.

![leds_new-2.jpg](https://cdn-learn.adafruit.com/assets/assets/000/135/242/medium640/leds_new-2.jpg?1739275911)

With the box now inside the canvas, it just needs some screws to hold it in place.

![leds_new_5.jpg](https://cdn-learn.adafruit.com/assets/assets/000/135/241/medium640/leds_new_5.jpg?1739274705)

Your butterfly is now ready for software and then to hang on the wall, plug in, and enjoy.

![](https://cdn-learn.adafruit.com/assets/assets/000/134/964/medium800/leds_complete_2.jpg?1738582710)

Next, we'll take a look at the software. WLED is a software package that you'll load onto the Mini Sparkle Motion and then configure via your computer.

# Illuminated Butterfly Wall Art

## WLED Setup

The following pages will walk you through installing WLED, setting up the various features within the software and getting your lights turned on and responding to sound or IR control. We'll also show you how to connect sensors via the onboard Stemma port and add button control. And, we'll show you how to set up multiple strands and multiple controllers and sync them together for larger scale projects.

Ready? Set? Let's go.

![](https://cdn-learn.adafruit.com/assets/assets/000/134/467/medium800/adafruit_products_wled_interface.jpg?1736880807)

# Illuminated Butterfly Wall Art

## WLED Software

## Board Choices

WLED runs on several different boards in Adafruit's collection. There are different benefits to each, but the installation process is largely the same. This page contains instructions for multiple boards -- be sure to use the pinouts and installation instructions for the one you're using,

**Sparkle Motion**

This is our flagship ESP32 board, designed with WLED and Xlights in mind. It has 4 outputs and is set up to drive either 5v, 12v or 24v pixels. It's a workhorse of a board and for larger projects it's the clear winner. It has an onboard microphone for instant sound-reactive support, and an IR sensor built in, to make it easy to control your project with an infrared remote. It also has a couple stemma ports so you can add your own sensors or peripherals.

**Sparkle Motion Mini**

The Sparkle Motion Mini is a smaller version of the Sparkle Motion board. It has two LED outputs, a microphone, and two stemma ports that make it easy to add an IR sensor or other peripherals. It's got an onboard NeoPixel and a small footprint, making it perfect for wearables or smaller projects. It will power a whole lot of pixels through the onboard USB port: it's safe to draw up to 4A through this port, giving you plenty of power for most wearable projects.

Info: For Sparkle Motion Mini use at least the 0.15.1 release of WLED.

 **QT Py Pico ESP32**

The [QT Py Pico](https://www.adafruit.com/product/5395) is small and affordable, so usually my go-to for smaller costumes or wearables. It also has a range of BFF add-on boards that add functionality.&nbsp;[Here's a guide with more QT Py info](https://learn.adafruit.com/adafruit-qt-py-esp32-pico/overview). The QT Py will drive up to around 30 pixels through the onboard USB port, so if you have more LEDs than that you may want to consider the Sparkle Motion Mini instead, or you can power the board through the +5v pin.

Note: WLED works on the QT Py Pico but NOT on the S2 or S3 versions, at the time of writing.

**Feather Huzzah ESP32&nbsp;**

The [Feather Huzzah ESP32](https://www.adafruit.com/product/3405) the top of the line. It's a great choice for projects where you want to add sensors, interaction, or drive a whole lot of LEDs. It's the most reliable as well -- I've run these for two months straight with no power cycling and they just keep on truckin. Adafruit has a very wide selection of Feather Wing boards that connect to the Feather microcontroller line. The sky is the limit with these boards.

It also comes in a version with a high-powered WiFi range extender! If you're trying to sync multiple instances across distance, check this one out. [Feather Huzzah ESP32 V2 w.FL Antenna](https://www.adafruit.com/product/5438)

**Feather Huzzah ESP8266**

The [Feather Huzzah ESP8266](https://www.adafruit.com/product/2821) will run WLED as well, but won't drive as many pixels: the ESP32 limit on WLED is around 1000 pixels per input, but the ESP8266 tops out at around 500. It's about $5 cheaper though, so for smaller projects it's a great way to save a little money and still have access to all the Featherwing options in the Adafruit store.

## Driver Update

Some versions of our controllers have a new serial chip which needs a driver installed before we can install WLED. Head over to our&nbsp;[How to Install Drivers for WCH USB to Serial Chips](https://learn.adafruit.com/how-to-install-drivers-for-wch-usb-to-serial-chips) tutorial, and download and install the new driver.

If you have an older QT Py with CP2102 USB-to-Serial bridge, [use SiLabs’ driver instead](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers?tab=downloads).

&nbsp;

## Install WLED

These next steps require a **_Web Serial_-compatible browser**. As of this writing, that means **Google&nbsp;Chrome** , **Microsoft&nbsp;Edge** or **Opera** ,or **Firefox** “desktop” browsers. Other browsers (Safari, Explorer and&nbsp;_anything_ mobile) won’t work.

Visit [https://install.wled.me/](https://install.wled.me/)

Plug your microcontroller into your computer with a known good USB cable. Click "Install" and select the port for your board.

Depending on the USB-to-serial bridge chip on the board, you might see one _or two_ serial ports. On Mac, for instance, there might be both “/dev/cu.usbmodem[number]” _and_ “/dev/cu.wchusbserial[number]”. Use the “ **wchusbserial** ” one.

![adafruit_products_Install_WLED.jpg](https://cdn-learn.adafruit.com/assets/assets/000/115/287/medium640/adafruit_products_Install_WLED.jpg?1663802069)

After successful installation, enter your WiFi network name and password when prompted. This must be a **2.4 GHz** WiFi network; ESP32 does not support 5 GHz networks. If it can’t connect, then as a fallback WLED will create its own 2.4 GHz WiFi access point.

![led_strips_Install_WLED.jpg](https://cdn-learn.adafruit.com/assets/assets/000/134/601/medium640/led_strips_Install_WLED.jpg?1737574345)

Danger: Sometimes the "Connect to Wi-Fi" prompt doesn't show up. Don't panic, just see the step below on connecting your computer or mobile device to the WLED-AP access point created on the microcontroller itself!

If you don't see the "Connect to Wi-Fi" prompt, you'll need to set up your WiFi network using AP (access point) mode.&nbsp;Open up your WiFi settings and look for a WiFi network called&nbsp;`WLED-AP`. (Note, this access point can take up to 30 seconds to appear sometimes.) Connect to this network&nbsp;using the default password&nbsp;`wled1234`. The WLED interface will pop up in its own captive browser window.

From here, go into **Config/Wifi Settings** and enter your WiFi credentials for the access point you normally use near the top.

Give your project a name in the mDNS field a little further down the page. Now you can type in "projectname.local" (where "projectname" is your mDNS name) into any web browser on the same wifi network to access your microcontroller.

You can also scan the QR code below to open access point mode.&nbsp;

For more help and troubleshooting tips visit the [Getting Started page on the WLED knowledge base.](https://kno.wled.ge/basics/getting-started/)

![led_strips_install_no_wifi.jpg](https://cdn-learn.adafruit.com/assets/assets/000/134/597/medium640/led_strips_install_no_wifi.jpg?1737574050)

![](https://cdn-learn.adafruit.com/assets/assets/000/136/104/medium640/led_strips_Screenshot_2025-03-31_at_9.39.02%E2%80%AFAM.jpg?1743439611)

![led_strips_WLED_wifi_settings.jpg](https://cdn-learn.adafruit.com/assets/assets/000/134/598/medium640/led_strips_WLED_wifi_settings.jpg?1737574103)

![](https://cdn-learn.adafruit.com/assets/assets/000/134/599/medium800/led_strips_WLED-QR-Connect-WB.png?1737574151)

## Setup & Preferences
### WiFi&nbsp;Setup

Head to the **WiFi Setup** screen under Config and create a good URL so you can control your project from any web-enabled device. Call it something you'll remember, that's easy to type into any web browser on your WiFi network in order to connect to your project.

In Safari or Chrome on your phone or computer, type in this web address to access the WLED interface: [http://projectname.local](http://projectname.local)&nbsp; (where "projectname" is whatever you put into this field).

Check out the Additional Settings page for more info on accessing your project. WLED has an "access point mode" that doesn't require a WiFi network for when you're out on the go. It's also helpful to download one of the WLED apps to help manage and organize your projects.

![adafruit_products_wled_config.jpg](https://cdn-learn.adafruit.com/assets/assets/000/115/288/medium640/adafruit_products_wled_config.jpg?1663802411)

![led_strips_adafruit_products_WiFi_Settings_generic.jpg](https://cdn-learn.adafruit.com/assets/assets/000/131/679/medium640/led_strips_adafruit_products_WiFi_Settings_generic.jpg?1722624553)

### LED Preferences

Next, head to the **LED Preferences** tab under the Config menu.

Scroll down to&nbsp; **Hardware Setup**. Put your total number of LEDs into the "Length" field, and change GPIO to the pin number associated with the pin you soldered to. Check the pinout diagram for the board you're using (it's the number in yellow).

- [Sparkle Motion Pinout](https://learn.adafruit.com/adafruit-sparkle-motion)
- [Sparkle Motion Mini Pinout](https://learn.adafruit.com/adafruit-sparkle-motion-mini/overview)
- [QT Py Pico Pinout](https://learn.adafruit.com/assets/112309)&nbsp;
- [Feather Huzzah ESP8266 Pinout](https://learn.adafruit.com/assets/46249)&nbsp;
- [Feather Huzzah ESP32 Pinout](https://learn.adafruit.com/adafruit-huzzah32-esp32-feather/pinouts)

![led_strips_led_settings.jpg](https://cdn-learn.adafruit.com/assets/assets/000/131/680/medium640/led_strips_led_settings.jpg?1722624626)

## Use It
![adafruit_products_WLED_interface.jpg](https://cdn-learn.adafruit.com/assets/assets/000/115/394/medium800/adafruit_products_WLED_interface.jpg?1667150591)

Now you can use any computer or handheld device to control your LEDs.&nbsp;

Make sure your device is on the same WiFi network as your board. Navigate to your custom URL (projectname.local/ ) in a web browser. You'll see a color picker above a whole bunch of color palette choices.

Choose a color, choose an effect, and watch your lights animate and glow!

Save your favorite combinations as presets, create playlists, control the speed and intensity of the animations, and lots more. This web app is incredibly intuitive and easy to use.

Head over to the WLED wiki at [https://kno.wled.ge/](https://kno.wled.ge/) to delve into all the particulars.

# Illuminated Butterfly Wall Art

## WLED Config

Next we'll tell WLED about our physical setup. We'll give our project a name and easy-to-remember URL, and tell the software how many LEDs we have set up on each pin.

### WiFi&nbsp;Setup

Head to the **WiFi Setup** screen under Config. This is where your network credentials live, so you can change them if needed. Scroll down to the mDNS field and create a good URL so you can control your project from any web-enabled device. Call it something you'll remember, that's easy to type into any web browser on your WiFi network in order to connect to your project.&nbsp;

In this example, I'd go to my web browser on my phone, ipad, or computer, and type in "http://projectname.local" to open up the WLED interface on my screen.&nbsp; Your device must be on the same WiFi network as your board.

![adafruit_products_wled_config.jpg](https://cdn-learn.adafruit.com/assets/assets/000/115/288/medium640/adafruit_products_wled_config.jpg?1663802411)

![led_strips_adafruit_products_WiFi_Settings_generic.jpg](https://cdn-learn.adafruit.com/assets/assets/000/131/679/medium640/led_strips_adafruit_products_WiFi_Settings_generic.jpg?1722624553)

Warning: Before using GPIO 32 for data, you need to deselect it from the microphone configuration. See this [GitHub issue for reference](https://github.com/wled/WLED/issues/4501).

### LED Preferences

Next, head to the **LED Preferences** tab under the Config menu.

Scroll down to&nbsp; **Hardware Setup**. The Sparkle Motion Mini board has 2 outputs to attach LED strips: GPIO pins 32 and 33.

WLED allows up to 3 strips to be connected at once. The strips can be of different types, lengths, and color order. Select your LED type, length, and GPIO pin. If you have multiple strips connected, click the + button and enter the additional strips in the same way.&nbsp;

![adafruit_products_LED_Settings.jpg](https://cdn-learn.adafruit.com/assets/assets/000/134/602/medium640/adafruit_products_LED_Settings.jpg?1737575535)

Click "save" and if you've done everything correctly, your light strands should come on in a warm, cheerful yellow color. Success! Time to start making pretty light animations.&nbsp;

## Troubleshooting

_If your lights didn't come on, here are a few things to try:_

1. Head back to WLED and check your pinout configuration under LED Preferences. Be sure the pin number is the correct GPIO for the attachment point you used.
2. Check your wiring! Be sure you connected to the IN end of the LED strip. These strips can be inconsistent so this is a pretty common problem. Use an [alligator clip](https://www.adafruit.com/product/1008) to try connecting the data wire on the other end (the power and ground wires should work from either end).
3. Try re-uploading the WLED software.&nbsp;
4. If the lights come on but you can't control them: i.e. you type in "projectname.local" into your browser and it won't connect, make sure you're on the correct WiFi network. If you're on a different network than the one you set up the sofware on, you won't see the WLED connection.
5. If your lights came on in blue or green instead of yellow, your color order is wrong. See below to fix.
6. If only half your lights came on, be sure you've got the correct number in the "length" field under LED preferences.
7. If your lights came on in a variety of weird colors and looking like a 1950s diner interior, you may have the wrong LED strip type selected. RGBW strips and RGB strips are not the same, so be sure you've got the correct strip type or you'll get very odd behavior.
8. If your microcontroller hangs or keeps rebooting, or gets really hot, you may have the power and ground lines switched. Unplug right away and check: this is a fast way to brick your controller.

## Color Order
If your lights have come on in any color other than a warm yellow, there's one more setting to change. LED strips and pixels are not all standardized, and sometimes the red, green, and blue LEDs inside are connected in a different order.&nbsp;

In the main interface window, choose "solid" as your effect and red as your color from the color picker.&nbsp;

If your lights come on in any color other than red, your color order is set incorrectly. This is an easy fix. Head back to the LED settings tab and find the Hardware Setup section (this is where you set up your pin number earlier). Choose BRG from the dropdown, click save, and see if your pixel colors match your color picker now. If not, try another combo until the lights look correct.

![adafruit_products_15_rgb_order1.jpeg](https://cdn-learn.adafruit.com/assets/assets/000/134/448/medium640/adafruit_products_15_rgb_order1.jpeg?1736806444)

![adafruit_products_16_rgb_order2.jpeg](https://cdn-learn.adafruit.com/assets/assets/000/134/449/medium640/adafruit_products_16_rgb_order2.jpeg?1736806608)

# Illuminated Butterfly Wall Art

## Setting the Light Pattern

Now that the electronics and software are set up, it's time to create the WLED pattern to light up the butterfly. There aren't any hard-and-fast rules here, and you can illuminate your butterfly however you like.

Personally, I like a blue butterfly with a shimmer of purple to give the effect of iridescence. This is inspired by butterflies such as the Common Blue and Holly Blue. Another common color pallet in nature is orange and red. However, you don't have to be limited by real life butterflies, you can pick whatever you like.

To create the effect for a Common Blue inspired butterfly, first you have to make some settings in the **Colors** tab in WLED. Pick a blue for **color 1** and purple for c **olor 2** , then select **Colors 1&2** in the pallet type list.

![](https://cdn-learn.adafruit.com/assets/assets/000/134/862/medium800/leds_Screenshot_20250128-154717.jpg?1738079918)

You can now switch to the effects tab and select your effect. I like the **Blends** effect.

![](https://cdn-learn.adafruit.com/assets/assets/000/134/864/medium800/leds_Screenshot_20250128-154727.jpg?1738080216)

Finally, in order to make your butterfly start with the same pattern when it's powered on, you need to save the setup as a preset.

In the **Presets** tab, click **Create Preset** , give it a name and click **Save Preset**. This will give it a preset ID. Remember this as you'll need it in the next step.

![](https://cdn-learn.adafruit.com/assets/assets/000/134/863/medium800/leds_Screenshot_20250128-154744.jpg?1738079955)

Go to **Config \> LED**  **Preferences** and scroll down. Near the bottom you'll find the **Defaults** section, and in this section, you'll see the option to **Apply Preset x At Boot**. Change the number to the ID of the preset you just created, and scroll back to the top to save the settings. Now, each time you power on your device, it'll start with the correct lighting.

https://youtu.be/pi6GCrCKxNg


## Featured Products

### Mini Sparkle Motion - WLED-friendly ESP32 NeoPixel LED Driver

[Mini Sparkle Motion - WLED-friendly ESP32 NeoPixel LED Driver](https://www.adafruit.com/product/6160)
The **Adafruit Sparkle Motion Mini** &nbsp;is part of our&nbsp;series of "Sparkle Motion" boards, that are our attempt to make the&nbsp;best small&nbsp;WLED-friendly smart LED driving board in the whole world. Our resident mermaid, <a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/6160)
[Related Guides to the Product](https://learn.adafruit.com/products/6160/guides)
### Adafruit NeoPixel Pebble / Seed LED Strand - 200 LEDs - 2" Pitch

[Adafruit NeoPixel Pebble / Seed LED Strand - 200 LEDs - 2" Pitch](https://www.adafruit.com/product/6024)
We have all&nbsp;sorts of LED strips for a wide range of needs.&nbsp;[_Chonky_](https://www.adafruit.com/product/3869)&nbsp;strips? We got those!&nbsp;[Strips with alligator...](https://www.adafruit.com/?q=neopixel%20alligator%20clips%20stripping%20wires)

In Stock
[Buy Now](https://www.adafruit.com/product/6024)
[Related Guides to the Product](https://learn.adafruit.com/products/6024/guides)
### Wall Power Supply with USB C - 5V 3A Output and Switch

[Wall Power Supply with USB C - 5V 3A Output and Switch](https://www.adafruit.com/product/5802)
We love the Raspberry Pi 4 and 5, with their fancy new USB Type C power connectors. Now we have an even&nbsp;_better_&nbsp;power supply that can be used with either Pi 4 or even a Pi 5 with 5V output, 3A of current to handle builds with accessories and displays. This flat square body...

Out of Stock
[Buy Now](https://www.adafruit.com/product/5802)
[Related Guides to the Product](https://learn.adafruit.com/products/5802/guides)
### Pink and Purple Woven USB A to USB C Cable - 2 meters long

[Pink and Purple Woven USB A to USB C Cable - 2 meters long](https://www.adafruit.com/product/5044)
This cable is not only super-fashionable, with a woven pink and purple Blinka-like pattern, it's also made for USB C for our modernized breakout boards, Feathers and more.&nbsp; [If you want something just like it but for Micro B, we have a B...](https://www.adafruit.com/product/4111)

Out of Stock
[Buy Now](https://www.adafruit.com/product/5044)
[Related Guides to the Product](https://learn.adafruit.com/products/5044/guides)
### 2.54mm/0.1" Pitch Terminal Block - 4-pin

[2.54mm/0.1" Pitch Terminal Block - 4-pin](https://www.adafruit.com/product/2137)
After a long day out harvesting in the terminal block fields, we've returned with a veritable bounty of these very nice and compact 2.54mm/0.1" terminal blocks in a variety of sizes.

Our harvest of terminal blocks is great news&nbsp;since nothing makes a project harder to...

In Stock
[Buy Now](https://www.adafruit.com/product/2137)
[Related Guides to the Product](https://learn.adafruit.com/products/2137/guides)

## Related Guides

- [Adafruit Sparkle Motion Mini](https://learn.adafruit.com/adafruit-sparkle-motion-mini.md)
- [Tree Branch Wall Lamp with Sound Reactive Lights](https://learn.adafruit.com/tree-branch-wall-lamp-with-sound-reactive-lights.md)
- [Synchronized NeoPixel Shoelaces with WLED](https://learn.adafruit.com/neopixel-shoelaces-with-wled.md)
- [Sparkle Motion Dance Shoes](https://learn.adafruit.com/sparkle-motion-dance-shoes.md)
- [Close Encounters of the MIDI NeoPixel Visualizer Kind](https://learn.adafruit.com/midi-neopixel-visualizer.md)
- [Holiday Lights: Easy DIY Christmas Wreath & Garland with WLED](https://learn.adafruit.com/holiday-garland-decor-app-control-with-no-coding.md)
- [xLights for Sparkle Motion Board](https://learn.adafruit.com/xlights-for-sparkle-motion-board.md)
- [MIT Green Building NeoPixel Tetris](https://learn.adafruit.com/tetris-building.md)
- [Icicle Crown with Pebble Pixels & WLED](https://learn.adafruit.com/icicle-crown-with-pebble-pixels-wled.md)
- [NeoPixel LED Mickey Ears](https://learn.adafruit.com/neopixel-led-mickey-ears.md)
- [Electronic Animated Eyes for ARM Microcontrollers](https://learn.adafruit.com/animated-electronic-eyes.md)
- [NeoPixel Bike Light](https://learn.adafruit.com/neopixel-headlight.md)
- [SmartMatrix Animated GIF Player](https://learn.adafruit.com/smartmatrix-animated-gif-player.md)
- [Animated NeoPixel Glow Fur Scarf](https://learn.adafruit.com/animated-neopixel-gemma-glow-fur-scarf.md)
- [Glowing Hair Flowers with n00ds](https://learn.adafruit.com/glowing-hair-flowers-with-n00ds.md)
- [Adafruit 1-Wire GPIO Breakout - DS2413](https://learn.adafruit.com/adafruit-1-wire-gpio-breakout-ds2413.md)
