travelynx/README.md

76 lines
2.9 KiB
Markdown
Raw Normal View History

2019-02-16 16:28:01 +00:00
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::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.