Skip to content

akentner/homeassistant-chargefinder-integration

Repository files navigation

ChargeFinder for Home Assistant

HACS

A custom Home Assistant integration that exposes live outlet availability from ChargeFinder EV charging stations as Home Assistant entities.

Every outlet becomes a binary sensor (available/occupied) and the station gets an aggregate sensor counting currently available outlets — perfect for automations like "notify me when my charging spot is free" or dashboard cards showing real-time availability.


Features

  • Binary sensor per outleton = available, off = occupied/out of order
  • Aggregate sensor per station — count of currently available outlets
  • Extra attributes: plug type, capacity (kW), status string, address, GPS coordinates, opening hours
  • Automatic polling every 60 seconds

Requirements

  • Home Assistant 2024.1 or newer
  • A ChargeFinder station slug (see Configuration below)

Installation

Via HACS (recommended)

  1. Open HACS in Home Assistant.
  2. Go to Integrations → click the three-dot menu → Custom repositories.
  3. Add https://github.com/akentner/ha-chargefinder as an Integration.
  4. Search for ChargeFinder and click Download.
  5. Restart Home Assistant.

Manual installation

  1. Download or clone this repository.
  2. Copy the custom_components/chargefinder/ folder into your Home Assistant custom_components/ directory.
  3. Restart Home Assistant.

Configuration

  1. Go to Settings → Devices & Services → Add Integration.
  2. Search for ChargeFinder and select it.
  3. Enter the station slug — the last part of the station URL on chargefinder.com.

Finding the slug:

Open the station page on chargefinder.com. The URL looks like:

https://chargefinder.com/en/charging-station/dxxpe3
                                               ^^^^^^
                                               this is the slug

Enter dxxpe3 (or whichever slug your station has) when prompted.


Entities

After setup, the integration creates the following entities for each configured station:

Binary sensors (one per outlet)

Entity State Attributes
binary_sensor.chargefinder_<identifier> on = Available, off = Occupied/Other plug type, capacity kW, status string

Sensor (one per station)

Entity State Attributes
sensor.chargefinder_<slug>_available Number of available outlets address, opening hours, latitude, longitude

Notes

Unofficial API: This integration uses the ChargeFinder web app API, which is not publicly documented. It may break without notice if ChargeFinder changes their backend. Report issues at the GitHub issue tracker.


Contributing & Issues

About

Home Assistant integration for ChargeFinder EV charging stations — real-time outlet availability

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors