A script which uses the published scotrail announcer voice to actually announce trains
Go to file
Evelyn 250c4a4a70 Add chimes support, add basic cancellation support (without reason) 2022-08-25 09:23:57 +01:00
audio Fix double inflection mistake on QUNPARK 2022-08-23 18:33:03 +01:00
chimes add chimes 2022-08-23 23:13:23 +01:00
.gitignore concede defeat with manifest gitignore 2022-08-25 00:48:10 +01:00
LICENCE.txt Licence 2022-08-23 15:17:46 +01:00
README.md Use CRS code, improve README 2022-08-23 15:23:49 +01:00
announce.py Add chimes support, add basic cancellation support (without reason) 2022-08-25 09:23:57 +01:00
requirements.txt Initial commit 2022-08-23 11:47:08 +01:00
sr_announcements_map_export.txt Fix double inflection mistake on QUNPARK 2022-08-23 18:33:03 +01:00


This project uses the recently published ScotRail announcements to narrate actual departures in real-time from the Scottish station of your choosing.

At the moment, all it announces are upcoming departures, and platform alterations.


I'm not going to publish the scripts I used to generate the mappings for sound files out of sheer shame, but please feel free to use the mappings I generated in your own projects, they're in sr_announcements_map_export.txt.

If you want a bit more insight into how this fits into data, you might want to read this post.

External dependencies

You'll need to install sox and aplay for this to work, you can likely find these in your distro's repos.


Clone the repository, cd into the directory, now create a virtual environment, activate it, and install suds from the requirements file.

python3 -m venv venv
source venv/bin/activate
pip3 install -r requirements.txt

You'll need to register for LDBSVWS, which you can do here. Take the security token and put it alone in a file called secret.txt.


Activate the virtual environment, if you have one, pick the CRS code for your station (e.g. EDB for Edinburgh), and run: ./announcer.py EDB


The software in this project is licensed under the MIT licence, see LICENCE.txt for more information.

It's not fully clear who holds the copyright to the audio files. It could be that it's Scotrail themselves, who set out the below conditions for the use of material released under their FOISA publication programme.

Where ScotRail Trains Limited holds the copyright in its published information,
the information may be copied or reproduced without formal permission, provided

- it is copied or reproduced accurately.
- it is not used in a misleading context, and
- the source of the material is identified.