1. Create an account — click Get Started in the top nav. Enter your email and a password (minimum 8 characters with at least one number).

2. Confirm your email — after registering, check your inbox for a confirmation email from noreply@wledpresets.com. Click the link to activate your account. Check your spam folder if it doesn't arrive within a few minutes.

3. Add your controller — after signing in you'll land on your Dashboard. Click Controllers, then + Add Controller, give it a name, and enter the IP address or hostname of your WLED device (e.g. 192.168.1.50 or wled-outside.local).

4. Download and run the agent — click Download Agent in the top nav and grab WledAgent.zip. Unzip it, run WledAgent.exe, and sign in with your wledpresets.com credentials. The agent bridges the site to your local WLED devices.

5. Import your existing presets — with the agent running, use Sync from WLED on the My Presets page to pull presets straight from your controller. Alternatively, click Manual Import on the Dashboard to paste or drag in a presets.json file.

6. Build new presets — click + New Preset on the My Presets page. Give it a slot number, set colors, effects, and segments. Slot numbers must be unique per controller.

7. Preview — click Preview on any preset to see an animated simulation before pushing to your controller.

8. Push to your controller — with the agent running, click Push to WLED on a single preset, or Push All Active to WLED to sync everything at once.

Your WLED controller's IP is the local network address assigned by your router. You enter it on the Controllers page when adding or editing a controller.

From WLED itself: If your controller has a display, the IP is shown on startup. Otherwise, check your router's admin page and look for a device named WLED.

Using a hostname: WLED broadcasts a hostname via mDNS (e.g. wled-outside.local). You can use this instead of an IP — find it in your WLED web UI under Config → WiFi Setup → mDNS address. Enter just the hostname with no http://.

Prevent IP changes: Your router assigns IPs dynamically, so they can change. To keep the IP fixed, set a DHCP reservation in your router settings — find your WLED device in the connected devices list and reserve its current IP.

From the WLED app: The official WLED mobile app shows connected devices and their IPs.

The WledAgent is a small Windows app that runs on your PC and connects your WLED devices to wledpresets.com. Because WLED devices are on your local network, the site can't reach them directly — the agent acts as the bridge.

Download — get it from the Download Agent page. Unzip and run WledAgent.exe. No installation required.

First run — the agent will prompt for your wledpresets.com email and password. Your credentials are saved securely on your PC (encrypted with Windows DPAPI) so you only need to enter them once.

What the agent does:

• Push Preset — sends a single preset to a specific slot on your WLED device
• Push All Active — uploads all active presets to your controller at once and reboots it to apply
• Sync from WLED — fetches all presets currently on your controller and imports them into wledpresets.com

Run as a Windows Service (optional) — to have the agent start automatically with Windows, open a Command Prompt as Administrator and run:

sc create WledPresetsAgent binpath= "C:\path\to\WledAgent.exe"
sc start WledPresetsAgent

Replace C:\path\to\ with the folder where you placed the exe. Once installed as a service, the agent starts on boot without needing to log in.

Resetting credentials — run WledAgent.exe --configure from a command prompt to update your saved email and password.

Agent status — the Presets page shows a green dot and version number when the agent is connected. If it shows offline, make sure the exe is running on your PC.

Profile page — click your username in the top-right nav to open the dropdown, then select ⚙️ Profile. From here you can enable two-factor authentication and manage recovery codes.

Two-factor authentication (2FA) — adds an extra layer of security by requiring a 6-digit code from an authenticator app (Google Authenticator, Authy, or any TOTP app) each time you sign in. To set it up:

1. Go to Profile → Set Up Authenticator App
2. Scan the QR code with your authenticator app
3. Enter the 6-digit code to verify and activate
4. Save the 8 recovery codes shown — these are your backup if you lose access to your app

Recovery codes — if you lose access to your authenticator app, use one of your saved recovery codes to sign in. Each code works once. You can generate new codes at any time from your Profile page.

Forgot password — click Forgot your password? on the sign-in page. Enter your email and a reset link will be sent to your inbox. The link expires after 24 hours.

Account lockout — after 5 consecutive failed login attempts, your account is locked for 10 minutes. This protects against brute force attacks.

Slot numbers — every preset must have a unique slot number per controller. The slot number matches the preset number on your WLED device. WLED preset slots start at 1.

Copying a preset — click Copy on any preset row. The copy is automatically assigned the next available slot number. You'll be taken directly to the edit page to rename it.

Preset history — every time you save or modify a preset, a snapshot is recorded. Click History on any preset to view the full change log. You can filter to show only modified versions or restore a preset to any previous version. Up to 20 history entries are kept per preset.

Deleted presets — when you delete a preset, a final snapshot is saved to its history before removal.

Each preset has an Active / Inactive status. Inactive presets are excluded from Push All Active and Export Active JSON, but you can still edit, preview, and export them individually.

Use this to keep work-in-progress presets out of your controller while you fine-tune them. Toggle status with one click in the Status column, or use All Active / All Inactive in the column header to bulk-switch.

The Backups page lets you save a point-in-time snapshot of all presets for a controller. Use it before making major changes or as a regular safety net.

