Skip to content

misterboe/tibber-extended

BranchesTags

Repository files navigation

Tibber Extended for Home Assistant

Smart energy price control with Tibber - optimized for automation and battery management.

Features

  • ✅ Config Flow Setup - Easy UI-based installation
  • 📊 14 Sensors - Complete price information, analytics, and API diagnostics
  • 🔌 12 Binary Sensors - Direct automation triggers
  • 🔋 Battery Optimization - Configurable efficiency settings
  • ⏰ Flexible Time Windows - Configurable consecutive hours (1-24h)
  • 🕐 Custom Time Window - Find cheapest hours within specific time ranges (e.g., 17:00-07:00)
  • 🏠 Multi-Home Support - All Tibber homes automatically detected
  • 🌍 Multilingual - German and English translations
  • 🔄 Hourly Updates - Synced with Tibber's hourly price changes (XX:00:05)
  • 🛡️ Resilient - Retry logic, cached data fallback, never goes unavailable

Installation

via HACS (Recommended)

  1. Open HACS in Home Assistant
  2. Go to "Integrations"
  3. Click "⋮" → "Custom repositories"
  4. Add repository URL: https://github.com/misterboe/tibber-extended
  5. Category: "Integration"
  6. Click "Add"
  7. Search for "Tibber Extended"
  8. Click "Download"
  9. Restart Home Assistant

Manual Installation

  1. Copy the custom_components/tibber_extended folder to your config/custom_components directory
  2. Restart Home Assistant

Configuration

Step 1: Add Integration

  1. Go to Settings → Devices & Services
  2. Click "+ Add Integration"
  3. Search for "Tibber Extended"
  4. Enter your Tibber API Key
  5. Optionally configure Battery Efficiency (default: 75%)

Get your Tibber API Key:

  1. Open https://developer.tibber.com/
  2. Login with your Tibber account
  3. Generate a "Personal Access Token"

Step 2: Configure Options (Optional)

After installation, click "Configure" to access:

  • Battery Efficiency - Set charge/discharge efficiency (1-100%, default: 75%)
  • Hours Duration - Number of hours for cheapest/most expensive hours and best consecutive window (1-24h, default: 3h)
  • Time Window - Configure start/end time for custom time window analysis (default: 17:00-07:00)

Available Sensors

Price Sensors

Entity ID Description Unit
sensor.tibber_current_price Current electricity price EUR/kWh
sensor.tibber_average_price Average price today EUR/kWh
sensor.tibber_min_price Lowest price today EUR/kWh
sensor.tibber_max_price Highest price today EUR/kWh
sensor.tibber_price_level Current price level VERY_CHEAP / CHEAP / NORMAL / EXPENSIVE / VERY_EXPENSIVE
sensor.tibber_cheapest_hours Cheapest hours (configurable count) Text
sensor.tibber_most_expensive_hours Most expensive hours (configurable count) Text
sensor.tibber_best_consecutive_hours Best consecutive hours window Text (configurable duration)
sensor.tibber_price_deviation_percent Deviation from average %
sensor.tibber_price_deviation_absolute Absolute deviation EUR/kWh
sensor.tibber_battery_breakeven_price Economical charging threshold EUR/kWh
sensor.tibber_time_window_cheapest_hours Cheapest hours in configured time window Text

Diagnostic Sensors (Global)

These sensors provide API monitoring and debugging capabilities:

Entity ID Description Notes
sensor.tibber_extended_last_api_update Timestamp of last successful API call Device class: timestamp
sensor.tibber_extended_last_api_response Raw API response summary Contains full JSON in attributes

Attributes on sensor.tibber_extended_last_api_update:

  • using_cached_data - Boolean: true if using cached data due to API errors
  • last_success_iso - ISO timestamp of last successful fetch

Attributes on sensor.tibber_extended_last_api_response:

  • raw_response - Complete raw JSON from Tibber API
  • raw_response_json - Pretty-printed JSON string
  • homes_count - Number of homes in response
  • home_ids - List of home IDs
  • home_names - List of home nicknames

Extra attributes on sensor.tibber_current_price:

  • current - Full current price data (total, energy, tax, level, startsAt)
  • today - All hourly prices for today
  • tomorrow - All hourly prices for tomorrow (available from ~13:00)
  • average_price, min_price, max_price
  • cheapest_hours, most_expensive_hours
  • best_consecutive_hours - Best consecutive hours window
  • rank, percentile - Current price ranking
  • data_status - "live" or "cached" (indicates if using cached data)
  • last_successful_update - ISO timestamp of last successful API fetch

Binary Sensors (Automation Triggers)

