Getting Started with Mapping

1. Open the Twinkly App and tap the Mapping icon – it looks like a hashtag (#) and is located second from the bottom right corner.
2. Tap “Map Lights.”
3. Choose Your Mapping Method:
   • Quick Scan
   • Fast Cone
   • 3-D Shape
   • Cone
   • Vertical Surface

 Note: 3-D Shape, Cone, and Vertical Surface mapping methods require an active internet connection, as they process mapping data through the cloud.

1. Review the Mapping Tips provided in the app and tap Next to continue.

Performing the Mapping

1. Make sure the entire installation is visible in your device’s camera frame before tapping Start Mapping.
2. Keep your camera steady during the mapping process. For best results, use a tripod or stabilizer.

Once the mapping is complete, your lights will turn white from top to bottom to show the mapped layout.

• If you're happy with the result, tap OK to confirm.
• If not, tap Try Again and repeat steps 5–6.

After Mapping

• The Twinkly app will now generate a set of effects for your mapped setup. This may take a few minutes depending on your internet speed.
• Once finished, the app will return you to the Device Effects tab.

Pro Mapping Tips

• If parts of your display are missing in the mapped result, check that all light capsules are fully visible to the camera.
• Low ambient light (overcast, dawn, or dusk) is ideal. Avoid bright sunlight or full darkness.
• Remove or cover any mirrored or reflective surfaces nearby, as they can distort mapping accuracy.
• When using the Join mapping feature, ensure your controllers are properly grouped:
  • Tap the chain icon in the top-right corner of the app to begin grouping.
  • Use Sync or Area options to map controllers individually or collectively.
• Use 4G Mapping in Low Connectivity Areas
  If you're working in an area with unstable Wi-Fi or weak connectivity, Twinkly offers a powerful solution:
  • 4G Mapping is available on Twinkly PRO, Plus, and Lightwall devices running iOS or Android App version 3.19 or later.
  • This feature allows you to perform precise mapping using your mobile device’s 4G connection, even when no Wi-Fi network is available.
  • By default, 4G Mapping is automatically enabled for setups with more than 6,000 LEDs. For smaller installations, you can manually activate it by enabling the “Force OpenLoop Mapping” option in the app settings.
  • During 4G Mapping, your device or object may appear offline (since it’s not on the same network), but mapping will still complete normally.

Incremental Mapping (3D Mapping Only)

The Incremental Mapping feature allows you to build your 3D layout over multiple sessions for greater accuracy and flexibility.

• Pause and Continue Later:
  You can pause the mapping process at any time without having to finish it out. Just press the X or back arrow, and your progress will be saved.
• Resuming Mapping:
  You can come back to the app, go back to layout, tap “Map Lights” and choose “Continue Mapping” to pick up from where you left off. You can still choose to start a new mapping session that will overwrite your prior work.
• Refining an Existing Layout:
  If you’ve already saved a layout but want to improve it, you can add additional mapping steps similar to how you would continue an unfinished map. The app will guide you to continue from your last saved point, making your final layout more precise with additional steps.

Mapping Adjustments with Twinkly Cloud Console

The Twinkly Cloud Console (cloud.twinkly.com) provides advanced control over your mapped layout:

• Rotate or adjust the orientation of your mapped lights to correct for sloped surfaces, angled installs, or to change how an effect is displayed.
• This tool is available for Ethernet-connected Pro, Plus, and Lightwall devices and includes a 3D preview of your mapping layout.

 For more in-depth instructions, check out our full guide: Cloud Console Overview