https://github.com/jeeyo/torquemate
A car data logger that retrieve data from Torque Android App
https://github.com/jeeyo/torquemate
elm327 grafana obd2 torque
Last synced: about 10 hours ago
JSON representation
A car data logger that retrieve data from Torque Android App
- Host: GitHub
- URL: https://github.com/jeeyo/torquemate
- Owner: jeeyo
- License: mit
- Created: 2024-02-12T15:39:05.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-04-14T05:20:24.000Z (3 months ago)
- Last Synced: 2026-04-14T05:26:21.568Z (3 months ago)
- Topics: elm327, grafana, obd2, torque
- Language: C#
- Homepage:
- Size: 971 KB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TorqueMate
A data logger inspired by [TeslaMate](https://github.com/teslamate-org/teslamate), but was designed for any cars that provide data through OBDII and [Torque Android application](https://play.google.com/store/apps/details?id=org.prowl.torque).
## How it works?
```mermaid
flowchart LR
car[🚗 Your car] <--> obd2[OBDII Reader] <-->|Bluetooth| torque[📱 Torque Android App]
torque -->|HTTP| torquemate[TorqueMate]
torquemate --> postgres[⛁ Postgres]
grafana[Grafana] --> postgres
```
## Components
This project consists of two parts:
1. **Web server** written in C# using ASP.NET for receiving messages sent from Torque application and save to Postgres database.
2. **Grafana Dashboards** that you can import to your Grafana instance to visualize the data collected by the web server.
## Screenshots
### TorqueMate Basic
## Deployment
### Prerequisites
1. Docker
2. Postgres 16
3. Grafana 10
### 1. Setup Postgres instance
Create a new Postgres 16 instance, it could be on cloud or on your local server, and use [./migrations/bootstrap.sql](./migrations/bootstrap.sql) to automatically get the database schema ready.
### 2. Setup TorqueMate web server
Once you have your Postgres database, to start the web server, you'll need to provide the connection string to your database to the container environment variable.
```bash
docker run \
-p 5147:5147 \
-e ConnectionStrings__NpgsqlTorqueDatabase="Host=; Port=5432; Database=; Username=; Password=" \
ghcr.io/jeeyo/torquemate:latest
```
### 3. Setup Grafana
Create a new Grafana instance, setup a new data source to connect Grafana to your Postgres instance.
Then go to [https:///dashboards/import](), then import each dashboard JSON file in [grafana directory](./grafana).
### 4. Setup Torque Android Application
_TODO_
See [docker-compose.yml](./docker-compose.yml)