Skip to content

Commit

Permalink
Update readme.md
Browse files Browse the repository at this point in the history
  • Loading branch information
claudiosv authored Apr 5, 2022
1 parent 3fc5f57 commit 119a403
Showing 1 changed file with 18 additions and 2 deletions.
20 changes: 18 additions & 2 deletions readme.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,12 @@
# Welcome to TechnoGecko WLED! ✨

A fast and feature-rich implementation of an ESP32 webserver to control WS2812B LEDs.
A fast and feature-rich implementation of an ESP32 webserver to control WS2812B LEDs. This repo has two branches:
`main` which tracks upstream Aircookie's main branch (their dev branch)
`soundreactive-dev` which tracks upstream atuline's development branch

SoundReactive forked off from WLED quite a while ago, and does not really track upstream very closely. As a result, the featureset has diverged. However, there is a good reason to use the SoundReactive fork: it has pretty much every feature we care about from WLED, and most importantly it supports *matrices*. Standard WLED has no concept of a 2D effect, only 1D effects. For example, with 2D effects you can have flames rising from the bottom of the vest. 1D effects can't do that. However, TechnoGecko vests, while being a single strand in software, are arranged in hardware to look like a matrix. The original unisparks/tgvest software is written with 2D effects only. The second reason to use the SoundReactive fork, is that if you hook up a microphone to your vest, it can produce sound reactive effects *locally*, on device, *without* network. This is impressive considering how much processing power near-realtime audio processing requires.

With this in mind, I will try and keep my branch synced with upstream and release builds from both branches, so you can decide whether having the latest WLED features is more important than having matrix and local sound reactivity (which none of the vests do) support.

## ⚙️ Features
- WS2812FX library integrated for over 100 special effects
Expand All @@ -16,7 +22,17 @@ A fast and feature-rich implementation of an ESP32 webserver to control WS2812B
- Nightlight function (gradually dims down)
- Full OTA software updatability (HTTP + ArduinoOTA), password protectable
- Configurable Auto Brightness limit for safer operation
- Filesystem-based config for easier backup of presets and settings
- Filesystem-based config for easier backup of presets and settings

### If using `soundreactive-dev` branch:
- Audio input from several sources including MAX4466, MAX9814, MAX9184, INMP401, INMP441 (for ESP32) and line-in.
- Volume reactive visual effects for ESP32 devices.
- Frequency reactive visual effects for ESP32 devices.
- UDP sound synchronization with transmit and receive for ESP32 (ESP8266 is supported upstream on `ESP8266` branch).
- 2D visual effects for ESP32 devices.
- Squelch and gain settings for ESP8266 and ESP32 devices for the volume reactive visual effects.
- 2D settings for ESP32 devices.
- Frequency reactive sliders for ESP32 devices.

## 💡 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)
Expand Down

0 comments on commit 119a403

Please sign in to comment.