How do I map my Twinkly device?

Step by step procedure for mapping your Twinkly devices.

Applies to Twinkly Generation I and Generation II devices, Twinkly PRO and Twinkly Plus.


Life’s in 3D. So should be your creations.

We want your effects to be wonderful and ready to surprise you day after day.

Our latest patent for advanced 3D reconstruction allows you to map your layout from multiple different angles till it reaches the point of perfection with an amazing 3D layout as a result!

Now have fun painting your effects directly on your real-life canvas, LED by LED you will be able to add your brushstrokes to your masterpiece!

We gave you the recipe, the only ingredient to add is your fantasy!


Thanks to the mapping feature, there are no products that are suitable for certain surfaces. Twinkly is a smart and versatile device that can adapt to any shape, any place. The same product will be perfect on several different occasions!

Start-up and Selection of the type of mapping

Access the Layout menu and accept the permission required by the application to access your smartphone’s camera. 

Choose the type of mapping you want to do.

Some options may  depend on the device you are using  and  on the status of your device (online/offline).


The Flip feature allows you to reflect your layout as in a mirror.

Easy Mapping

This kind of mapping is recommended for installations where the lights are mostly on a single surface.

The algorithm will automatically identify the position of the LEDs located on the sides and back of the holder, estimating their position.

Start the process by clicking on “Mapping” and select “Easy Mapping”: the LEDs will start flashing quickly and the magic begins!

The mapping ends when the LEDs are on a fixed color. It’s possible to save or repeat the operation.

In case of poor results, a pop-up will indicate the “Poor results” condition and it’s possible to repeat the operation.

Mapping 2D_Tap

Advanced Mapping 

This mapping mode is more advanced because it allows you to make a larger number of scans, resulting in an even more accurate layout.

This innovative method of mapping LEDs allows you to scan the different sections of your installation an unlimited number of times, for a perfect, 360 ° rendering.

During the mapping process the LEDs will appear in 4 different colors, based on their status:

  • RED: they don’t still have space coordinates.
  • ORANGE: the LEDs are recognized for the first time by the camera (XY coordinates)
  • YELLOW: the LEDs are recognized for the second time by the camera.
  • GREEN: the LEDs are completely recognized and in a three-dimensional way (depth coordinates)

When all the LEDs are green, it means that the entire installation has been properly mapped.

Congrats! Your lights have been mapped and the app will show you your actual Layout.

You can choose to keep it or try again.

Advanced mapping_Tap


Please note:

  • If you wish to redo the mapping procedure and get a new layout, simply click on "Restore"
  • On devices with iOS operating system you can map with horizontal camera, you just have to enable the rotation (of the phone camera)

There are some useful tricks to get the best results from the Mapping procedure.
Read this article to learn more.


Not found what you were looking for? Contact us.