@gautric/node-red-zenbus 2.1.0
Real-time next bus ETA from Zenbus networks via direct API (protobuf)
@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 |
