The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

db-iris - Interface to the DeutscheBahn online departure monitor

SYNOPSIS

db-iris [-r] [-c classlist] [-d date] [-o output-flags] [-p platforms] [-t time] [-T typelist] [-v|-V via] station

VERSION

version 1.07

DESCRIPTION

db-iris is an interface to the DeutscheBahn departure monitor available at https://iris.noncd.db.de/wbt/js/index.html.

It requests all departures at station and lists them on stdout, similar to the big departure screens installed at most main stations. station can be either a DS100 station code (such as "EE") or a normal station name (such as "Essen Hbf" or "DO Universität"). If no exact match is found, db-iris will try to find station names containing station as a substring.

An exclamation mark (!) next to a platform indicates that it is not the scheduled one.

OPTIONS

-c, --class classlist

Comma-separated list of train classes to filter by. Using this option causes all trains whose class is not in classlist to be discarded.

Valid classes are:

    D    Non-DB train. Usually local transport
    F    "Fernverkehr", long-distance transport
    N    "Nahverkehr", local and regional transport
    S    S-Bahn, rather slow local/regional transport
-d, --date date

Request results for date in dd.mm. or dd.mm.YYYY format. Note that only slight (a few hours max) deviations from the current time are supported by the IRIS backend, larger ones will not return data.

-l, --lookahead int

Return only those results which are less than int minutes in the future. Defaults to 240 (4 hours).

Note that this is only an upper limit, not a guarantee to get every train with a departure in less than int minutes. This guarantee holds only for int below 120. However, any non-negative number is accepted for this option.

-o, --output outputtypes

For each result, output outputtypes in addition to the normal time, delay, line and destination information. outputtypes is a comma-separated list, this option may be repeated. Each output type has both a short and long form, so both -ot,d and --output=times,delay are valid.

Valid output types are:

a / additional

If a train's route deviates from its schedule: Print a list of additional (unscheduled) stops it will serve.

c / canceled

If a train's route deviates from its schedule: Print a list of canceled stops (scheduled stops which will not be served).

d / delay

If a train is delayed, show the most recent reason for this delay.

D / delays

List all delay reasons entered into the IRIS for each train, even if the particular train is on time by now.

f / fullroute

Show the entire route (both before and after station).

m / messages

List all messages (delay and qos) entered into the IRIS with timestamps.

q / qos

List all quality of service messages entered into the IRIS. These contain information like "Missing carriage" or "Broken air conditioning".

Note that some qos messages may supersede older ones. superseded messages are omitted, use the m / messages type to see those as well.

r / route

Show up to three stops between station and the train's destination.

R / replacements

For cancelled trains: Print their replacement train(s), if present. For unplanned trains: Print the train(s) they replace, if present.

t / times

Show both scheduled and expected arrival and departure times.

-p, --platforms platforms

Only show arrivals/departures at platforms (comma-separated list, option may be repeated). This applies to actual departures, not schedules.

-r, --realtime

Show estimated instead of scheduled time where available. Cannot be combined with --output=times.

-t, --time time

Request results for time in HH:MM or HH:MM:SS format. Note that only slight deviations (a few hours max) from the current time are supported by the IRIS backend, larger ones will not return data.

-T, --type typelist

Comma-separated list of train types to filter by. Using this option causes all arrivals/departures whose type is not in typelist to be discarded.

The following valid values are known:

    local transport:
    IRE  Inter-Regio Express (rare)
    RB   Regionalbahn (slower than RE)
    RE   Regional-Express
    S    S-Bahn

    regional/interregional transport:
    D    "Schnellzug" (generic fast train, rare)
    EC   Eurocity
    IC   Intercity
    IR   Inter-Regio (rare in Germany, mostly used in Switzerland)
    ICE  Intercity-Express
    THA  Thalys

Depending on the city and country, other types may be used as well. Examples include "ABR" / "NWB" (private trains included in the local transport tariff system), "HKX" (private train not included in any DB tariffs) and "SBB" (unknown swiss train class)

-v, --via viastation

Only show trains serving viastation after station. In this case, viastation must match the station as contained in the train's route (see -of), DS100 codes are not supported.

-V, --track-via viastation

Only show trains serving viastation after station. Show result timestamps as "HH:MM -> HH:MM +x", where the first time is the scheduled departure (without delay) at station and the second the scheduled arrival (also without delay) at viastation. If a delay is known, it will be indicated by +x.

Note that here, viastation must be a regular station name or DS100 code.

Caveat: Some trains change their identity along the route. For instance, the line RE11 line in NRW has two identifiers, one for Mönchengladbach <-> Duisburg and one for Duisburg <-> Hamm. track-via is not able to handle those and will miss trains changing their identifier between station and viastation

Sometimes, Deutsche Bahn splits up major stations in their IRIS interface. For instance, "Köln Messe/Deutz" actually consists of "Köln Messe/Deutz" (KKDZ), "Köln Messe/Deutz Gl. 9-10" (KKDZB) and "Köln Messe/Deutz (tief)" (KKDT).

By default, db-iris will show departures for all of these stations when queried for any of them. When this option is set, only the departures for the station part specified on the commandline are shown.

--version

Show version information.

EXIT STATUS

Zero unless things went wrong.

CONFIGURATION

None.

DEPENDENCIES

  • Class::Accessor(3pm)

  • DateTime(3pm)

  • LWP::UserAgent(3pm)

  • XML::LibXML(3pm)

BUGS AND LIMITATIONS

Unknown.

AUTHOR

Copyright (C) 2013-2015 by Daniel Friesel <derf@finalrewind.org>

LICENSE

This program is licensed under the same terms as Perl itself.