Entity ID Trigger Use Case
binary_sensor.tibber_is_very_cheap Price is VERY_CHEAP Instant charging
binary_sensor.tibber_is_cheap Price is CHEAP or VERY_CHEAP Good charging time
binary_sensor.tibber_is_expensive Price is EXPENSIVE or VERY_EXPENSIVE Avoid charging
binary_sensor.tibber_is_very_expensive Price is VERY_EXPENSIVE Definitely avoid!
binary_sensor.tibber_is_cheap_hour In cheap hours (top N configurable) Good charging time
binary_sensor.tibber_is_cheapest_hour In cheapest hours (absolute minimum) Priority scheduling
binary_sensor.tibber_is_expensive_hour In most expensive hours (top N) Avoid usage / Discharge
binary_sensor.tibber_is_good_charging_time CHEAP or in cheapest hours Main charging trigger
binary_sensor.tibber_is_below_average Below average price Cost-effective
binary_sensor.tibber_is_in_best_consecutive_hours In best consecutive window Optimal window
binary_sensor.tibber_is_cheap_power_now Below breakeven AND in cheap hours Battery charging
binary_sensor.tibber_is_time_window_cheap_hour In cheapest hours of time window Custom time window charging

Usage Examples

1. Tesla Smart Charging

automation:
  - alias: "Tesla Smart Charging"
    trigger:
      - platform: state
        entity_id: binary_sensor.tibber_is_good_charging_time
        to: "on"
    condition:
      - condition: numeric_state
        entity_id: sensor.tesla_battery_level
        below: 80
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.tesla_charger

2. Battery Charging with Efficiency

automation:
  - alias: "Battery Smart Charge"
    trigger:
      - platform: state
        entity_id: binary_sensor.tibber_battery_charging_recommended
        to: "on"
    condition:
      - condition: numeric_state
        entity_id: sensor.battery_soc
        below: 90
    action:
      - service: notify.mobile_app
        data:
          message: "Charging economical ({{ states('sensor.tibber_current_price') }}€/kWh < {{ states('sensor.tibber_battery_breakeven_price') }}€/kWh)"

3. Best Consecutive Hours Window

automation:
  - alias: "Charge in Best Window"
    trigger:
      - platform: state
        entity_id: binary_sensor.tibber_is_in_best_consecutive_hours
        to: "on"
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.heavy_load
      - service: notify.mobile_app
        data:
          title: "⚡ Optimal Charging Time"
          message: >
            Now in best {{ state_attr('sensor.tibber_best_consecutive_hours', 'duration_hours') }}h window!
            Average: {{ state_attr('sensor.tibber_best_consecutive_hours', 'average_price') }}€/kWh

4. Electric Vehicle Charging in Time Window

Perfect for overnight charging (17:00-07:00):

automation:
  - alias: "EV Charging Time Window"
    trigger:
      - platform: state
        entity_id: binary_sensor.tibber_is_time_window_cheap_hour
        to: "on"
    condition:
      - condition: numeric_state
        entity_id: sensor.ev_battery
        below: 80
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.ev_charger
      - service: notify.mobile_app
        data:
          title: "🔌 EV Charging Started"
          message: >
            Charging at {{ states('sensor.tibber_current_price') }}€/kWh
            Time Window: {{ state_attr('sensor.tibber_time_window_cheapest_hours', 'time_window_start') }} -
            {{ state_attr('sensor.tibber_time_window_cheapest_hours', 'time_window_end') }}

5. Dashboard Card

type: entities
title: Tibber Strompreise
entities:
  - entity: sensor.tibber_current_price
    name: Aktueller Preis
  - entity: sensor.tibber_price_level
    name: Preis-Level
  - entity: sensor.tibber_average_price
    name: Durchschnitt
  - type: divider
  - entity: binary_sensor.tibber_is_good_charging_time
    name: Gute Ladezeit
  - entity: binary_sensor.tibber_is_in_best_consecutive_hours
    name: In bestem Zeitfenster
  - entity: binary_sensor.tibber_battery_charging_recommended
    name: Batterie laden empfohlen
  - type: divider
  - entity: sensor.tibber_best_consecutive_hours
    name: Bestes Zeitfenster
  - entity: sensor.tibber_battery_breakeven_price
    name: Batterie Break-Even
  - type: divider
  - entity: sensor.tibber_time_window_cheapest_hours
    name: Günstigste Stunden (Zeitfenster)
  - entity: binary_sensor.tibber_is_time_window_cheap_hour
    name: Zeitfenster aktiv

Services

tibber_extended.calculate_best_time_window

Calculate the cheapest consecutive time window dynamically.

service: tibber_extended.calculate_best_time_window
data:
  duration_hours: 4
  power_kw: 11
  start_after: "14:00"
  end_before: "22:00"
  include_tomorrow: true

