thomas-gt / transilien_next_trains Goto Github PK

Transilien Next Trains is a widget for the awesome Dashing (deprecated) or Smashing (active fork) projects.

It displays the next train departures and status for your favorite train station of Transilien, the main suburban railway network of Paris (around 400 train stations and 14 Lines). Optionaly you can filter trains by adding an Arrival Station to show only a specific journey. This widget relies on the SNCF Open Data Transilien API and has been tested succesfully for several stations on RER E, RER B, RER D and Paris Saint-Lazare lines.

Ask for a personal (free) API key and test access with it from Linux command line with curl :

$ curl http://api_username:[email protected]/gare/87758607/depart/87681007/

Add in your Gemfile :

gem 'nokogiri'

Then install it :

$ sudo bundle install

Directory tree should be like this :

.
|-- README.md
|-- CHANGELOG
|-- LICENSE
|-- assets
|   `-- images
|       `-- transilien_next_trains
|           |-- Logo_RER.svg
|           |-- Logo_RER_A.svg
|           |-- Logo_RER_B.svg
|           |-- Logo_RER_C.svg
|           |-- Logo_RER_D.svg
|           |-- Logo_RER_E.svg
|           |-- Logo_SNCF_Transilien.svg
|           |-- Logo_Transilien.svg
|           |-- Logo_Transilien_H.svg
|           |-- Logo_Transilien_J.svg
|           |-- Logo_Transilien_K.svg
|           |-- Logo_Transilien_L.svg
|           |-- Logo_Transilien_N.svg
|           |-- Logo_Transilien_P.svg
|           |-- Logo_Transilien_R.svg
|           `-- Logo_Transilien_U.svg
|-- dashboards
|   `-- transilien_next_trains.erb
|-- jobs
|   `-- transilien_next_trains.rb
`-- widgets
    `-- transilien_next_trains
        |-- transilien_next_trains.coffee
        |-- transilien_next_trains.html
        `-- transilien_next_trains.scss

Configure widget like this :

• Search the UIC code of your favorite station (look at "stations" variable) and set Departure_Station variable with it
• Optionally you can do the same for Arrival_Station to filter trains. If you want all trains from departure station let Arrival_Station=""
• Optionally you can change SCHEDULER refresh interval. Default is 60s (recommended). API allows up to 20 calls/minute but this is useless for a dashboard app. No need to overload API servers.

Optionally you can change the logo to match the relevant train line of your favorite station. Eg :

<img class="logo-line" src="/assets/transilien_next_trains/Logo_Transilien.svg" height="32" width="32">

to :

<img class="logo-line" src="/assets/transilien_next_trains/Logo_Transilien_P.svg" height="32" width="32">

A demo dashboard is included. If no options is set (token, HTTPS...) pointing browser on http://your_server:your_port/transilien_next_trains should display it after starting server.

To add widget put a HTML block like below and customize it, at least data-title, data-sizex and data-sizey values (see previous warning). IMPORTANT : Due to high number of information to show up this widget is optimized for 1920x1080 displays, so for a widget_base_dimensions = [370, 340] with data-sizex=2 and data-sizey=1.

<li data-row="1" data-col="1" data-sizex="2" data-sizey="1">
  <div data-id="transilien_next_trains" data-view="TransilienNextTrains" data-unordered="true" data-title="Next Train Departures from My Beautiful Station" data-moreinfo="(R)eal Time - (T)imeTable"></div>
  <i class="fa fa-train icon-background-transilien"></i>
</li>