73 lines
2.8 KiB
Markdown
73 lines
2.8 KiB
Markdown
travelynx - Railway Travel Logger
|
|
---
|
|
|
|
[travelynx](https://finalrewind.org/projects/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](https://finalrewind.org/projects/Travel-Status-DE-IRIS/).
|
|
|
|
Dependencies
|
|
---
|
|
|
|
* perl >= 5.10
|
|
* Cache::File (part of the Cache module)
|
|
* DBI
|
|
* DBD::Pg
|
|
* Geo::Distance
|
|
* Mojolicious
|
|
* Mojolicious::Plugin::Authentication
|
|
* 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 3 hours 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 click/tap on 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 or enter its
|
|
name or DS100 code manually.
|
|
|
|
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/s/*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.
|