Support

Questions or issues?

support@fallingdata.zone Or open an issue on GitHub

Frequently Asked Questions

My n8n webhook isn't working

The most common cause: your n8n workflow is in test mode, not activated. In n8n, workflows must be Active (toggle in the top right) for webhooks to respond to external requests. Test executions only work from within the n8n editor.

Field discovery shows no fields

Make sure your data source returns valid JSON. Test the URL in a browser or with curl to verify. If the endpoint requires authentication, use n8n as a proxy—the plugin makes unauthenticated requests.

How do I access array data?

Arrays are supported using index notation. For example, if your JSON has {"meters": [{"power": 48.5}]}, select meters.0.power from the field dropdown. The first element (index 0) is discovered automatically.

Color coding isn't working

Dynamic color coding requires a numeric field. The plugin can extract numbers from formatted strings (like "88°F" → 88), but the source field must contain a number. Make sure you've selected a numeric field for color coding, not a text field.

Button shows an error state

This usually means the data source is unreachable. Check that the URL is correct and accessible from your machine. The button will automatically retry on the next polling cycle. Press the button to force an immediate refresh.

How do I use this with authenticated APIs?

Use n8n as an authentication proxy. Create an n8n workflow with: Webhook Trigger → HTTP Request (with your API credentials) → Respond to Webhook. Point the plugin at your n8n webhook URL. n8n handles the authentication; the plugin just receives clean JSON.

Can I trigger actions when I press the button?

Yes. In the button configuration, enable the HTTP webhook action. You can send GET, POST, PUT, or DELETE requests to any URL when the button is pressed. Use template variables like {{timestamp}} and {{data}} in your JSON payload.

What's the minimum refresh interval?

10 seconds. The default is 30 seconds. You can set any value between 10 and 300 seconds. For real-time data, consider whether your data source can handle frequent polling.

Does this work with Stream Deck+?

Yes. The plugin works with all Stream Deck models running Stream Deck software version 6.5 or later, including Stream Deck+, Stream Deck XL, Stream Deck MK.2, and the original Stream Deck.