ee9adce9d5
Introduced new documentation files covering various configuration aspects such as chart data export, currency display, general settings, peak price periods, price levels, price ratings, price trends, and volatility. Each section provides detailed explanations of settings, their impacts, and migration guidance for legacy features. Impact: Users gain clear guidance on configuring the Tibber Prices integration, enhancing usability and understanding of features. ### Notes - New files include config-chart-export.md, config-currency.md, config-general.md, config-peak-price.md, config-price-level.md, config-price-rating.md, config-price-trend.md, config-runtime-overrides.md, and config-volatility.md. - Updated sidebar for improved navigation within the documentation.
3.4 KiB
Configuration
:::tip Entity ID tip
<home_name> is a placeholder for your Tibber home display name in Home Assistant. Entity IDs are derived from the displayed name (localized), so the exact slug may differ. Can't find a sensor? Use the Entity Reference (All Languages) to search by name in your language.
:::
Initial Setup
After installing the integration:
- Go to Settings → Devices & Services
- Click + Add Integration
- Search for Tibber Price Information & Ratings
- Enter your API token from developer.tibber.com
- Select your Tibber home from the dropdown (if you have multiple)
- Click Submit — the integration starts fetching price data
The integration will immediately create sensors for your home. Data typically arrives within 1–2 minutes.
Adding Additional Homes
If you have multiple Tibber homes (e.g., different locations):
- Go to Settings → Devices & Services → Tibber Prices
- Click Configure → Add another home
- Select the additional home from the dropdown
- Each home gets its own set of sensors with unique entity IDs
Options Menu
After initial setup, open the configuration menu at:
Settings → Devices & Services → Tibber Prices → Configure
A menu appears with all configuration sections. Pick any section, adjust settings, then return to the menu — there is no required order. All sections have sensible defaults and can be revisited independently at any time.
graph LR
Menu["⚙️ Configure"]
Menu --> GS["⚙️ General Settings"]
Menu --> DS["💱 Currency Display"]
Menu --> PR["📊 Price Rating"]
Menu --> PL["🏷️ Price Level"]
Menu --> VO["💨 Price Volatility"]
Menu --> BP["💚 Best Price Period"]
Menu --> PP["🔴 Peak Price Period"]
Menu --> PT["📈 Price Trend"]
Menu --> CD["📊 Chart Data Export"]
Menu --> RD["🔄 Reset to Defaults"]
style Menu fill:#e6f7ff,stroke:#00b9e7,stroke-width:2px
style BP fill:#e6fff5,stroke:#00c853,stroke-width:2px
style PP fill:#fff0f0,stroke:#ff5252,stroke-width:2px
| Section | What you configure |
|---|---|
| ⚙️ General Settings | Extended descriptions, average sensor display mode (Median / Mean) |
| 💱 Currency Display | Base currency vs. subunit display, price precision |
| 📊 Price Rating | LOW / HIGH thresholds, hysteresis, gap tolerance |
| 🏷️ Price Level | Gap tolerance for Tibber's API-provided level classifications |
| 💨 Price Volatility | CV thresholds for Moderate / High / Very High volatility |
| 💚 Best Price Period | Cheap window detection: flex, distance, relaxation, runtime overrides |
| 🔴 Peak Price Period | Expensive window detection: same settings, opposite direction |
| 📈 Price Trend | Rising / Falling thresholds for trend sensors |
| 📊 Chart Data Export | Legacy chart export sensor (new setups: use Chart Actions) |
Advanced: 🔁 Runtime Override Entities — number and switch entities for automating configuration changes at runtime.