mirror of
https://github.com/vide/matedroid.git
synced 2026-01-20 00:03:17 +08:00
5a2e3df4ae
* chore: bump minSdk from API 26 to API 29 This enables SQLite window functions (LAG, LEAD, etc.) for efficient record calculations without requiring sync pre-computation. Android 10 (API 29) was released in September 2019 and covers 95%+ of active Android devices as of 2026. * feat(stats): add SQL query for max distance between charges Uses SQLite LAG window function to efficiently find the maximum distance traveled between consecutive charges. Includes both all-time and date-range variants for year filtering support. * feat(stats): add MaxDistanceBetweenChargesRecord domain model Add new record type to QuickStats for tracking the maximum distance driven between two consecutive charging sessions. * feat(stats): integrate max distance between charges in repository Wire up the new DAO query to QuickStats for both all-time and year-filtered views. No sync required - data is computed instantly from the existing charges summary table. * feat(stats): display max distance between charges in Records UI Add 'Longest Range' record showing the maximum distance traveled between two consecutive charges. Displays with battery emoji and date range, tapping navigates to the ending charge detail. * feat(stats): add SQL query for max distance between charges Uses a self-join with correlated subquery to efficiently find the maximum distance traveled between consecutive charges. Includes both all-time and date-range variants for year filtering support. * fix(stats): use sum of drives instead of odometer diff for longest range The odometer difference between charges can include unlogged drives (e.g., when TeslaMate was down). Now we sum actual logged drives between charges, which gives accurate results even with data gaps. * feat(stats): add popup dialog for longest range record details When tapping the 'Longest Range' record, show a dialog with: - Total distance and date range summary - Scrollable list of all drives that make up the record - Each drive is tappable to navigate to drive details This provides full context about what drove the record instead of just navigating to a single charge. * docs: simplify changelog entries for users
85 lines
3.3 KiB
Markdown
85 lines
3.3 KiB
Markdown
# MateDroid
|
|
|
|
A native Android application for viewing Tesla vehicle data from your self-hosted [Teslamate](https://github.com/adriankumpf/teslamate) instance via the [TeslamateApi](https://github.com/tobiasehlert/teslamateapi).
|
|
|
|
**DISCLAIMER**: This app has been *vibe-coded*
|
|
|
|
## Features
|
|
|
|
- **Dashboard** - Real-time vehicle status at a glance with 3D car image matching your vehicle's color and wheels
|
|
- **Stats for Nerds** - Tap car image for advanced statistics: records, extremes, AC/DC ratio and much more!
|
|
- **Charging History** - View all charging sessions with statistics and charts
|
|
- **Charge Details** - Interactive map and detailed power/voltage/temperature charts
|
|
- **Drive History** - Track trips with efficiency metrics and route visualization
|
|
- **Battery Health** - Monitor battery degradation over time
|
|
- **Software Updates** - Track update history
|
|
- **Car color based themes** - Light/dark themes with palette based on the car color
|
|
|
|
### Gallery
|
|
|
|
<p>
|
|
<img src="docs/screenshots/main-dashboard.jpg" alt="Main dashboard" height="300">
|
|
<img src="docs/screenshots/battery-health.jpg" alt="Battery health" height="300">
|
|
<img src="docs/screenshots/mileage.jpg" alt="Mileage" height="300">
|
|
<img src="docs/screenshots/software-versions.jpg" alt="Software versions" height="300">
|
|
</p>
|
|
<p>
|
|
<img src="docs/screenshots/drives.jpg" alt="Drives" height="300">
|
|
<img src="docs/screenshots/drive-details.jpg" alt="Drive details" height="300">
|
|
<img src="docs/screenshots/charges.jpg" alt="Charges" height="300">
|
|
<img src="docs/screenshots/charge-details.jpg" alt="Charge details" height="300">
|
|
<img src="docs/screenshots/stats-for-nerds.jpg" alt="Stats for nerds" height="300">
|
|
</p>
|
|
|
|
## Requirements
|
|
|
|
- Android 10 (API 29) or higher
|
|
- A running [Teslamate](https://github.com/adriankumpf/teslamate) instance
|
|
- [TeslamateApi](https://github.com/tobiasehlert/teslamateapi) deployed and accessible
|
|
|
|
**This projects needs Teslamate API to work**, it will not work just with plan Teslamate. Please follow the Teslamate API instructions and make sure it is working as expected before opening any issue, thanks!
|
|
|
|
## Installation
|
|
|
|
### From Release (Recommended)
|
|
|
|
Download the latest APK from the [Releases](https://github.com/vide/matedroid/releases) page and install it on your Android device.
|
|
|
|
### Build from Source
|
|
|
|
#### Prerequisites
|
|
|
|
- Java 17 or higher
|
|
- Android SDK (API 35)
|
|
- (Optional) Android Studio
|
|
|
|
#### Build Steps
|
|
|
|
```bash
|
|
# Clone the repository
|
|
git clone https://github.com/vide/matedroid.git
|
|
cd matedroid
|
|
|
|
# Build debug APK
|
|
./gradlew assembleDebug
|
|
|
|
# The APK will be at: app/build/outputs/apk/debug/app-debug.apk
|
|
|
|
# Or install directly to a connected device/emulator
|
|
./gradlew installDebug
|
|
```
|
|
|
|
## Development
|
|
|
|
Please see [DEVELOPMENT.md](docs/DEVELOPMENT.md) for more details on how this app was created and how to build and test it.
|
|
|
|
## License
|
|
|
|
This project is licensed under the GNU General Public License v3.0. See [LICENSE](LICENSE) for details.
|
|
|
|
## Acknowledgments
|
|
|
|
- [Teslamate](https://github.com/adriankumpf/teslamate) - Self-hosted Tesla data logger
|
|
- [TeslamateApi](https://github.com/tobiasehlert/teslamateapi) - RESTful API for Teslamate
|
|
- [t-buddy](https://github.com/garanda21/t-buddy) - iOS app that triggered this development and was used as inspiration. Many kudos, it's a wonderful app and you should use it if you are on iOS!
|