@gautric/node-red-zenbus

A Node-RED node that polls the Zenbus real-time API and outputs next bus ETA for a configured stop.

Built on the zenbus client library — no scraping, no browser.

Install

From your Node-RED user directory (typically ~/.node-red):

npm install @gautric/node-red-zenbus

Restart Node-RED and the zenbus node will appear in the palette under the transport category.

Configuration

| Property | Description | Required | |---|---|---| | Name | Display name for the node | no | | Alias | Network alias (e.g. gpso) | yes | | Itinerary | Itinerary ID | yes | | Stop | Stop ID | yes | | Interval | Poll interval in seconds (default: 10, minimum: 5) | no |

Output

The node sends a msg.payload object on each poll cycle:

| Property | Type | Description | |---|---|---| | payload.stop | string | Stop name | | payload.line | string | Line code | | payload.timestamp | string | ISO 8601 poll timestamp | | payload.now | string | Current time as HhMM | | payload.first | object | null | First bus info | | payload.first.eta | number | ETA in minutes | | payload.first.distance | number | Remaining distance in metres | | payload.first.estimatedArrival | string | Estimated arrival (ISO 8601) | | payload.first.scheduledTime | string | null | Scheduled time (ISO 8601) or null | | payload.first.isLive | boolean | true if live-tracked | | payload.next | object | null | Second bus (same shape as first) |

When a field is unavailable, it defaults to '-' (or false for isLive).

Node status

• 🟢 Green dot — live ETA with minutes and arrival time
• 🟡 Yellow dot — scheduled data (not live-tracked)
• 🟡 Yellow ring — initializing
• 🟢 Green ring — connected, waiting for first poll
• ⚪ Grey ring — no bus found
• 🔴 Red ring — error or init failure

Example flows

Ready-to-use examples are bundled with the package.

In Node-RED: Menu → Import → Examples → zenbus-next-bus

| Example | Stop | Line | File | |---|---|---|---| | debug-next-bus | default | default | examples/debug-next-bus.json | | debug-parchamp | Parchamp | SUBN | examples/debug-parchamp.json |

Finding your IDs

Open your stop on zenbus.net. The URL contains the values you need:

https://zenbus.net/publicapp/web/{alias}?line=...&stop={stop}&itinerary={itinerary}

Dependencies

| Package | Version | |---|---| | zenbus | ^2.1.0 |

License

MIT