Skip to main content
Version: v0.22.1

Glossary

Quick reference for terms used throughout the documentation.

A​

API Token : Your personal access key from Tibber. Get it at developer.tibber.com.

Attributes : Additional data attached to each sensor (timestamps, statistics, metadata). Access via state_attr() in templates.

B​

Best Price Period : Automatically detected time window with favorable electricity prices. Ideal for scheduling dishwashers, heat pumps, EV charging.

Binary Sensor : Sensor with ON/OFF state (e.g., "Best Price Period Active"). Used in automations as triggers.

C​

Currency Display Mode : Configurable setting for how prices are shown. Choose base currency (€, kr) or subunit (ct, øre). Smart defaults apply: EUR → subunit, NOK/SEK/DKK → base.

Coordinator : Home Assistant component managing data fetching and updates. Polls Tibber API every 15 minutes.

D​

Dynamic Icons : Icons that change based on sensor state (e.g., battery icons showing price level). See Dynamic Icons.

F​

Flex (Flexibility) : Configuration parameter controlling how strict period detection is. Higher flex = more periods found, but potentially at higher prices.

I​

Interval : 15-minute time slot with fixed electricity price (00:00-00:15, 00:15-00:30, etc.).

L​

Level : Price classification within a day (LOWEST, LOW, NORMAL, HIGH, HIGHEST). Based on daily min/max prices.

M​

Min Distance : Threshold requiring periods to be at least X% below daily average. Prevents detecting "cheap" periods during expensive days.

P​

Peak Price Period : Time window with highest electricity prices. Use to avoid heavy consumption.

Price Info : Complete dataset with all intervals (yesterday, today, tomorrow) including enriched statistics.

Q​

Quarter-Hourly : 15-minute precision (4 intervals per hour, 96 per day).

R​

Rating : Statistical price classification (VERY_CHEAP, CHEAP, NORMAL, EXPENSIVE, VERY_EXPENSIVE). Based on 24h averages and thresholds.

Relaxation : Automatic loosening of period detection filters when target period count isn't met. Ensures you always get usable periods.

S​

State : Current value of a sensor (e.g., price in ct/kWh, "ON"/"OFF" for binary sensors).

State Class : Home Assistant classification for long-term statistics (MEASUREMENT, TOTAL, or none).

T​

Trailing Average : Average price over the past 24 hours from current interval.

Leading Average : Average price over the next 24 hours from current interval.

V​

Volatility : Measure of price stability (LOW, MEDIUM, HIGH). High volatility = large price swings = good for timing optimization.

💡 See Also: