v1.21.2

⚠️ NOTE: Any previously stored API refresh tokens will no longer function, as Tesla has deprecated the existing authentication endpoint. Existing access tokens will continue to work until they expire. Eventually, a full login will be needed to obtain new refresh tokens.

To immediately obtain new tokens after upgrading, go to the TeslaMate settings page, sign out via the button at the bottom of the page and then sign in again.

⚠️ NOTE: This release changes TeslaMate's base Docker image to Debian. If you have any customizations on top of TeslaMate (like healthchecks), they could need updates to work on top of this new image.

Enhancements

• Use the new Tesla authentication endpoint for refreshing access tokens
• Drop support for the /oauth/token endpoint
• Add a sign-out button at the bottom of the settings page

Translations

• Add Turkish Language Support (#1194 by neocorp)

Dashboards

• Display average outside temperature in charges dashboard (#1213 by DrMichael)

v1.21.1

Enhancements

Translations

• Add Finnish translation (#1190 by puppee)

Documentation

• Add some documentation about updating TeslaMate when installed with Docker (#1170 by fatbasstard)
• Update "Import from tesla-apiscraper" documentation: Give an example how to get the vehicle_id from TeslaMate (#1174 by Bdot42)
• Add link to unofficial Home Assistant addon (#1188 by matt-FFFFFF)

Other

• Allow to use non-standard MQTT ports (via MQTT_PORT)
• Refactoring: Use built-in Ecto enum type
• Guard against unexpected MFA errors

Bug Fixes

• Update drive duration query to avoid displaying different times for drives (Details vs Overview) (#1191 by fatbasstard)
• Fix font colors for light theme (Updates dashboard) (#1169 by fatbasstard)
• Fix typo (Statistics dashboard) (#1185 by rogiervandergeer)

v1.21.0

Enhancements

Dashboards

• Drive Details: Add button to download a drive as GPX file (#993 by ayonix)
• New dashboard for reporting to Dutch tax (#998 and #1051 by roadrash2108)
• Locations: Add panel to see when an address was last visited
• Charges/Drives: Add more filtering capabilities (#1016 by Kosta-Github)
• Overview: Fix unit of measurement for charge energy added (#1061 by landler)
• Charge Level: Add green bars (20/80%) to match "Charge Delta" graph (#1059 by roadrash2108)
• Charging-Stats/Trip: Change colors of AC/DC (#1058 by roadrash2108)
• Statistics: Resolve issue with month groupings (#1082 by leewillis77)
• Updates: Apply number of charges and average rated range to the correct update (#1147 by tlj)

Other

• Add support for Tesla’s new authentication process (two-factor authentication)
• Optimize TeslaFi CSV file import: reduced memory usage and increased performance
• Require Elixir v1.11
• Allow to connect to Postgres via IPv6 (via DATABASE_IPV6)
• Allow to connect to MQTT broker via IPv6 (via MQTT_IPV6)
• Improve detection of whether the vehicle is plugged in during cold weather (+ fix #1154 by virtualm2000)
• Use connection pooling for SRTM downloads
• Optimize Docker layer caching to speed up image build times
• Battery level tooltip: Prevent division by zero error if car is totally down to 0%
• Display the actual error if the import directory is not accessible

Translations

• Add Italian translation (#1095 and #1096 by HavanaMan)

Documentation

• Fix version info on development guide & minor spelling fix (#994 by techgaun)
• Update backup_restore.md (#1027 by pihomeserver)
• Improve garage door automation example (#1039 by andrewfoster)
• Update traefik guide to use a single public hostname instead of two (#1101 by pmboothby)
• Projects using TeslaMate:
  • TeslaMateAgile: mention Tibber support (#1097 by tobiasehlert)
  • Add TeslaMate_Telegram_Bot (#1122 by JakobLichterfeld)
• Update installation instructions for Apache (#1124 by juankymoral)

v1.20.1

Enhancements

Dashboards

• Charge Level: Always show 0% and 100% when state of charge is shown in a diagram (#980 by mbertheau)
• Charging Stats: Titles/labels now match pie-charts (#998 by roadrash2108)
• Drive Details: Increase width of odometer panel
• Efficiency: Set a fixed max value and use LCD gauge
• Statistics: Add links to other dashboards (#973 by DrMichael)

Translations

• Update Norwegian translation (#996 and #1007 by spacecosmos)
• Update Swedish translation (#1029 by tobiasehlert)

Other

• Display update version in the homescreen update tooltip (#976 by ayonix)
• Customize Grafana home screen logo (#1004 by gimmespam)
• Bump Grafana to 7.2.1

Bug Fixes

• Overview: Fix overlapping timestamps in discrete map (#995 by pmboothby)
• Fix overlapping timestamps in trip and states dashboard
• Fix tooltips in car overview being hidden by .card (#975 by ayonix)
• Make Statistics dashboard compatible with older versions of Postgres
• Open Statistics dashboard with browser time zone when coming from the TeslaMate UI

v1.20.0

Enhancements

Dashboards

• Update consumption unit to Watt-hour to match in-car unit (#717 by mattw01)
• Update dashboards to use the new components from Grafana 7
• Charges: Show very short charging sessions
• Charges: Add filter for voltage (#857 by Dulanic)
• Charging Details: Show kWh even if still charging (#744 by Dulanic)
• Charging Stats: Visualize % of sum instead of max kWh in charging heat map (#680 by Dulanic)
• Charging Stats: Show cost per 100 km/mi (Charging Stats)
• Drives: Update possible values for the "cold" column to be consistent (#702 by Dulanic)
• Drive Details: Show drive efficiency
• Mileage: Optimize query to get odometer (#804 by Dulanic)
• Overview: Add 'total energy added' to chart (#690 by Dulanic)
• Overview: Hide stale temperatures
• Overview: Show most recent driver temp setting while driving
• Overview: Add efficiency (#970 by DrMichael)
• States: Display all states names (#755 by DrMichael)
• Updates: Add links to release notes (#797 and #823 by pmboothby)
• Updates: Show average range and number of chargers per software version to identify if an update had a bigger than expected impact on range (#731 and #762 by Dulanic)
• Updates: Fix up the version display when it only has a week value and no point release (#925 by pyjamasam)
• Vampire Drain: Utilize charges as additional anchor points (#769 by tacotran)
• Add new Statistics dashboard (#965 by DrMichael)
• Add the "shared crosshair" setting to some of the dashboards (#932 and #962 by Kosta-Github)
• "Customize" Grafana logo (#890 by https://github.com/fatbasstard)

Note

• The dashboards require Grafana 7. Make sure you are running the latest version of Grafana if you are not using the Docker installation.

Translations

• Update Chinese (Simplified) translation (#747 by edward4hgl)
• Update French translation (#693 by tomS3210)
• Tweak Dutch translation (#880 and#881 by https://github.com/fatbasstard)

Documentation

• Update HomeAssistant documentation (#705 by ngardiner)
• TeslaFi Import: Clarify steps 3 and 4 about emptying the import folder (#703 by ramonsmits)
• Update Upgrade documentation (#790 by roadrash2108)
• Add a page that lists projects that use TeslaMate: docs.teslamate.org/docs/projects
• An note about moving the backup file (#813 by traviscollins)
• Add -T flag to backup command (#851 by acemtp)

Other

• Optimize conversion helper functions
• Allow to set a cost by the minute per geo-fence
• Allow to set charge cost by minute
• Allow negative charge costs
• Periodically store vehicle data while charging
• Use a more performant HTTP client
• Try to keep using API tokens if initial refresh at startup fails
• Tweak streaming timeouts and create a new connection after too many disconnects
• Change default sleep requirements to not require the car to be locked
• Use GitHub Actions to build docker images and publish them to DockerHub
• For those who want to help testing the latest development version: the docker images with the edge tag (teslamate/teslamate:edge and teslamate/grafana:edge) are for you.
• Allow negative cost_per_unit for geofences (#968 by ayonix)
• Speed up parsing of CSV files (data import)

Bug Fixes

• Vampire Drain: Fix duplicate values with multiple cars (#726 by Dulanic)
• Tooling: Ensure dashboards are restored into the same folder as they currently belong to (#712 by sumnerboy12)
• Battery Level & Range: fix wrongly displayed values for multiple cars (#843 by lemmerk)
• Fix handling of locations that cannot be geocoded
• Show in progress charging sessions
• Handle API errors during initialization

v1.19.4

• Bump Grafana to v6.7.4 which includes an important security patch

v1.19.3

Enhancements

Translations

• Improve Chinese (Traditional) translation accuracy (#650 by occultsound)
• Improve Chinese (Simplified) translation accuracy (#649 by edward4hgl)
• Improve Korean translation (#663 by dongbum)

Dashboards

• Overview: Update battery gauge thresholds (#651 by wooter)
• Drives: Add column header for reduced range (#662 by Dulanic)
• Charging Stats: Show map with frequently used chargers (#666 by Dulanic)
  • Manual install: requires Grafana plugin grafana-map-panel

    grafana-cli --pluginUrl https://github.com/panodata/grafana-map-panel/releases/download/0.9.0/grafana-map-panel-0.9.0.zip plugins install grafana-worldmap-panel-ng

Other

• Add option HTTP_BINDING_ADDRESS to control the bound IP address (#665 by dyxyl)
• Docker image: Pre-install Grafana plugins
• Drop unused indexes

Bug Fixes

• Fix an issue that could cause a missed firmware update not to be logged retroactively
• Fix an issue where the vehicle process could crash when logging was suspended manually
• Improve error message for an invalid tokens table
• Fix min. distance per drive on Efficiency dashboard to filter correctly in miles (#672 by Dulanic)

v1.19.2

Enhancements

Translations

• Add Chinese (Simplified) translation (#625 by edward4hgl)
• Add Chinese (Traditional) translation (#633 by occultsound)
• Fix typo in French translation (#638 by tobiasehlert)
• Add Dutch translation (#647 by wooter)

Dashboards

• Updates: Show update duration and time since last update (#632 by Dulanic)
• Charging Stats: Show kWh at non-decimal level and MWh at the 3 decimal point level (#642 and #646 by Dulanic)

Bug Fixes

• Do not publish NULL or incorrect values to MQTT topics if TeslaMate is restarted while the car is asleep

v1.19.1

Enhancements

Translations

• Add Korean translation (#614 by dongbum)

Bug Fixes

• Fix an issue where the map tiles would disappear when editing a geofence
• Fix a few things in the docs (#611 by tobiasehlert)

v1.19.0

Enhancements

Streaming API

As the first and only Tesla logging app out there, TeslaMate now use the Tesla streaming API! This brings the following improvements:

• High precision drive data. Rather than active polling, the streaming API allows for passive consumption of a high frequency data stream with the most important drive data (position, heading, speed, power, elevation etc.).
• Actual elevation above sea level. Up until now TeslaMate used satellite terrain data to get the elevation. Driving through tunnels or across bridges therefore resulted in inaccurate recordings. This is no longer the case!
• Bluetooth hints are no longer needed! Using the streaming API does not prevent the vehicle from falling asleep, thus enabling continuous monitoring. This allows the car to fall asleep more quickly (no more idle timer) and we don't miss up to 21 minutes of driving because of halted polling.

Many thanks to everyone who participated in testing this release and contributed improvements!

Translations

• Add Danish translation (#584 by MartinNielsen)
• Update Norwegian translation (#544 and #591 by spacecosmos)
• Update Swedish translation (#522 by tobiasehlert)
• Update French translation (#598 by tomS3210 and MaxG88)
• Updated Labels to Title Case (#578 by jmiverson)

Other enhancements:

• Send credentials with manifest request (#555 by MaxG88)
• Add option to change the language of the web interface
• Reduce docker image size
• Display an arrow instead of a generic marker to indicate in which direction the vehicle is heading
• Show spinner before the map is initialized
• Wait until the doors/trunk/frunk are closed before attempting to fall asleep
• Inform if a new TeslaMate update is available
• Add icons to navbar items
• Add 'About' section to the settings page
• Publish only those values via MQTT that have actually changed
• Improve detection of available vehicle software updates

New MQTT Topics

• teslamate/cars/$car_id/elevation
• teslamate/cars/$car_id/trunk_open
• teslamate/cars/$car_id/frunk_open

Documentation

The docs were revised (once again). You can find them at docs.teslamate.org.

• Add portainer guide to the documentation (#581 by DrMichael)
• Improve Apache2 guide (#570 by DrMichael)
• Bump traefik to v2.2 (#603 by oittaa)

Bug Fixes

• Display vampire drain range loss per hour in the correct units (#543 by ograff).
• Trip dashboard: Add title to the drives table to allow sorting (#592 by MaxG88)
• Add tini as the init process for the TeslaMate Docker container to avoid zombie processes (#606 by dbussink)
• Sort "Drives" table properly by drive date (#595 by Dulanic)
• Fix flashing modal on the geofence page
• Publish an MQTT message when the health check succeeds again
• Handle various invalid API responses that could previously cause problems
• Fix an issue where ambiguous dates could cause the TeslaFi import to fail
• Terminate an in progress drive when the car is put into service mode

Changed

• Increase the minimum Elixir version to 1.10

Removed

• Remove sleep mode requirements that are no longer needed
• Remove option to disable sleep mode