WLED is an awesome project, as is OctoPrint. What could be better than a plugin linking the two?

This plugin allows you to configure a WLED device to connect to OctoPrint, and the LEDs can react to different events to display the status of your prints with ease!

Inspired by my other plugin, OctoPrint WS281x LED Status, it aims to provide a similar experience of high configurability with ease of use.

Current features:

  • Reacting to printer states including:
    • Idle
    • Disconnected
    • Print started
    • Print success
    • Print failed
    • Print paused
  • Tracking print progress
  • Highly configurable settings & and easy to use UI
  • … and more!

This project is under early development, please be patient as bugs are fixed and features are added!

For the most up to date information, be sure to check out the GitHub Repository



This plugin will only install on Python 3 systems. For a guide to upgrading (it’s easy!), please see my blog post on the OctoPrint blog for more details.

In addition, I can also only guarantee compatibility with OctoPrint 1.5.0 and newer. Older versions may not work as expected.


Install via the bundled Plugin Manager or manually using this URL:


Note: Do not try and install the plugin this way if it does not show up in the plugin manager - this likely means it is not compatible with your system!


Configuration can be performed in the OctoPrint UI, under Settings > WLED Integration.

More documentation and explanation is on the way!

Support My Efforts

I created this plugin in my spare time, for the community. If you have enjoyed using it, please consider supporting it’s development through GitHub sponsors. Monthly, one-time or a custom amount, you choose!


This plugin wouldn’t be possible without the great work from @frenck with the python-wled Python module that I was able to use. It has been slightly modified to work better within an OctoPrint plugin, but it is a great module to work with. Thank you!

View the OctoPrint-WLED license

View the python-wled license


WLED + OctoPrint
WLED Settings