Installation

Install using pip3:

pip3 install vvs

It goes without saying that you should install into a virtualenv.

Finding your station ID

Have a look in the stations.json file for the station that you want to monitor. Every station is paired with an ID, and you’ll need this when running vvs.

Please note that the stations.json file in this repo won’t be kept updated. If you can’t find your station ID, follow the instructions here.

Setting up the scraper

Now we’ve got our station ID, we’ll want to scrape data for that station. This can be achieved by using the vvs scrape command. We’ll then want to cache this data somewhere locally. So, if our station ID were 5007115 (Hulb), we’d set up a cronjob to do this every few minutes:

*/3 * * * * vvs scrape 5007115 > ~/.vvs.json

With this command, we’ll be tracking the departures of all public transport from Hulb - but in both directions. We just want departures heading in to town.

In order to filter for what we want, we first use the list_directions subcommand:

$ vvs list_directions 5007115
Herrenberg
Kirchheim (T)
Neckarpark
Plochingen
$

This is a list of all terminating stations for public transport passing through Hulb. Departures of the S-Bahn in the direction of Kirchheim an der Teck and Plochingen are the ones we’re after, so we’ll filter for them:

*/3 * * * * vvs scrape 5007115 --direction Plochingen --direction 'Kirchheim (T)' > ~/.vvs.json

Now we should be getting the data we’re after!

Displaying the data

The vvs display command is used to display the data we’ve saved. The style in which it displays the data can be customized:

$ vvs display ~/.vvs.json
In 7, 22, 37 min
$
$ vvs display --limit 10 ~/.vvs.json
In 6, 21, 36, 51, 66, 81, 96, 114, 144, 174 min
$
$ vvs display --limit 10 --format %H:%M ~/.vvs.json
19:25, 19:40, 19:55, 20:10, 20:25, 20:40, 20:55, 21:13, 21:43, 22:13
$

Python’s time formatting directives (link) are used for string formatting.

Locales

If you get an error that looks like this:

RuntimeError: Click will abort further execution because Python 3 was configured to use ASCII as encoding for the environment.

Make sure you have your locales set correctly (LC_ALL and LANG are exported). If that’s not possible, then set them temporarily when you invoke vvs, e.g.:

LC_ALL=en_US.utf-8 LANG=en_US.utf-8 vvs scrape 5007115