💡
WS281x LED Status
Github RepositoryPlugin ListingSponsor
0.8.x
0.8.x
  • Home of the docs
  • Guides
    • Setup Guide
      • Supported Hardware
      • Wiring your LEDs
      • SPI Setup
      • Initial Configuration
    • Setup in Docker
    • OctoLapse Timelapse Flash
    • Get Help Guide
  • Configuration
    • LED Strip Configuration
    • Printing Effects
    • Progress Effects
    • Features
    • Custom Triggers
  • 3rd Party Apps and Integrations
  • Utilities
  • Troubleshooting Guide
  • Documentation
    • Host @ Commands
    • M150 Intercept
    • REST API
Powered by GitBook
On this page
  • Custom @ commands
  • Custom Events
  • Custom Gcode Effects
  • Gcode Match
  • Exact Match
  • Regex Match

Was this helpful?

Edit on GitHub
Export as PDF
  1. Configuration

Custom Triggers

Customise how the plugin reacts to events, gcode commands, or your own host @ commands

PreviousFeaturesNext3rd Party Apps and Integrations

Last updated 3 years ago

Was this helpful?

This feature took more effort than most to develop, if you've enjoyed using it please consider

Custom @ commands

The simplest custom trigger, a custom @ command. All commands are prefixed as such:@WS custom <command> to make sure they do not conflict with others.

You can define your own custom effect to run when this @ command is received.

Custom Events

You can setup the plugin to react to any event you choose for it. For a list of OctoPrint's events, please . 3rd party plugins will add their own events, which should appear in the list to select them.

Like above, you can then add a custom effect that will be triggered whenever this event is received.

Custom Gcode Effects

There's 3 types of triggers here, that you can use.

Gcode Match

Match just the G or M code. For example, if you enter G28, the plugin will match G28 X Y, or G28 Z as well. Or if you enter G29 it will match G29 T as well.

Exact Match

This will match the entire line sent to the printer. If you just want an effect when homing Z, you could enter G28 Z here. The whole line needs to be exactly the same for this effect to trigger.

Regex Match

Here you can enter a valid regex to run against the lines received from the printer. For example, G[0-9]+ would match any G command sent to the printer. You could use M50[0-3] to match any of the EEPROM management commands, M500, M501, M502 or M503.

Performance Warning

Adding many regex matches here could (more likely will) slow down the communication to the printer. Running a list of regexes against every line sent to the printer is not impact free. If you notice slowdowns, remove the entries here.

supporting development of the plugin.
see it's documentation
Screenshot of the settings page