VehicleVault for Home Assistant 🚗⚡

Official Home Assistant custom integration for VehicleVault. Automatically creates dedicated Devices and live Sensors for every vehicle in your fleet with zero YAML configuration needed!

---

✨ Features

• Zero YAML Required: Simple UI config flow via Settings → Devices & Services → Add Integration.
• Dedicated Device Per Vehicle: Automatically groups all sensors under each vehicle in your garage (e.g. KIA NIRO, Golf 7, Tesla Model 3).
• Comprehensive Telemetry:
  • 🚗 Odometer (km) with native distance device class and total increasing state.
  • 🛡️ APK Status & Expiration Date (sensor.kia_niro_apk_expiration_date) and days remaining with overdue alerts.
  • ⛽ Fuel Economy in both km/L and L/100km.
  • 💶 Last Fill-up Details (Total cost, volume in liters or kWh, fuel station name, and unit price).
  • ⚡ PHEV & EV Ready: Seamlessly handles electric charging sessions (kWh) as well as conventional fuels.
  • 🔧 Maintenance Intervals & Alerts: Real-time count and detailed breakdown of upcoming or overdue service items.
• Customizable Polling: Default 5-minute polling, configurable via integration options.

---

📦 Installation

Option 1: Via HACS (Recommended)

1. Open Home Assistant and navigate to HACS → Integrations.
2. Click the three dots in the top right corner and select Custom repositories.
3. Add the following repository:
   • Repository: https://github.com/TeeCodeDev/ha-vehiclevault
   • Type: Integration
4. Click Add, find VehicleVault in the list, and click Download.
5. Restart Home Assistant.

Option 2: Manual Installation

1. Download the latest release from the Releases page.
2. Copy the custom_components/vehiclevault folder into your Home Assistant <config_dir>/custom_components/ directory.
3. Restart Home Assistant.

---

⚙️ Configuration

1. In Home Assistant, go to Settings → Devices & Services.
2. Click Add Integration in the bottom right corner.
3. Search for VehicleVault.
4. Enter your connection details:
   • VehicleVault URL: http://192.168.1.100:3084 (or your domain, e.g. https://vehicles.example.com)
   • API Key: (Optional) Create an API key in VehicleVault → Settings → Users & Access if you have authentication enabled.
5. Click Submit. Home Assistant will immediately detect all active vehicles and create their sensors!

---

📊 Sensors Created Per Vehicle

Sensor	Entity ID Example	Description
Odometer	sensor.kia_niro_odometer	Current vehicle odometer in km
APK Expiration Date	sensor.kia_niro_apk_expiration_date	Official RDW inspection expiry date
APK Days Remaining	sensor.kia_niro_apk_days_remaining	Days remaining until APK expiry
APK Status	sensor.kia_niro_apk_status	Status (ok, due_soon, overdue)
Fuel Economy (km/L)	sensor.kia_niro_fuel_economy_km_l	Average fuel economy in km/L
Fuel Consumption (L/100km)	sensor.kia_niro_fuel_consumption_l_100km	Average fuel economy in L/100km
Last Refuel Date	sensor.kia_niro_last_refuel_date	Date of last fueling or charging stop
Last Refuel Cost	sensor.kia_niro_last_refuel_cost	Cost of last fill-up in €
Last Refuel Volume	sensor.kia_niro_last_refuel_volume	Liters pumped or kWh charged
Maintenance Alerts	sensor.kia_niro_maintenance_alerts	Count of service items due/overdue

---

💡 Lovelace Dashboard Example

Add this Entities card to your Home Assistant dashboard:

type: entities
title: 🚗 KIA NIRO
show_header_toggle: false
entities:
  - entity: sensor.kia_niro_odometer
    name: Odometer
  - entity: sensor.kia_niro_apk_expiration_date
    name: APK Expiration Date
  - entity: sensor.kia_niro_apk_days_remaining
    name: Days until APK
  - entity: sensor.kia_niro_fuel_economy_km_l
    name: Fuel Economy
  - entity: sensor.kia_niro_last_refuel_date
    name: Last Refuel Date
  - entity: sensor.kia_niro_last_refuel_cost
    name: Last Refuel Cost
  - entity: sensor.kia_niro_maintenance_alerts
    name: Maintenance Alerts

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.