Skip to content

Repository files navigation

Pumperly Fuel Prices for Home Assistant

Pumperly Fuel Prices for Home Assistant

HACS Validation Tests License codecov hacs_badge

A Home Assistant custom integration that tracks fuel and EV charging prices from a Pumperly instance: 16 fuel types, every country the instance covers, in your dashboard.

Features

  • Track cheapest, nearest, and average prices for any fuel type
  • Support for gasoline, diesel, LPG, CNG, LNG, hydrogen, EV charging, and AdBlue
  • Configurable search radius (1-50 km)
  • Multi-step config flow with location picker
  • Works with the public instance (pumperly.com) or self-hosted
  • Diagnostic sensors for instance-wide statistics
  • Polls every 30 minutes

Quick start

  1. In HACS, open Custom repositories and add https://github.com/GeiserX/pumperly-ha with category Integration.
  2. Install Pumperly Fuel Prices and restart Home Assistant.
  3. Go to Settings > Devices & Services > Add Integration and search for Pumperly.

Needs Home Assistant 2024.1 or later. Manual install, prerequisites and the setup steps are in Getting started.

Documentation

  • Getting started: HACS and manual install, prerequisites, the config flow
  • Usage: sensors, attributes, fuel codes, refresh interval, a price-drop automation and a dashboard card
  • Related projects

Related: Pumperly, the open-source fuel and EV route planner, and its public instance pumperly.com.

License

GPL-3.0-or-later

Releases

Packages

Used by

Contributors

Languages