Creating a backup — click Backups on your Dashboard, select a controller from the dropdown, and click Create Backup. All presets for that controller are saved instantly.

Viewing a backup — click View JSON on any backup row to see the full preset JSON in a modal. You can copy it to the clipboard from there.

Exporting a backup — click Export to download the backup as a presets.json file. You can load this directly into WLED via its web interface under Settings → Security → Restore presets.

Deleting a backup — click Delete on any row to remove it permanently.

Backup limit — up to 10 backups are kept per controller. When you create an 11th, the oldest is automatically removed.

Sync from WLED (recommended) — with the agent running, click Sync from WLED on the My Presets page. The agent fetches your controller's presets directly and imports them into wledpresets.com automatically.

Manual Import (JSON) — click Manual Import on your Dashboard. Paste the contents of a presets.json file into the text area and click Import. You can also drag and drop a JSON file directly onto the text area.

Overwrite existing — by default, slots that already exist in your library are skipped. Check Overwrite existing slots to replace them with the imported version instead.

The WLED Config page lets you view the full configuration of your WLED device directly from wledpresets.com. Click WLED Config on your Dashboard to open it.

Requirements — the WledAgent must be running on your PC and connected. Click Load Config from WLED to fetch the latest settings from your controller.

The page displays eight sections of information pulled live from your device:

• Device Info — firmware version, build, platform (ESP8266/ESP32), MAC address, LED count, effect & palette count, free heap, uptime, and WiFi signal strength
• LED Settings — LED count, segment length, max power, color order, GPIO pin, LED type, RGBW mode, and gamma correction
• Network — your configured address alongside the device's live IP, connected SSID, mDNS name, NTP server, timezone, and AP settings
• Boot Defaults — which preset loads on boot, default brightness, on/off state, transition speed, and nightlight settings
• Buttons & IR — button types and IR pin/type if configured
• Sync / Broadcast — UDP broadcast settings, Alexa, MQTT broker, and Hue sync
• Time & Schedule — NTP enabled, server, timezone, 24h clock, and location coordinates for sunrise/sunset effects
• Security — OTA update lock status and PIN configuration

This page is read-only — it shows your current device settings but does not modify them.

Push Preset (via agent) — sends a single preset to a specific slot on your WLED controller. Other presets on the controller are left untouched. Requires the agent to be running.

Push All Active (via agent) — uploads all active presets to your controller at once, replacing the full preset list. WLED reboots automatically to apply the changes. Inactive presets are excluded.

Sync from WLED (via agent) — pulls all presets from your controller into wledpresets.com. Existing presets with matching slot numbers are replaced.

Export (single) — downloads a .json file for one preset to your computer for manual import into WLED.

Export Active JSON — downloads a presets.json file containing all active presets for manual import via WLED's web interface. Use this if you don't have the agent running.

WLED lets you divide your LED strip into segments, each with its own effect, colors, and speed. This allows different effects to run on different parts of your strip simultaneously.

Start LED / Stop LED — the range of LEDs this segment controls. LED 0 is the first LED on your strip.

Grouping — how many consecutive LEDs light up together as one unit. Default is 1. Setting 3 means every 3 LEDs act as one.

Spacing — how many LEDs are dark after each group. Grouping=1, Spacing=4 means 1 LED on, 4 LEDs off, repeating.

The preview canvas respects your Start LED, Grouping, and Spacing settings so you can see the pattern before pushing.

This app is designed and tested against WLED 0.13 and newer. Check your controller's web UI to see your firmware version.

If you see an effect listed as Effect 92 instead of a name, your controller has a newer effect not yet in the app's list. It will still work correctly.

WledPresets is always being updated with new features and improvements. If you run into an issue or have a feature idea, submit a support ticket and we'll review it within 72 hours.

Submit a Support Ticket

I didn't receive my confirmation email.
Check your spam folder. If it's not there, go to the sign-in page and use the Resend Link option on the confirmation page.

I lost my authenticator app — how do I sign in?
Use one of your saved recovery codes on the 2FA screen. If you've lost those too, contact support.

Why does the preview look different from my actual WLED?
The preview is a simulation — it approximates how effects look but can't be pixel-perfect. Speed, palette blending, and hardware brightness correction will differ from the real thing.

The agent says "No IP configured for controller."
Go to Controllers on your Dashboard, click Set IP on your controller, and enter the IP address or hostname of your WLED device.

The agent connects but push times out.
Make sure your PC is on the same WiFi network as the WLED controller. The agent must be able to reach the device directly over your local network.

My presets pushed successfully but I don't see them on the controller.
After Push All Active, WLED reboots automatically to reload presets from flash. Wait a few seconds for it to come back online.

Can I run the agent on multiple PCs?
Only one agent can be connected per account at a time. If you start a second one, it will be rejected and shut down automatically.

I have more effects on my controller than shown in the dropdown.
WLED adds new effects with each release. Newer effects will still work — they just won't have a name in the dropdown yet.

Do I need the agent to use the site?
No — you can build, preview, and export presets without the agent. The agent is only required for Push and Sync features that communicate directly with your WLED device.