GitPlanet

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

Created with love in Canada, visit hostnodejs.com today

Feel like to post an Ad? Learn Details
All Projects → fewieden → MMM-Fuel

fewieden / MMM-Fuel

Licence: MIT license
Gas Station price Module for MagicMirror²

Programming Languages

javascript
184084 projects - #8 most used programming language
Nunjucks
165 projects
CSS
56736 projects

Labels

magicmirrorfuelvoice-controlnswgas-stationtankerkoenigspritpreisrechner

Projects that are alternatives of or similar to MMM-Fuel

MMM-NFL
National Football League Module for MagicMirror²
Stars: ✭ 22 (-53.19%)
Mutual labels:  magicmirror, voice-control
MagicMirror-Module-Template
Template module for MagicMirror
Stars: ✭ 54 (+14.89%)
Mutual labels:  magicmirror
MMM-EARTH
A MagicMirror module to display real time pictures of Earth as it rotates - The sunlit side.
Stars: ✭ 48 (+2.13%)
Mutual labels:  magicmirror
voco
Privacy friendly voice control for the Candle Controller / WebThings Gateway
Stars: ✭ 18 (-61.7%)
Mutual labels:  voice-control
StatusBoard
Non-mirror setup using the MagicMirror Framework
Stars: ✭ 23 (-51.06%)
Mutual labels:  magicmirror
anycontrol
Voice control for your websites and applications
Stars: ✭ 53 (+12.77%)
Mutual labels:  voice-control
MMM-forecast-io
Forecast.io Module for MagicMirror
Stars: ✭ 58 (+23.4%)
Mutual labels:  magicmirror
addon-magicmirror
MagicMirror² - Home Assistant Community Add-ons
Stars: ✭ 40 (-14.89%)
Mutual labels:  magicmirror
tfrs
Transportation Fuels Reporting System
Stars: ✭ 21 (-55.32%)
Mutual labels:  fuel
ioBroker.tankerkoenig
Spritpreis Adapter für ioBroker
Stars: ✭ 29 (-38.3%)
Mutual labels:  tankerkoenig
CaravanPi
System for measuring and displaying various values in caravans and motor homes, including climate values, filling levels and levelling data. MagicMirror (https://magicmirror.builders/) is used for presentation. A circuit board design is available now
Stars: ✭ 14 (-70.21%)
Mutual labels:  magicmirror
idear
🎙️ Handsfree Audio Development Interface
Stars: ✭ 84 (+78.72%)
Mutual labels:  voice-control
MMM-ShipmentTracking
Shipment Tracking Module for MagicMirror²
Stars: ✭ 24 (-48.94%)
Mutual labels:  magicmirror
MMM-PublicTransportBerlin
MagicMirror module to display public transport in Berlin and Brandenburg with BVG Hafas data.
Stars: ✭ 37 (-21.28%)
Mutual labels:  magicmirror
libusbhsfs
USB Mass Storage Class Host + Filesystem Mounter static library for Nintendo Switch homebrew applications.
Stars: ✭ 81 (+72.34%)
Mutual labels:  nsw
MMM-MagicMover
MagicMirror² module to avoid screen burn-in
Stars: ✭ 21 (-55.32%)
Mutual labels:  magicmirror
MMM-mvgmunich
MagicMirror² Module to monitor public transport (U-bahn, tram, bus, S-Bahn) in Munich
Stars: ✭ 21 (-55.32%)
Mutual labels:  magicmirror
awesome-rhasspy
Carefully curated list of projects and resources for the voice assistant Rhasspy
Stars: ✭ 50 (+6.38%)
Mutual labels:  voice-control
react-native-spokestack
Spokestack: give your React Native app a voice interface!
Stars: ✭ 53 (+12.77%)
Mutual labels:  voice-control
WallberryTheme
Bringing the WallberryTheme to MagicMirror²
Stars: ✭ 94 (+100%)
Mutual labels:  magicmirror
View All Similar Projects ➔

GitHub license Build status Code Climate Known Vulnerabilities

MMM-Fuel

Gas Station Price Module for MagicMirror2

Examples

Dependencies

Installation

  • Clone this repo into ~/MagicMirror/modules directory.
  • Configure your ~/MagicMirror/config/config.js:
{
    module: "MMM-Fuel",
    position: "top_right",
    config: {
        api_key: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        lat: 52.518611,
        lng: 13.408333,
        types: ["diesel"],
        // all your config options, which are different than their default values
    }
}
  • Run command npm i --production in ~/MagicMirror/modules/MMM-Fuel directory.

Config Options

Option Default Description
provider "tankerkoenig" API provider (See full list below).
lat REQUIRED Decimal degrees latitude.
lng REQUIRED Decimal degrees longitude.
types ["diesel"] Fuel types in an array e.g. ["diesel", "e5"]. All valid types can be seen in the specific provider section below.
sortBy "diesel" Price sorting by which fuel type defined in config option types.
open false Display whether the gas station is open or not.
radius 5 Lookup Area for Gas Stations in km.
max 5 How many gas stations should be displayed.
map_api_key false Required to show the gas stations map with traffic layer. You can get it here and don't forget to activate maps api for javascript.
zoom 12 Zoom of the map. (Min 0, Max 18 depends on the area)
height 600 Height of the map in pixel.
width 600 Width of the map in pixel.
colored false Boolean to show the gas stations map colored or not.
shortenText false Integer of characters to be shown for name and address. Default shows all.
showAddress true Boolean to show the gas station's address.
showOpenOnly false Boolean to show only open gas stations or all.
showDistance true Boolean to show the distance to your specified position.
showBrand false Boolean to show the brand instead of the name.
iconHeader true Boolean to display the car icon in the header.
rotate true Boolean to enable/disable rotation between sort by price and distance.
rotateInterval 60000 (1 min) How fast the sorting should be switched between byPrice and byDistance.
updateInterval 900000 (15 mins) How often should the data be fetched. If your value is to small, you risk to get banned from the API provider. I suggest a minimum of 15mins
fade true Boolean to fade out the list of gas stations.

Global config

Option Default Description
locale undefined By default it is using your system settings. You can specify the locale in the global MagicMirror config. Possible values are for e.g.: 'en-US' or 'de-DE'.

To set a global config you have to set the value in your config.js file inside the MagicMirror project.

tankerkoenig (Germany only)

Read the Terms of Use carefully, especially the restrictions for smart mirrors, or your API access will be suspended.

Option Default Description
api_key REQUIRED Get an API key for free access to the data of tankerkoenig.de.
types ["diesel"] Valid options are diesel, e5 and e10.
radius 5 Valid range is 0-25. Set to 0 to disable. Not required if stationIds are provided.
showAddressCity true Boolean to show the gas station's city.
stationIds [] Optional array of fuel station ids to fetch instead of the radius. You can only specify a maximum of 10 and you can find the ids here. Using radius and station ids in parallel will result in more API calls. If you run into issues increase the updateInterval.
excludeStationIds [] Optional array of fuel station ids to exclude from the radius. This is useful e.g. if you got a non public or truck exclusive station in the radius. You can find the ids here.

spritpreisrechner (Austria only)

No API key required.

Option Default Description
provider "tankerkoenig" Make sure you set it to "spritpreisrechner".
types ["diesel"] Valid options are diesel, e5 and gas.
radius 5 Valid range not tested yet.
max 5 The API provider returns maximum of 5 valid datasets.
showAddressCity true Boolean to show the gas station's city.
showBrand false The API provider does not return brand information.

autoblog (USA only)

No API key required. The displayed distance is not based on your coordinates but on the zip code.

Option Default Description
provider "tankerkoenig" Make sure you set it to "autoblog".
zip REQUIRED The zip code of your address, e.g. "12345"
types ["diesel"] Valid options are regular, mid-grade, premium and diesel.
radius 5 Valid range not tested yet.
lat undefined Not supported
lng undefined Not supported
open false Not supported
showOpenOnly false Not supported
showBrand false Not supported

gasbuddy (USA and Canada only)

No API key required. The displayed distance is not based on your coordinates but on the zip code.

Option Default Description
provider "tankerkoenig" Make sure you set it to "gasbuddy".
zip REQUIRED The zip code of your address, e.g. "12345"
types ["regular"] Valid options are regular, midgrade, premium, diesel, e85, and unl88.
showDistance false Not supported
radius 5 Not supported
lat undefined Not supported
lng undefined Not supported
open false Not supported
showOpenOnly false Not supported
showBrand false Not supported

nsw (Australia NSW and TAS only)

This provider gives no information if the gas stations are open or closed. Config options should be set accordingly open: false and showOpenOnly: false.

Option Default Description
api_key REQUIRED Get an API key for free access to the data of api.nsw.
provider "tankerkoenig" Make sure you set it to "nsw".
secret REQUIRED You also need to add the secret visible in your dashboard on api.nsw.
types ["diesel"] Valid options are diesel, e5.
radius 5 Valid range not tested yet.

OPTIONAL: Voice Control and Modal

This module supports voice control by MMM-voice and MMM-Modal. In order to use this feature, it's required to install the voice and modal modules. There are no extra config options for voice control and modals needed.

Mode

The voice control mode for this module is FUEL

List of all Voice Commands

  • OPEN HELP -> Shows the information from the readme here with mode and all commands.
  • CLOSE HELP -> Hides the help information.
  • SHOW GAS STATIONS MAP -> Shows a map with the gas stations labeled by Price starting with 1.
  • HIDE GAS STATIONS MAP -> Hide the map.

Developer

  • npm run lint - Lints JS and CSS files.
  • npm run docs - Generates documentation.

API Provider Development

If you want to add another API provider checkout the Guide.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].