How It Works

Transform your LED matrix into a smart display in under 5 minutes. No technical skills required - just follow our simple setup process.

From Unboxing to First Animation in 5 Minutes

Three simple steps to get your LED matrix displaying amazing animations

1
Connect Your Hardware

Connect your LED matrix to a WLED controller and Set the led configuration up as a 2d matrix.

2
Download & Setup

Download Pipplee app, scan for your device, and connect with your device.

3
Start Playing

Choose from thousands of animations, upload your own content, or create custom text displays instantly.

System Requirements

Mobile Device
  • iOS 12.0 or later
  • Android 6.0 (API level 23) or later
  • WiFi connection required
  • 50MB free storage space
Hardware Requirements
  • WLED 0.13.0 or later
  • ESP32 controller
  • WS2812B/WS2813 LED strips
  • Adequate power supply (5V)

Supported Matrix Sizes

Pipplee works with any rectangular LED matrix configuration

16×16

Perfect for beginners
256 LEDs total

Most Popular
32×32

High resolution displays
1,024 LEDs total

64×32

Wide format displays
2,048 LEDs total

Custom

Any size you have

Detailed Setup Guide

What You'll Need:
  • LED matrix panels or flexible LED strips arranged in a grid
  • ESP32 microcontroller
  • 5V power supply (adequate for your LED count)
  • Jumper wires for connections
Installation Steps:
  1. Flash WLED firmware to your ESP32
  2. Connect your LED matrix data pin to GPIO2 (or your preferred pin)
  3. Connect power and ground to both controller and LED matrix
  4. Power on your setup - WLED will create a WiFi access point
Pro Tip

Need help with WLED installation? Visit install.wled.me for easy browser-based flashing.

  1. Connect to the WLED access point (usually named "WLED-AP")
  2. Open your browser and go to 4.3.2.1
  3. Configure your WiFi network in WLED settings
  4. Set up your LED preferences:
    • LED count (width × height)
    • LED type (usually WS2812B)
    • Data pin configuration
    • 2D setup with matrix width and height
  5. Save settings and restart WLED
Important

Make sure to enable "2D Configuration" in WLED settings for matrix layouts to work properly with Pipplee.

  1. Download Pipplee from Google Play Store or Apple App Store
  2. Open the app and tap "Scan for Devices"
  3. Select your WLED device from the list and Connect
  4. Test with a simple animation to verify setup
You're Ready!

Once setup is complete, you can start playing animations, uploading content, and creating custom displays!

What You Can Do with Pipplee

Play Animations

Access thousands of pre-made animations from our community library

Upload Content

Upload your own GIFs, images, and videos to display on your matrix

Text Displays

Create scrolling text with custom colors, fonts, and background effects

Pixel Art

Draw directly on your matrix with our built-in pixel art editor

Advanced Setup Requirements

For Matrices with 256+ LEDs or Playlist Features

If your LED matrix has more than 256 pixels (e.g., 32×32, 64×32) or you want to use advanced playlist features, you'll need to upgrade to WLED 0.16-alpha for optimal performance.

Step 1: Download WLED 0.16-Alpha

Get the latest alpha version that supports enhanced features:

Download WLED 0.16-Alpha
What's New in 0.16-Alpha:
  • Faster Animations - Improved performance for large matrices
  • Playlist Support - Create sequences of animations
  • Auto-start - Animations load automatically on boot
Step 2: Install via OTA Update
  1. Connect to your WLED device web interface
  2. Go to Settings → Security & Updates
  3. Choose "Manual OTA Update"
  4. Upload the downloaded .bin file
  5. Wait for the update to complete and device to restart
Auto-Start Feature:

To enable animations to play automatically on device boot, set "Apply preset at boot" to 1 in WLED Settings → LED Preferences.

Important Backup Notice:

Your existing presets will be cleared when using Pipplee animations. Please backup your presets.json file before proceeding if you want to keep your current WLED presets.

Matrix Size Recommendations
16×16 (256 LEDs)

Standard WLED

Recommended
32×32 (1,024 LEDs)

Requires 0.16-alpha

Enhanced
64×32 (2,048 LEDs)

Requires 0.16-alpha

Enhanced
Anything above

Requires 0.16-alpha

Advanced

Digital Clock Feature Setup

Time Configuration for Clock Display

To use Pipplee's Digital Clock feature and display the correct time on your LED matrix, your WLED device must be properly configured with accurate time settings.

Time Setup Steps
  1. Access WLED Settings:
    • Connect to your WLED device web interface
    • Navigate to Settings → Time & Macros
  2. Configure Time Zone:
    • Set your correct Time Zone Offset (e.g., -8 for PST, +1 for CET)
    • Enable Daylight Saving Time if applicable to your region
  3. Enable NTP Synchronization:
    • Make sure NTP (Network Time Protocol) is enabled
    • Set a reliable NTP server (default is usually fine)
    • Configure sync interval (recommend every 1-4 hours)
  4. Test Configuration:
    • Save settings and restart your WLED device
    • Verify the displayed time matches your local time
Important Settings to Verify:
  • UTC Offset: Must match your local time zone
  • NTP Server: Should be reachable from your network
  • DST Rules: Configure if your region observes daylight saving
  • Network Connection: WLED needs internet access for NTP sync
Pro Tips
  • Format Options: Pipplee supports 12-hour and 24-hour time formats
  • Color Customization: Adjust text and background colors in the app
  • Size Adjustment: Font size automatically adapts to your matrix size
  • Auto-Update: Time refreshes automatically every minute
Clock Features
  • Real-time clock display
  • Customizable colors
  • Auto-sizing for matrix
  • 12/24 hour formats
  • Date display option
  • Smooth scrolling text
Troubleshooting Time Issues:
Wrong Time Displayed:
  • Check UTC offset setting
  • Verify NTP synchronization is working
  • Ensure device has internet access
Clock Not Updating:
  • Restart WLED device
  • Check network connectivity
  • Verify NTP server accessibility
Once configured correctly, your LED matrix will display accurate time automatically!

Ready to Get Started?

Download Pipplee now and transform your LED matrix into an amazing smart display!