> For the complete documentation index, see [llms.txt](https://manual.xlights.org/xlights/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.xlights.org/xlights/effects/off/butterfly.md).

# Butterfly

![Icon](/files/-LbqAd3F6uaOwTFujE0B)

![Sequencer Grid](/files/-LZS5yLMm9d_DYh-Rumv)

![](/files/-LZSLMWSFaFk9DfrMvaG)

The Butterfly effect creates seemingly random patterns of color swirling around, based on an initial set of parameters. This is very effective on a number of different types of models.

| **Options/Settings** | **Description**                                                                                                                  |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Colors**           | Rainbow or Palette can be selected. If Palette is selected, then the colors from the Color selection window are used**.**   |
| **Style**            | Up to 10 different styles can be selected for the effect.                                                                        |
| **Bkgrd Chunks**     | Controls whether and how sections of black color are to be used between the colors. Can be adjusted via the Value Curves options |
| **Bkgrd Skip**       | Used in conjunction with the background chunks to skip the black background. Can be adjusted via the Value Curves options.       |
| **Speed**            | Controls the speed with which the effects change. Can be adjusted via the Value Curves options                                   |
| **Direction**        | Controls whether the effect moves outwards or reverses direction.                                                                |

{% hint style="success" %}
Butterfly style #2 generates radial patterns that look great on round models such as snowflakes, stars, globes, etc.
{% endhint %}

{% hint style="success" %}
The effect can be repeated on the same model with different colors, directions or timings, using layers and offsetting the position on the model.
{% endhint %}