Response:

success: true
best_start_time: "15:00"
best_end_time: "19:00"
average_price_window: 0.2145
total_cost: 9.44
savings_vs_average: 1.2

tibber_extended.get_price_forecast

Get detailed price forecast.

service: tibber_extended.get_price_forecast
data:
  hours_ahead: 24

Multi-Home Support

If you have multiple homes in your Tibber account, all homes are automatically detected. Each home gets its own set of sensors with a suffix:

  • Single home: sensor.tibber_current_price
  • Multiple homes: sensor.tibber_current_price_home1, sensor.tibber_current_price_home2

Price Levels Explained

Tibber API automatically calculates price levels based on daily average:

  • VERY_CHEAP: Significantly below average (~< 70%)
  • CHEAP: Below average (~70-90%)
  • NORMAL: Around average (~90-110%)
  • EXPENSIVE: Above average (~110-130%)
  • VERY_EXPENSIVE: Significantly above average (~> 130%)

Exact thresholds are calculated by Tibber.

Technical Details

  • Update Interval: Hourly at XX:00:05 (synced with Tibber's price changes)
  • API: Tibber GraphQL API
  • Timeout: 30 seconds per request
  • Retry Logic: 3 attempts with exponential backoff (1s, 2s, 4s)
  • Data Retention: Last valid data kept during API failures (sensors never go unavailable)
  • Requirements: aiohttp>=3.8.0
  • Home Assistant: 2023.9.0 or newer

Configuration Parameters

Parameter Type Default Description
api_key string required Your Tibber API token
battery_efficiency int 75 Battery efficiency percentage (1-100%)
hours_duration int 3 Hours duration for cheapest/expensive hours and consecutive window (1-24h)
time_window_start time 17:00 Start time for custom time window (HH:MM format)
time_window_end time 07:00 End time for custom time window (HH:MM format, can span midnight)

Time Window Feature

The Time Window feature allows you to define a specific time range (e.g., 17:00-07:00 for overnight) and automatically identifies the cheapest hours within that window. This is perfect for:

  • Electric Vehicle Charging - Charge during the cheapest overnight hours
  • Heat Pumps - Run during cost-effective evening/night periods
  • Battery Storage - Optimize charging cycles
  • Smart Appliances - Schedule energy-intensive tasks

How it works:

  1. Configure your time window (default: 17:00-07:00)
  2. The system finds the N cheapest hours within that window (N = hours_duration)
  3. binary_sensor.tibber_is_time_window_cheap_hour turns ON during those hours
  4. Use this sensor in your automations for optimal cost savings

Example: With time window 17:00-07:00 and hours_duration=3, the system might find:

  • 23:00 (0.1234€/kWh) ✅ Cheapest in window
  • 02:00 (0.1345€/kWh) ✅ 2nd cheapest
  • 03:00 (0.1456€/kWh) ✅ 3rd cheapest

The binary sensor will be ON only during these 3 specific hours.

Troubleshooting

Integration doesn't load

  1. Check Home Assistant logs: Settings → System → Logs
  2. Search for errors containing "tibber_extended"
  3. Verify API key is correct
  4. Check internet connection

Sensors show "unavailable"

Since v1.1.1, sensors should never become unavailable due to API errors - they use cached data instead. If you still see unavailable:

  1. Check the data_status attribute on sensor.{home}_current_price:
    • "live" = Fresh data from API
    • "cached" = Using cached data (API temporarily unavailable)
  2. Check last_successful_update attribute for the last successful fetch time
  3. Verify your Tibber API key is still valid
  4. Check Tibber API status at https://status.tibber.com/
  5. Check Home Assistant logs for errors: Settings → System → Logs

Note: If upgrading from v1.1.0 or earlier, reload the integration to apply the fix.

Tomorrow prices not available

Tomorrow's prices are published by Tibber around 13:00 CET each day.

Entity ID changed after update

Breaking change in v1.0.0:

  • sensor.tibber_best_3_hours → sensor.tibber_best_consecutive_hours
  • binary_sensor.tibber_is_in_best_3h_window → binary_sensor.tibber_is_in_best_consecutive_hours

Update your automations accordingly.

Support

License

MIT License - see LICENSE file for details

Credits

Developed by @misterboe

About

Enhanced Tibber integration for Home Assistant with advanced price sensors, battery optimization, and configurable time windows

Topics

home-assistant homeassistant hacs energy-management custom-component tibber

Resources

Readme

License

MIT license
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 7

v1.3.1 - Translation Fix Latest
Dec 15, 2025
+ 6 releases

Packages

 
 
 

Contributors

Languages