WLED/readme.md

86 lines
4.6 KiB
Markdown
Raw Normal View History

2020-06-07 14:50:25 +02:00
<p align="center">
2020-08-31 17:03:07 +02:00
<img src="/images/wled_logo_akemi.png">
2020-06-07 14:50:25 +02:00
<a href="https://github.com/Aircoookie/WLED/releases"><img src="https://img.shields.io/github/release/Aircoookie/WLED.svg?style=flat-square"></a>
2020-09-29 00:08:12 +02:00
<a href="https://raw.githubusercontent.com/Aircoookie/WLED/master/LICENSE"><img src="https://img.shields.io/github/license/Aircoookie/wled?color=blue&style=flat-square"></a>
2020-06-07 14:50:25 +02:00
<a href="https://wled.discourse.group"><img src="https://img.shields.io/discourse/topics?colorB=blue&label=forum&server=https%3A%2F%2Fwled.discourse.group%2F&style=flat-square"></a>
<a href="https://discord.gg/KuqP7NE"><img src="https://img.shields.io/discord/473448917040758787.svg?colorB=blue&label=discord&style=flat-square"></a>
<a href="https://kno.wled.ge"><img src="https://img.shields.io/badge/quick_start-wiki-blue.svg?style=flat-square"></a>
2020-06-07 14:50:25 +02:00
<a href="https://github.com/Aircoookie/WLED-App"><img src="https://img.shields.io/badge/app-wled-blue.svg?style=flat-square"></a>
2020-11-18 00:54:41 +01:00
<a href="https://gitpod.io/#https://github.com/Aircoookie/WLED"><img src="https://img.shields.io/badge/Gitpod-ready--to--code-blue?style=flat-square&logo=gitpod"></a>
2020-09-29 00:08:12 +02:00
2020-06-07 14:50:25 +02:00
</p>
2021-08-18 22:21:31 +02:00
# Welcome to my project WLED! ✨
2020-11-09 20:14:24 +01:00
A fast and feature-rich implementation of an ESP8266/ESP32 webserver to control NeoPixel (WS2812B, WS2811, SK6812) LEDs or also SPI based chipsets like the WS2801 and APA102!
2016-09-11 23:07:18 +02:00
## ⚙️ Features
- WS2812FX library with more than 100 special effects
2020-02-25 02:25:17 +01:00
- FastLED noise effects and 50 palettes
2019-12-13 01:31:48 +01:00
- Modern UI with color, effect and segment controls
- Segments to set different effects and colors to user defined parts of the LED string
- Settings page - configuration via the network
2019-08-31 01:41:25 +02:00
- Access Point and station mode - automatic failsafe AP
2021-04-03 00:15:28 +02:00
- Up to 10 LED outputs per instance
2019-08-31 01:41:25 +02:00
- Support for RGBW strips
- Up to 250 user presets to save and load colors/effects easily, supports cycling through them.
- Presets can be used to automatically execute API calls
2019-08-31 01:41:25 +02:00
- Nightlight function (gradually dims down)
- Full OTA software updatability (HTTP + ArduinoOTA), password protectable
- Configurable analog clock (Cronixie, 7-segment and EleksTube IPS clock support via usermods)
- Configurable Auto Brightness limit for safe operation
- Filesystem-based config for easier backup of presets and settings
2018-10-04 23:16:25 +02:00
## 💡 Supported light control interfaces
- WLED app for [Android](https://play.google.com/store/apps/details?id=com.aircoookie.WLED) and [iOS](https://apps.apple.com/us/app/wled/id1475695033)
2019-08-31 01:41:25 +02:00
- JSON and HTTP request APIs
- MQTT
- Blynk IoT
- E1.31, Art-Net, DDP and TPM2.net
- [diyHue](https://github.com/diyhue/diyHue) (Wled is supported by diyHue, including Hue Sync Entertainment under udp. Thanks to [Gregory Mallios](https://github.com/gmallios))
- [Hyperion](https://github.com/hyperion-project/hyperion.ng)
2019-08-31 01:41:25 +02:00
- UDP realtime
- Alexa voice control (including dimming and color)
- Sync to Philips hue lights
2020-08-31 17:03:07 +02:00
- Adalight (PC ambilight via serial) and TPM2
2019-08-31 01:41:25 +02:00
- Sync color of multiple WLED devices (UDP notifier)
- Infrared remotes (24-key RGB, receiver required)
- Simple timers/schedules (time from NTP, timezones/DST supported)
## 📲 Quick start guide and documentation
See the [documentation on our official site](https://kno.wled.ge)!
[On this page](https://kno.wled.ge/basics/tutorials/) you can find excellent tutorials and tools to help you get your new project up and running!
2020-03-21 00:57:54 +01:00
2022-02-21 22:26:35 +01:00
## 🖼️ User interface
<img src="/images/macbook-pro-space-gray-on-the-wooden-table.jpg" width="50%"><img src="/images/walking-with-iphone-x.jpg" width="50%">
2022-02-21 22:26:35 +01:00
## 💾 Compatible hardware
2022-02-21 22:26:35 +01:00
See [here](https://kno.wled.ge/basics/compatible-hardware)!
## ✌️ Other
Licensed under the MIT license
2021-11-22 22:23:51 +01:00
Credits [here](https://kno.wled.ge/about/contributors/)!
Join the Discord server to discuss everything about WLED!
<a href="https://discord.gg/KuqP7NE"><img src="https://discordapp.com/api/guilds/473448917040758787/widget.png?style=banner2" width="25%"></a>
2020-02-04 17:43:46 +01:00
Check out the WLED [Discourse forum](https://wled.discourse.group)!
You can also send me mails to [dev.aircoookie@gmail.com](mailto:dev.aircoookie@gmail.com), but please, only do so if you want to talk to me privately.
If WLED really brightens up your day, you can [![](https://img.shields.io/badge/send%20me%20a%20small%20gift-paypal-blue.svg?style=flat-square)](https://paypal.me/aircoookie)
2019-11-18 20:43:27 +01:00
2019-11-18 20:43:27 +01:00
*Disclaimer:*
If you are prone to photosensitive epilepsy, we recommended you do **not** use this software.
If you still want to try, don't use strobe, lighting or noise modes or high effect speed settings.
As per the MIT license, I assume no liability for any damage to you or any other person or equipment.
2019-11-18 20:43:27 +01:00