Skip to content
MMM-Skyss is a MagicMirror² module for displaying public transport information for Hordaland (Norway). It's using data from skyss.no.
JavaScript CSS
Branch: master
Clone or download
Pull request Compare This branch is 16 commits ahead of CatoAntonsen:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
images
translations
.gitignore
CHANGELOG.md
LICENSE
MMM-Skyss.js
README.md
node_helper.js
package.json
skyss.css

README.md

MagicMirror² Module: Skyss

'MMM-Skyss' is a module based on the Ruter equivalent made by Cato Antonsen for displaying public transport information for the Hordaland region in Norway on a MagicMirror². It's using data from Skyss.no. Skyss is a registered trademark of Hordaland County Councile (Hordaland Fylkeskommune) which is not affiliated with this product. Content from Skyss APIs may be copyrighted.

1 2

Current version is s1.3.0 See changelog for version history.

Installation

Remote to your MM2-box with your terminal software and go to your MagicMirror's Module folder:

cd ~/MagicMirror/modules

Clone the repository:

git clone https://github.com/PabloDons/MMM-Skyss.git

Go to the modules folder:

cd MMM-Skyss

Install the dependencies:

npm install

Add the module to the modules array in the config/config.js file by adding the following section. You can change this configuration later when you see this works:

{
	module: 'MMM-Skyss',
	header: 'Skyss',
	position: 'top_left',
	config: {
		showPlatform: true,
		maxItems: 8,
		stops: [
			{
				stopId: "12011092"
			},
			{
				stopId: "12011022"
			},
		]
	}
},

Configuration options

These are the valid configuration options you can put inside the config array above:

Configuration option Comment Default
stops Array of stops. See below Empty array
maxItems Number of journeys to display 5
showHeader Set this to true to show header above the journeys false
showStopName Display custom stop name for each stop. You can override the name by adding stopName to the stop you want to override (See below) false
maxNameLength Some stop names can be very long and ruin the layout of the module. Set this to how many characters you max want to display. Not set
showPlatform Set this to true to get the names of the platforms. Set this to true to check the name of the platform if you need to filter false
humanizeTimeTreshold If time to next journey is below this value, it will be displayed as "x minutes" instead of time 15
serviceReloadInterval Refresh rate in MS for how often we call Skyss's web service. NB! Don't set it too low! 30000
timeReloadInterval Refresh rate how often we check if we need to update the time in the GUI 1000
animationSpeed How fast the animation changes when updating mirror - in milliseconds 0
fade Set this to true to fade list from light to dark true
fadePoint Start fading on 1/4th of the list 0.25

Stops

You have to configure at least one stop. The module uses the same stop ID's used in the avgangsvisning mode on skyss' website. just go to this link and select the stops you want (different directions of the same stop each have their own stop). Fill out the rest of the form randomly so the website generates a url. In this url you'll find each stop as a data argument separated by commas. Example: https://avgangsvisning.skyss.no/board/#/?stops= 12011093,12011092,12011022,12011021 &viewFreq=10000&terminal=true&colors=dark&name=name

Stop option Comment
stopId Id of stop

Example:

stops: [
	{
		stopId: "12011092"
	},
	{
		stopId: "12011022"
	}
]

Translations

This modules is translated to the following languages:

Language Responsible
nb (Norwegian) Cato Antonsen
en (English) Cato Antonsen

If you add other languages, please make a PR or drop me a line!

Future enhanchements

  1. Generate a new auth token for each client
  2. Show deviations
  3. Add filter for platforms (Each platform has it's own stop now. Simply don't include it)
  4. Add filter for departures that are too close to make
You can’t perform that action at this time.