Skip to content
Magic Mirror Module to display data from BMW Connected drive for your car.
JavaScript CSS
Branch: master
Clone or download
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.
lib initial working version Jul 3, 2019
.gitignore
LICENSE
MMM-BMWConnected.css initial working version Jul 3, 2019
MMM-BMWConnected.js
README.md options to switch between miles and km Aug 7, 2019
debug.png options to switch between miles and km Aug 7, 2019
node_helper.js options to switch between miles and km Aug 7, 2019
package-lock.json initial working version Jul 3, 2019
package.json initial working version Jul 3, 2019
screenshot.png initial working version Jul 3, 2019

README.md

MMM-BMWConnected

Magic Mirror Module to display data from BMW Connected drive for your car.

Screenshot

The module displays icons to show lock, charging and battery status, electric and combined range, and total miles driven. It also shows the time the Connected Drive API last received data from the car.

Installation

Clone this repository in your modules folder, and install dependencies:

cd ~/MagicMirror/modules 
git clone https://github.com/hdurdle/MMM-BMWConnected.git
cd MMM-BMWConnected
npm install 

Configuration

Go to the MagicMirror/config directory and edit the config.js file. Add the module to your modules array in your config.js.

You'll need your BMW Connected Drive email and password.

Enter these details in the config.js for your MagicMirror installation:

    {
        module: "MMM-BMWConnected",
        header: 'BMW Connected',
        position: "top_right",
        config: {
            email: "email@example.com",
            password: "myComplexPassword"
        }
    },

Module configuration

The module has a few configuration options:

Option Description
email Your username or email for the BMW Connected Drive platform.

Default: undefined
password Your password for the BMW Connected Drive platform.

Default: undefined
apiBase The location of the base API URL for your region.

Default: www.bmw-connecteddrive.co.uk
refresh How often to refresh the data in minutes.

Default: 15
vehicleAngle The angle of rotation for the car image.

Default: 300
Between 0 and 350 in increments of 10.
distance The unit of distance used for mileage and range.

Default: miles
Can be: miles or km.

Notes

If possible the module will pull an image of your car from BMW's API. I only have one BMW, so can't test the placement/graphics of other vehicles. I'd love to see what it looks like if you try it. Tweet images to me at https://twitter.com/hdurdle

Help

If you have a moment, please set debug to true in the config and see what text appears in [ ] after the last updated time. I'm trying to see what the BMW API returns for countries that use KM instead of miles. I might be able to avoid making it a config option and pull it direct from the API. Tweet images and comments to me at https://twitter.com/hdurdle

Debug Screenshot

Also, if you can offer translations for the few bits of direct text ("last updated") for your language, let me know (along with where the placeholder should go in your language!).

Thanks

Hat tip to Nils Schneider for the library code for performing the BMW authentication dance.

You can’t perform that action at this time.