Skip to content

cp2004/OctoPrint-WLED

Repository files navigation

OctoPrint WLED Integration

GitHub issues GitHub branch checks state GitHub release (latest SemVer) GitHub release installs (latest by date) GitHub Release Date GitHub Repo stars GitHub GitHub Sponsors

WLED is an awesome project, as is OctoPrint. What could be better than an OctoPrint plugin for connecting 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
  • Displaying printing, heating & cooling progress
  • Controlling the lights using @ commands
  • Highly configurable settings and an easy to use UI
  • ... and more!

Setup

Compatibility

This plugin will only install on Python 3 systems. For a guide to upgrading (it's easy!), please see my blog post (octoprint.org).

In addition, I can only guarantee compatibility with OctoPrint 1.5.0 and newer.

Install

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

https://github.com/cp2004/OctoPrint-WLED/releases/latest/download/release.zip

Warning about installing from source

If you install the plugin by downloading the source code from GitHub directly, it will not work.

This is because the frontend code is built as part of the release process. For details of building this see below.

Configuration

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

Sponsors

As well as 2 others supporting me regularly through GitHub Sponsors!

Supporting my efforts

GitHub Sponsors

I created this project in my spare time, and do my best to support the community with issues and help using it. If you have found this useful or enjoyed using it then please consider supporting it's development! ❤️. You can sponsor monthly or one time, for any amount you choose.

Check out my other plugins

You can see all of my published OctoPrint plugins on the OctoPrint Plugin Repository! Or, if you're feeling nosy and want to see what else I'm working on, check out my GitHub profile.

Credits

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