Skip to content

Quick start

Davide Perini edited this page Aug 2, 2024 · 95 revisions

What you don't need

  1. You don't need to be a developer
  2. You don't need to be an electrical engineer
  3. You don't need a lot of time to complete the job

What you need

  1. A Windows PC or Linux for the screen capture (macOS will be supported soon), captured images are sent to the LED strip that should be positioned behind the monitor.
  2. A cheap microcontroler, ESP8266 or ESP32 are the recommended ones.
  3. A WS2812B 5V RGB LED strip or a SK6812 5V RGBW LED strip
  4. A power supply for the LED strip
  5. [OPTIONAL] An MQTT Server or an Home Automation system ex: Home Assistant, OpenHAB, ecc.

Install Glow Worm Luciferin firmware on your microcontroller

ESP8266 and ESP32 are the preferred microcontrollers, they are cheap, they are extremely stable, and they have built in WiFi.

  • Please install the firmware using the web browser based installer or if you prefer, you can download the firmware from here and then use your favourite flash tool.
    FULL firmware version adds support for remote control and automatic updates, if you flash FULL version you MUST configure WiFi or Ethernet. With FULL firmware USB connection is optional.
    If you flash LIGHT firmware you MUST use a USB cable.
    NOTE: Driving LEDs via WiFi/Ethernet is faster than USB and it is the recommended method if WiFi signal strength is good or if you have a microcontroller that supports ethernet.

Connect the LED strip to your microcontroller

CIRCUITS Note: If you want to use the FULL firmware without using a USB cable you need to connect the 5V microcontroller's PIN to the power supply. If you have a low quality microcontroller, capacitor, resistance and logic level converter helps "stabilizing the circuit". WS2812B led strip is cheap and easy to use and it looks awesome, 5V is easy to manage with a microcontroller, buy a compatible power supply and you are set.

If you don't want to design your own PCB you may look at the compatible hardware section.

Install LED strip behind you monitor

  • This is an easy step, a little bit of double sided tape, easy to remove, easy to fix.
    NOTE: If you want to use the automatically generated configuration, your first LED should be positioned in the bottom half of your monitor. LED strip can be placed clockwise or anticlockwise.

Install Firefly Luciferin Java fast screen capture software on your PC

  • Please download and install Firefly Luciferin on your PC, you can download it from here
  • Once installed the software, start it and select the firmware type you previously installed (Full firmware or Light firmware).
  • enter the number of LEDs you are using in the LEDs config tab, the orientation of your LED strip and click Save,
    Luciferin will start an auto discover of your Glow Worm Luciferin device.

Luciferin

  • Bias lighting can be started by double clicking Firefly Luciferin tray icon.
  • You can continue reading the Wiki to discover more features configure Firefly Luciferin for FULL firmware.
    NOTE: By defaults Glow Worm Luciferin firmware is able drive 100 LED, once you start the Bias Light effect, Firefly Luciferin program the firmware with the number od LEDs you configured in the "LEDs config" tab.9

Want to use it as a lamp, control it remotely, apply special effects to the LED strip, connect it via Home Assistant or OpenHAB?

Clone this wiki locally