next-trains 1.0.0

An imagining of a combined Arrivals and Departure board.

Next Trains

An imagining of a combined Arrivals and Departure board.

My wee one loves trains - obviously - so any time we can swing past the local station and see some is worth the detour. This is a simple web app that calls a Rail Data Marketplace API; getting the next few arrivals and departures to help us schedule a visit. I then spruce it up a bit with a fun font to make it look more like a real Departures board.

Installing

$ pip install next-trains

$ cat <<EOF >.env
RAIL_DATA_API_KEY={{ paste your API key here }}
DEFAULT_CRS={{ paste your home station's CRS here }}
EOF

Running

$ trains

Development

$ pip install -e .[dev]

$ ./lint-and-test
$ ./build-and-upload

Credits

The data is from Live Arrival and Departure Boards - Staff Version by Rail Delivery Group under an open licence.

The fonts are London TFL Dot Matrix Typeface by Sean Petykowski under SIL Open Font License.

License

Next Trains - An imagining of a combined Arrivals and Departure board.

Copyright (C) 2025-2026 Mike Coats

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.