MMM-MyBMW

Magic Mirror Module to display data from MyBMW for your car(s).

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

If you own several BMW cars, you can configure a module for each of them. The module configuration requires the vin number of the car to separate multiple module instances.

The module is heavily based on MMM-BMWConnected by Howard Durdle and Janne Kalliola and uses bimmer_connected to query the MyBMW API.

Requirements

A working python 3 distribution with pip is required before the installation.

Installation

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

cd ~/MagicMirror/modules
git clone https://github.com/Jargendas/MMM-MyBMW.git
cd MMM-MyBMW
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 MyBMW email and password, and your car's VIN number.

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

    {
        module: "MMM-MyBMW",
        position: "top_right",
        config: {
            email: "email@example.com",
            password: "myComplexPassword",
            vin: "XXXXXXXXXXXXXXXXX"
        }
    },

Module configuration

The module has a few configuration options:

Option	Description
email	Your email for the MyBMW platform, required. Default: undefined
password	Your password for the MyBMW platform, required. Default: undefined
vin	Your car's VIN code, required. Default: undefined
region	Must be set to the region your car is operating in, required for the MyBMW API. Can be us, cn, or rest. Default: rest
refresh	How often to refresh the data in minutes. Be careful: BMW limits the amount of calls per account per day (to ~200 ?), so don't set this value too low. Default: 15
vehicleOpacity	The opacity of the car image. Default: 0.75 Between 0 and 1.
showMileage	Whether to show the mileage. Default: true
showElectricRange	Whether to show the electric range. Will be hidden automatically if electric range is zero (i.e. when car is not electric). Default: true
showElectricPercentage	Whether to show the battery charging also in percentages. Will be hidden automatically if electric range is zero (i.e. when car is not electric). Default: true
showFuelRange	Whether to show the fuel range. Will be hidden automatically if fuel range is zero (i.e. when car is electric). Default: true
showLastUpdated	Whether to show the info when the data was last updated. Default: true
lastUpdatedText	The text to be shown before the last updated timestamp. Default: last updated

Changelog

2024-03-12 Forked from MMM-BMWConnected and migrated to MyBMW via bimmer_connected.