uk-trains

# UK Trains Query National Rail Darwin API for live train departures and arrivals. ## Setup Requires free Darwin API token: 1. Register at https://realtime.nationalrail.co.uk/OpenLDBWSRegistration/ 2. Set `NATIONAL_RAIL_TOKEN` in environment (or configure in skills.entries.uk-trains.apiKey) ## Commands ```bash # Departures ./scripts/trains.py departures PAD ./scripts/trains.py departures PAD to OXF --rows 5 # Arrivals ./scripts/trains.py arrivals MAN ./scripts/trains.py arrivals MAN from EUS # Station search ./scripts/trains.py search paddington ./scripts/trains.py search kings ``` ## Station Codes Use 3-letter CRS codes: - `PAD` = London Paddington - `EUS` = London Euston - `KGX` = London Kings Cross - `VIC` = London Victoria - `WAT` = London Waterloo - `MAN` = Manchester Piccadilly - `BHM` = Birmingham New Street - `EDB` = Edinburgh Waverley - `GLC` = Glasgow Central - `BRI` = Bristol Temple Meads - `LDS` = Leeds - `LIV` = Liverpool Lime Street - `RDG` = Reading - `OXF` = Oxford - `CBG` = Cambridge ## Response Format JSON with: - `locationName`, `crs` - Station info - `messages[]` - Service alerts - `trainServices[]` - List of trains: - `std`/`sta` - Scheduled departure/arrival time - `etd`/`eta` - Expected time ("On time", "Delayed", or actual time) - `platform` - Platform number - `operator` - Train operating company - `destination[].name` - Final destination - `isCancelled`, `cancelReason`, `delayReason` - Disruption info ## Message Template Use this compact format for WhatsApp/chat responses: ``` 🚂 {Origin} → {Destination} *{dep} → {arr}* │📍{platform} │ 🚃 {coaches} {status} *{dep} → {arr}* │📍{platform} │ 🚃 {coaches} {status} ``` ### Elements - **Header:** 🚂 emoji + origin → destination - **Time:** Bold, departure → arrival times - **Platform:** 📍 + number (or "TBC" if unknown) - **Coaches:** 🚃 + space + number - **Status:** - ✅ On time - ⚠️ Delayed (exp {time}) - ❌ Cancelled — {reason} - 🔄 Starts here ### Example ``` 🚂 Hemel Hempstead → Euston *20:18 → 20:55* │📍4 │ 🚃 4 ✅ On time *20:55 → 21:30* │📍4 │ 🚃 12 ✅ On time *21:11 → 21:41* │📍4 │ 🚃 8 ✅ On time ``` ### Getting Arrival Times To show arrival times, make two API calls: 1. `departures {origin} to {dest}` — get departure times + service IDs 2. `arrivals {dest} from {origin}` — get arrival times Match services by the numeric prefix in serviceID (e.g., `4748110HEMLHMP_` matches `4748110EUSTON__`). ### Notes - Separate each service with a blank line - Omit coaches if formation data unavailable - For delays, show expected time: `⚠️ Delayed (exp 20:35)`