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

• Issues: https://github.com/misterboe/tibber-extended/issues
• Tibber Developer Docs: https://developer.tibber.com/
• Home Assistant Community: https://community.home-assistant.io/

License

MIT License - see LICENSE file for details

Credits

Developed by @misterboe