TeslaMate Telegram Bot

A propos / Disclamer

Ce fork du projet est fait pour montrer ce qu'on peut faire avec ce bout de code de départ, avec le projet Tesla MQTT API et quelques lignes de codes Python 3.8 pour avoir des informations sur sa Tesla.

Le code partagé dans le dossier src a été retouché dans ce sens, mais présente trop de changement par rapport au dépot initial. C'est pourquoi ce fork, en laissant les liens initiaux (PayPal et autres), tout en partageant mes modifications.

This is a telegram bot written in Python to notify by Telegram message when a new SW update for your Tesla is available. It uses the MQTT topic which TeslaMate offers.

Screenshots

Table of contents

• TeslaMate Telegram Bot
  • Screenshots
  • Table of contents
  • Features
  • Requirements
  • Installation
  • Update
  • Contributing
  • Donation
  • Disclaimer

Features

• Envoyer un message Telegram quand une mise à jour est disponible
• Envoyer un message Telegram quand un changement d'état se produit
• Envoyer un message Telegram quand une portière s'ouvre
• Envoyer un message Telegram quand une charge démarre ou s'arrête
• Envoyer un message Telegram quand le temps de charge change
• Envoyer la dernière position GPS connue de la voiture lorsqu'elle se verrouille (utile pour retrouver dans un parking plein air par exemple)

Requirements

• A Machine that's always on and runs TeslaMate
• Docker (if you are new to Docker, see Installing Docker and Docker Compose)
• External internet access, to send telegram messages.
• A mobile with Telegram client installed
• your own Telegram Bot, see Creating a new telegram bot
• your own Telegram chat id, see get your telegram chat id

Installation

Make sure you fulfill the Requirements.

It is recommended to backup your data first.

This document provides the necessary steps for installation of TeslaMate Telegram Bot on a any system that runs Docker.

This setup is recommended only if you are running TeslaMate Telegram Bot on your home network, as otherwise your telegram API tokens might be at risk.

1. Create a file called docker-compose.yml with the following content (adopt with your own values):

      version: "3"
   
      services:
        teslamatetelegrambot:
          image: teslamatetelegrambot/teslamatetelegrambot:latest
          restart: unless-stopped
          environment:
            - MQTT_BROKER_HOST=IP_Adress
            - MQTT_BROKER_PORT=1883 #optional, default 1883
            - TELEGRAM_BOT_API_KEY=secret_api_key
            - TELEGRAM_BOT_CHAT_ID=secret_chat_id
            - TELSAMATE_MQTT_API_URL=http://127.0.0.1:3040/car/1?api_key=xxxxx #CHANGEME with the MQTT API URL
          ports:
            - 1883
          build:
            context: .
            dockerfile: Dockerfile

2. Build and start the docker container with docker-compose up. To run the containers in the background add the -d flag:

   docker-compose build
   docker-compose up -d

Update

Check out the release notes before upgrading!

Note FR : A faire uniquement si vous n'avez pas de modification apportée au code dans src.

Pull the new images:

docker-compose pull

and restart the stack with docker-compose up. To run the containers in the background add the -d flag:

docker-compose up -d

Contributing

All contributions are welcome and greatly appreciated!

Donation

Maintaining this project isn't effortless, or free. If you would like to kick in and help me cover those costs, that would be awesome. If you don't, no problem; just share your love and show your support.

Disclaimer

Please note that the use of the Tesla API in general and this software in particular is not endorsed by Tesla. Use at your own risk.