mirror of
https://github.com/teslamate-org/teslamate.git
synced 2026-01-24 21:06:08 +08:00
88 lines
4.8 KiB
Markdown
88 lines
4.8 KiB
Markdown
# TeslaMate
|
|
|
|
[](https://www.bestpractices.dev/projects/10859)
|
|
[](https://github.com/teslamate-org/teslamate/actions/workflows/devops.yml)
|
|
[](https://github.com/teslamate-org/teslamate/actions/workflows/buildx.yml)
|
|
[](https://coveralls.io/github/teslamate-org/teslamate?branch=main)
|
|
[](https://hub.docker.com/r/teslamate/teslamate)
|
|
[](https://hub.docker.com/r/teslamate/teslamate)
|
|
[](https://hub.docker.com/r/teslamate/teslamate)
|
|
|
|
A powerful, self-hosted data logger for your Tesla.
|
|
|
|
- Written in **[Elixir](https://elixir-lang.org/)**
|
|
- Data is stored in a **Postgres** database
|
|
- Visualization and data analysis with **Grafana**
|
|
- Vehicle data is published to a local **[MQTT](https://en.wikipedia.org/wiki/MQTT)** Broker
|
|
|
|
## Documentation
|
|
|
|
The documentation is available at [https://docs.teslamate.org](https://docs.teslamate.org/)
|
|
|
|
## Features
|
|
|
|
### General
|
|
|
|
- High precision drive data recording
|
|
- No additional vampire drain: the car will fall asleep as soon as possible
|
|
- Automatic address lookup
|
|
- Easy integration into Home Assistant (via MQTT)
|
|
- Easy integration into Node-Red & Telegram (via MQTT)
|
|
- Geo-fencing feature to create custom locations
|
|
- Supports multiple vehicles per Tesla Account
|
|
- Charge cost tracking
|
|
- Import from TeslaFi and tesla-apiscraper
|
|
|
|
### Dashboards
|
|
|
|
Sample screenshots of bundled dashboards can be seen by clicking the links below.
|
|
|
|
- [Battery Health](https://docs.teslamate.org/docs/screenshots/#battery-health)
|
|
- [Charge Level](https://docs.teslamate.org/docs/screenshots/#charge-level)
|
|
- [Charges (Energy added / used)](https://docs.teslamate.org/docs/screenshots#charges)
|
|
- [Charge Details](https://docs.teslamate.org/docs/screenshots#charge-details)
|
|
- [Charging Stats](https://docs.teslamate.org/docs/screenshots#charging-stats)
|
|
- [Database Information](https://docs.teslamate.org/docs/screenshots/#database-information)
|
|
- [Drive Stats](https://docs.teslamate.org/docs/screenshots#drive-stats)
|
|
- [Drives (Distance / Energy consumed (net))](https://docs.teslamate.org/docs/screenshots/#drives)
|
|
- [Drive Details](https://docs.teslamate.org/docs/screenshots/#drive-details)
|
|
- [Efficiency (Consumption (net / gross))](https://docs.teslamate.org/docs/screenshots#efficiency)
|
|
- [Locations (addresses)](https://docs.teslamate.org/docs/screenshots/#location-addresses)
|
|
- [Mileage](https://docs.teslamate.org/docs/screenshots/#mileage)
|
|
- [Overview](https://docs.teslamate.org/docs/screenshots/#overview)
|
|
- [Projected Range (battery degradation)](https://docs.teslamate.org/docs/screenshots#projected-range)
|
|
- [States (see when your car was online or asleep)](https://docs.teslamate.org/docs/screenshots#states)
|
|
- [Statistics](https://docs.teslamate.org/docs/screenshots/#statistics)
|
|
- [Timeline](https://docs.teslamate.org/docs/screenshots/#timeline)
|
|
- [Trip](https://docs.teslamate.org/docs/screenshots/#trip)
|
|
- [Updates (History of installed updates)](https://docs.teslamate.org/docs/screenshots#updates)
|
|
- [Vampire Drain](https://docs.teslamate.org/docs/screenshots#vampire-drain)
|
|
- [Visited (Lifetime driving map)](https://docs.teslamate.org/docs/screenshots/#visited-lifetime-driving-map)
|
|
|
|
## Screenshots
|
|
|
|
Sneak peak into TeslaMate interface and bundled dashboards. See [the docs](https://docs.teslamate.org/docs/screenshots) for additional screenshots.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Star History
|
|
|
|
<a href="https://www.star-history.com/#teslamate-org/teslamate&type=date&legend=top-left">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=teslamate-org/teslamate&type=date&theme=dark&legend=top-left" />
|
|
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=teslamate-org/teslamate&type=date&legend=top-left" />
|
|
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=teslamate-org/teslamate&type=date&legend=top-left" />
|
|
</picture>
|
|
</a>
|
|
|
|
## Credits
|
|
|
|
- Initial Author: Adrian Kumpf
|
|
- List of Contributors:
|
|
- [](https://github.com/teslamate-org/teslamate/graphs/contributors)
|
|
- Distributed under MIT License
|