Skip to content
MagicMirror module that displays bike availability in the Budapest public bike system (aka MOL Bubi).
JavaScript CSS
Branch: master
Clone or download
Latest commit d1b687e Jul 31, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc ADDED: Support to display the data for multiple Bubi station. Version… Aug 9, 2018
.editorconfig
.eslintrc.json ADDED: First version of the code. Aug 8, 2018
.gitignore
.stylelintrc ADDED: First version of the code. Aug 8, 2018
CHANGELOG.md UPDATED: All dependencies are updated to the latest version. Fixed lo… Jul 31, 2019
Gruntfile.js UPDATED: All dependencies are updated to the latest version. Fixed lo… Jul 31, 2019
LICENSE Initial commit Aug 8, 2018
MMM-Bubi.css
MMM-Bubi.js FIXED: The module clears the previous data when updated. Aug 9, 2018
README.md ADDED: Support to display the data for multiple Bubi station. Version… Aug 9, 2018
package-lock.json UPDATED: All dependencies are updated to the latest version. Fixed lo… Jul 31, 2019
package.json UPDATED: All dependencies are updated to the latest version. Fixed lo… Jul 31, 2019

README.md

MMM-Bubi

This is a module for the MagicMirror² to display the number of available bikes on the selected stations of the Budapest public bike system (aka MOL Bubi).

Features

By default this module displays the number of available bikes and the official names of the specified stations:

Default

You can configure the module to display a custom (typically shorter) names for the stations:

With custom station names

If you wish, you can completely remove the station names:

With hidden station names

For updates, please check the CHANGELOG.

Using the module

To use this module follow these steps:

  1. Clone this repository to the modules folder of your MagicMirror:
git clone https://github.com/balassy/MMM-Bubi.git
  1. Add the following configuration block to the modules array in the config/config.js file:
var config = {
  modules: [
    {
      module: 'MMM-Bubi',
      position: 'top_right',
      config: {
        updateInterval: 600000, // 10 minutes in milliseconds
        showPlaceName: true,
        align: 'left',
        places: [
          { id: 1758935, name: 'MOMKult' },
          { id: 1758923, name: 'MOM Park' },
          { id: 366538,  name: 'BAH csomópont' }
        ]
      }
    }
  ]
}

Configuration options

Option Description
places REQUIRED The list of Bubi stations to display. The unique id of the station is used to lookup the data from the webservice. The name is optional, and can be used to display a custom name for the station instead of the official name if the showPlaceName option is set to true.

Type: Array<{ id: number, name: string }>
Default value: 3 preconfigured stations
showPlaceName Optional Specifies whether the module should display not only the number of available bikes for each station, but also the names of the stations. If the name property is set in the places array, then it will be displayed, otherwise the official names of the stations will be rendered onto the Mirror.

Type: boolean
Default value: true
align Optional Determines how the text is aligned within the module. Set this to left if the module is displayed on left side of the mirror, or to right if you positioned this module to the right column of the mirror.

Type: string
Possible values: 'left' or 'right'
Default value: 'left'
updateInterval Optional The frequency of how often the module should query the number of available bikes from the webservice.

Type: int (milliseconds)
Default value: 600000 milliseconds (10 minutes)

How to get the place ID

In the id property of the objects in the places array of the configuration settings you have to specify the unique identifier of the station for which the module should display the bike availability.

To obtain the unique identifier of the station, follow these steps:

  1. Navigate to the MOL Bubi homepage with your favorite webbrowser.

  2. Use the map on the page to find your favorite MOL Bubi station and click its icon.

  3. Note the official name of the station, e.g. 1201-BAH csomópont.

  4. Navigate to the https://bubi.nextbike.net/maps/nextbike-live.xml?&domains=mb URL and use the browser's find function (CTRL+F) to locate the place by its name.

Locate the station by its name

  1. Find the uid attribute in the same row, it is the unique identifier of the station.

How it works

This module periodically sends requests from the browser window of the MagicMirror Electron application to the public NextBike API. The NextBike API is free, and it does NOT require any login or API key.

You can see an XML example by visiting this URL: https://bubi.nextbike.net/maps/nextbike-live.xml?&domains=mb

Contribution

Although for operation this module does not depend on any other module, if you would like to contribute to the codebase, please use the preconfigured linters to analyze the source code before sending a pull request. To run the linters follow these steps:

  1. Install developer dependencies:
npm install
  1. Install Grunt:
npm install -g grunt
  1. Use Grunt to run all linters:
grunt

Got feedback?

Your feedback is more than welcome, please send your suggestions, feature requests or bug reports as Github issues.

Acknowledments

Many thanks to Michael Teeuw for creating and maintaining the MagicMirror² project fully open source.

About the author

This project is created and maintaned by György Balássy.

You can’t perform that action at this time.