KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

HA-drivvo

★ 39 Open GitHub ↗

Custom integration for the Home Assistant to obtain information present in drivvo.com

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![hacs_badge](https://img.shields.io/badge/hacs-custom-orange.svg)
[![hacs_badge](https://img.shields.io/badge/HACS-Default-41BDF5.svg)](https://github.com/hacs/integration)
[![hassfest](https://github.com/hudsonbrendon/HA-drivvo/actions/workflows/hassfest.yaml/badge.svg)](https://github.com/hudsonbrendon/HA-drivvo/actions/workflows/hassfest.yaml)
[![HACS Action](https://github.com/hudsonbrendon/HA-drivvo/actions/workflows/hacs.yaml/badge.svg)](https://github.com/hudsonbrendon/HA-drivvo/actions/workflows/hacs.yaml)
[![Dependabot Updates](https://github.com/hudsonbrendon/HA-drivvo/actions/workflows/dependabot/dependabot-updates/badge.svg)](https://github.com/hudsonbrendon/HA-drivvo/actions/workflows/dependabot-updates)

# Drivvo Custom Integration Home Assistant

![topo.png](https://raw.githubusercontent.com/hudsonbrendon/HA-drivvo/master/topo.png)

Custom integration for the Home Assistant to obtain information present in [drivvo.com](https://www.drivvo.com/).

## What's new in 3.0.0

- Async API client with token caching — no more re-login on every poll
- New service sensors: total + last service date / odometer / value / description
- New expense sensors: total + last expense date / value / type / description
- Diagnostics support (Settings → Devices → Drivvo → Download diagnostics)
- Fail-soft on missing vehicles — one removed vehicle no longer breaks the entire entry
- Baseline test suite (~45 tests) covering API client, coordinator, sensors, config flow, services, and diagnostics

**Behavior changes that may be visible:**
- `Refuelling General Average` and `Refuelling Distance` now report `unknown` instead of `0` when there are fewer than 2 refuellings (more honest representation of missing data)

## Install

### Installation via HACS

Have HACS installed, this will allow you to update easily.

Adding Drivvo to HACS can be using this button:

[![image](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=hudsonbrendon&repository=HA-drivvo&category=integration)

If the button above doesn't work, add `https://github.com/hudsonbrendon/HA-drivvo` as a custom repository of type Integration in HACS.

- Click Install on the `Drivvo` integration.
- Restart the Home Assistant.

### Manual installation

- Copy `drivvo`  folder from [latest release](https://github.com/hudsonbrendon/HA-drivvo/releases/latest) to your `<config dir>/custom_components/` directory.
- Restart the Home Assistant.

## Configuration

Adding Drivvo to your Home Assistant instance can be done via the UI using this button:

[![image](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start?domain=drivvo)

### Manual Configuration

If the button above doesn't work, you can also perform the following steps manually:

* Navigate to your Home Assistant instance.
* In the sidebar, click Settings.
* From the Setup menu, select: Devices & Services.
* In the lower right corner, click the Add integration button.
* In the list, search and select `Drivvo`.
* Follow the on-screen instructions to complete the setup.

## Available Sensors

After the integration is set up, the following sensors will be available for each configured vehicle:

- **Vehicle**: Vehicle name and model
- **Odometer**: Current vehicle odometer reading
- **Odometer Date**: Date of last odometer update
- **Refuelling Total**: Number of total refuelling events
- **Refuelling Last Average**: Last fuel consumption average
- **Refuelling General Average**: General fuel consumption average
- **Refuelling Station**: Last refuelling station used
- **Refuelling Type**: Type of fuel used
- **Refuelling Reason**: Reason for the last refuelling
- **Refuelling Date**: Date of last refuelling
- **Refuelling Odometer**: Odometer of last refuelling
- **Refuelling Value**: Cost of last refuelling
- **Refuelling Price**: Price per liter/gallon of last refuelling
- **Refuelling Value Total**: Total cost of all refuellings
- **Refuelling Tank Full**: Whether the tank was filled completely
- **Refuelling Distance**: Distance traveled since last refuelling
- **Refuelling Price Lowest**: Lowest fuel price recorded
- **Refuelling Volume**: Volume of fuel in last refuelling
- **Refuelling Volume Total**: Total volume of fuel refuelled

### Service Sensors

- **Service Total**: Number of total service events
- **Service Value Total**: Total cost of all services
- **Service Date**: Date of last service
- **Service Odometer**: Odometer reading at last service
- **Service Value**: Cost of last service
- **Service Description**: Description of last service

### Expense Sensors

- **Expense Total**: Number of total expense events
- **Expense Value Total**: Total cost of all expenses
- **Expense Date**: Date of last expense
- **Expense Value**: Cost of last expense
- **Expense Type**: Type of last expense
- **Expense Description**: Description of last expense

## Debugging

To enable debug for Drivvo integration, add following to your `configuration.yaml`:
```yaml
logger:
  default: info
  logs:
    custom_components.drivvo: debug
```

HA-drivvo

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README