Skip to content

Compiling WLED

Aircoookie edited this page Nov 15, 2020 · 13 revisions

WLED has come to rely on so many dependencies in the latest versions that building with the Arduino IDE is no longer recommended. Instead, installing Visual Studio Code and its PlatformIO (PIO) extension is easier, as it will install the ESP Arduino core, all the required libraries and the correct compilation settings for you automatically.

Installation guide (PlatformIO)

  1. Download and install the free Visual Studio Code by Microsoft.
  2. Open VS Code and go to the Extensions manager (the icon with the stacked blocks in the left bar)
  3. Search for platformio ide and install the PlatformIO extension
  4. Go to File -> Open Folder and open the root WLED folder (the one that contains platformio.ini, NOT the wled00 folder)

Compilation guide (PlatformIO)

  1. In VS Code, open the file platformio.ini.
  2. Add a semicolon in front of the line that says default_envs = travis_esp8266, travis_esp32 to comment it out.
  3. Select your build environment by un-commenting one of the lines starting with ; default_envs =.
    Please remove BOTH the ; and the whitespace behind it to correctly uncomment the line.
    For most ESP8266 boards, the d1_mini environment is best.
  4. In the blue bottom bar, hit the checkmark to compile WLED or the arrow pointing right to compile and upload!

Success!

If you get one of these two errors, hit the checkmark icon once again to compile and that time the code should build without problems!

  • error: wled00\wled00.ino.cpp: No such file or directory
  • FileNotFoundError: [WinError 2] The system cannot find the file specified: '[...].sconsign37.dblite'
Clone this wiki locally