On Home Assistant 2026.10 or older? Open it in HACS
- Installs
- 51 sharing analytics
- GitHub stars
- 11
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v0.3.22,
- Category
- Energy, Meters and monitoring
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
be_gas_prices- Issues
- Report an issue
Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.
About
Home Assistant integration for Belgian all-in natural gas prices: energy, network tariffs and levies parsed from the suppliers' own tariff cards, per kWh and per m³, with year-to-date cost from the...
Description from renaudallard/homeassistant_be_gas_prices
Shows in Vulpo
Button card, Chart card, Apple Watch.Installs over time
51
Oct 21Nov 9
#1,519 of 1,551 Marketplace integrations. Installs sharing analytics.
Supports
- Uses the vendor's cloudNeeds an internet connection and an account with the vendor.
- From the MarketplaceInstalled through the Marketplace, formerly HACS.
- Actively maintainedIts author released or pushed a change in the last six months.
Provides
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Where is the gas connection?
- Postcode4-digit Belgian postcode.
Region
- Region
Supplier
- Supplier
Contract
- Contract
- Contract start dateThe first day of supply, as on your bill.
- Tariff card dateThe day you signed, when your card is not the one of the month supply started. Elegant reissues its fixed card within a month, so there the day picks which one. A TotalEnergies renewal is priced on the card of three months before it: give a day of that month.
- Contract end dateOnly used for a renewal reminder.
- Count this year's cost from the contract startOff: the running cost and this year's consumption start on 1 January. On: they start at the contract start date when that is later.
- Enter the figures of my contractFor a contract whose price differs from the supplier's card, or whose card cannot be found. The next step asks for them.
Network operator
- Network operator
Household
- Yearly consumptionIn kWh, from your last yearly bill. Used until your gas meter has a full year of readings.
- Gas meter sizePrinted on your gas meter; most homes have a G4 or G6. It sets a Brussels levy.
- Gas meterThe sensor that counts your gas use, in m³ or kWh. Leave it empty to use the one in the Energy dashboard.
- Conversion factorHow many kWh one m³ of gas is worth, printed on your bill (about 11 to 12). Leave it empty if you don't have it: you then pick your gas reception station.
- Read the project's card archiveFetch price cards from this project's archive on GitHub when the supplier's own cannot be read or are no longer published. Only the supplier, contract, region and month are sent. Also reads, once a day, the VAT rate the archived cards agree on, for the prices a card gives without one and the figures typed from a contract, the federal levies the archive kept for the months the law and FPS Finance's tariff no longer list, and, for a custom entry taking its network from its operator's tariff sheet, the network it kept for a month the sheet no longer gives. Off, the integration does not contact GitHub and keeps the tables it last read while this was on; a VAT rate a card does not state is otherwise 6%.
- Compare every contract once a dayOnce a day, compare every contract in your region and show the best saving as a sensor.
Gas reception station
- Reception station
Conversion factor
- Conversion factor
After setup
- Postcode4-digit Belgian postcode.
- Region
- Supplier
- Contract
- Contract start dateThe first day of supply, as on your bill.
- Tariff card dateThe day you signed, when your card is not the one of the month supply started. Elegant reissues its fixed card within a month, so there the day picks which one. A TotalEnergies renewal is priced on the card of three months before it: give a day of that month.
- Contract end dateOnly used for a renewal reminder.
- Count this year's cost from the contract startOff: the running cost and this year's consumption start on 1 January. On: they start at the contract start date when that is later.
- Enter the figures of my contractFor a contract whose price differs from the supplier's card, or whose card cannot be found. The next step asks for them.
- Network operator
- Yearly consumptionIn kWh, from your last yearly bill. Used until your gas meter has a full year of readings.
- Gas meter sizePrinted on your gas meter; most homes have a G4 or G6. It sets a Brussels levy.
- Gas meterThe sensor that counts your gas use, in m³ or kWh. Leave it empty to use the one in the Energy dashboard.
- Conversion factorHow many kWh one m³ of gas is worth, printed on your bill (about 11 to 12). Leave it empty if you don't have it: you then pick your gas reception station.
- Read the project's card archiveFetch price cards from this project's archive on GitHub when the supplier's own cannot be read or are no longer published. Only the supplier, contract, region and month are sent. Also reads, once a day, the VAT rate the archived cards agree on, for the prices a card gives without one and the figures typed from a contract, the federal levies the archive kept for the months the law and FPS Finance's tariff no longer list, and, for a custom entry taking its network from its operator's tariff sheet, the network it kept for a month the sheet no longer gives. Off, the integration does not contact GitHub and keeps the tables it last read while this was on; a VAT rate a card does not state is otherwise 6%.
- Compare every contract once a dayOnce a day, compare every contract in your region and show the best saving as a sensor.
- Reception station
- Conversion factor
Texts from the code of renaudallard/homeassistant_be_gas_prices.
Entities
- ButtonsRefresh tariff card
- SensorsCurrent price, Current price per m³, Energy component, Network component, Taxes component, Fixed costs per year, Supplier fixed fee per year, Conversion factor, Current year cost, Current month cost, Year to date consumption, Rolling year cost, and 5 more
Actions
- RefreshFetch the tariff card, the index values and the calorific values again now.
- Entry
- Backfill statisticsWrite the price sensors' hourly statistics from a start date to the newest hour the recorder has compiled, and the year's cost from the start of the year's window.
- Entry
- Start date
- Clear first
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
- Repair noticesNotices it can show in Settings, Repairs:Tariff card is out of date, Tariff card could not be read, Tariff card is not available, Publishes its card as images, Card read from its image, Gas meter cannot be read, Several gas meters in the Energy dashboard, Home Assistant's recorder is not running
From the README
Home Assistant integration that exposes the all-in price paid for natural gas in Belgium, per kWh and per cubic metre, taking into account every part of a Belgian gas bill (energy + distribution + transport + levies + VAT), and, from your gas meter, the running bill of the year and of the month.
Prices are read live from each supplier's own published tariff card. No supplier price is hardcoded in the source. A supplier is one Python module that knows where its card is published and how to read it. If yours is missing, open an issue asking for it with the
- Live tariff cards: every figure comes from the supplier's own card.
- Whole-bill view: energy, distribution, transport, levies and VAT in one EUR/kWh, and the same per m³ for an Energy dashboard gas source counted in cubic metres.
- Indexed contracts priced on the supplier's own index: most variable gas contracts are factor x index + base, where the index (TTF or ZTP, day-ahead or month-ahead, RLP-weighted or not) belongs to…
- The tier and the excise the way the bill applies them: the distribution tier (up to 5 000, 150 000 or 1 000 000 kWh a year) prices every kWh of the year, and the federal excise is billed per slice…
- The levies from the law: for the delivery months the law is known for, the special excise, the energy contribution and the Walloon connection fee are what the law sets, whatever a stale or wrong…
Information
- Installs
- 51 sharing analytics
- GitHub stars
- 11
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v0.3.22,
- Category
- Energy, Meters and monitoring
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
be_gas_prices- Issues
- Report an issue
