No description
Find a file
2019-03-09 08:30:18 +01:00
examples Add README 2019-02-16 17:28:01 +01:00
public/static show hint in case of geolocation error 2019-03-08 19:40:57 +01:00
templates registration form: note that user name must be alphanumeric 2019-03-09 08:30:18 +01:00
index.pl fix timeout on unauthenticated access to account-specific pages 2019-03-09 00:13:51 +01:00
migrate.pl bump DB schema to v2 2019-03-06 18:11:26 +01:00
README.md Add README 2019-02-16 17:28:01 +01:00

travelynx - Railway Travel Logger

travelynx allows checking into and out of individual trains, thus providing a log of your railway journeys annotated with real-time delays and service messages. At the moment, it only supports german railways and trains which are exposed by the Deutsche Bahn IRIS Interface.

Dependencies

  • perl >= 5.10
  • Cache::File (part of the Cache module)
  • DBI
  • DBD::SQLite
  • Geo::Distance
  • Mojolicious
  • Travel::Status::DE::IRIS

Setup

TODO

Usage

For the sake of this manual, we will assume your travelynx instance is running on travelynx.de

travelynx journey logging is based on checkin and checkout actions: You check into a train when boarding it, and check out again when leaving it. Real-time data is saved on both occasions, providing an accurate overview of both scheduled and actual journey times.

Checking in

You can check into a train up to 10 minutes before its scheduled departure and up to 60 minutes after its actual departure (including delays). I recommend doing so when it arrives at the station or shortly after boarding.

First, you need to select the station you want to check in from. Navigate to travelynx.de or use the travelynx text in the navigation bar. You will see a list of the five stations closest to your current location (as reported by your browser). Select the station you're at.

If it is not in the list, you can also directly go do "travelynx.de/station name", e.g. "travelynx.de/Essen Hbf" or "travelynx.de/EE". Both names and DS100 codes are supported.

Now, as soon as you select a train, you will be checked in and travelynx will switch to the journey / checkout view.

Checking out

You can check out of a train up to 10 minutes before its scheduled arrival and up to 3 hours after its actual arrival. This ensures that accurate real-time data for your arrival is available. I recommend checking out when arriving at your destination or shortly after having left the train.

Once checked in, travelynx.de will show a list of all upcoming stops. Select one to check out there. You can also check out at a specific station by navigating to "travelynx.de/station name" and selecting "Hier auschecken".

If you forgot to check out in time, or are departing the train at a station which is not part of its documented route (and also not part of its documented route deviations), or are encountering issues with travelynx' real-time data fetcher, the checkout action will fail with an error message along the lines of "no real-time data available" or "train not found".

If you use the checkout link again, travelynx will perform a force checkout: it will log that you have left the train at the specified station, but omit arrival time, delay, and other real-time data. At the moment, this data cannot be specified manually.