mirror of
https://github.com/jpawlowski/hass.tibber_prices.git
synced 2026-03-30 05:13:40 +00:00
fb70f29ac9
Complete overhaul of the ApexCharts integration service layer to support modern chart card workflows with flexible data formatting and filtering. Replaced services: - Removed: get_price, get_apexcharts_data (legacy, entity-based) - Added: get_chartdata (flexible data service) - Improved: get_apexcharts_yaml (now uses get_chartdata internally) New get_chartdata service features: - Multiple output formats (array_of_objects, array_of_arrays) - Customizable field names for chart compatibility - Resolution options (15-min intervals, hourly averages) - Advanced filtering (level_filter, rating_level_filter) - NULL insertion modes (none, segments, all) for clean gaps - Minor currency support (cents/øre) with custom rounding - Optional fields (level, rating_level, average) - Multi-day support (yesterday/today/tomorrow) Enhanced get_apexcharts_yaml service: - Direct entry_id parameter (no entity_id lookup needed) - Uses get_chartdata with WebSocket API (data_generator) - Improved ApexCharts configuration: * Gradient fill (70% opacity → 20%) * Grid styling with dashed lines * Zoom & Pan tools (animations disabled for performance) * Optimized legend (top-left, compact markers) * Y-axis auto-scaling (min: 0 for visibility, supports negative prices) * 2 decimal places (improved precision) * Browser locale formatting (automatic comma/point) * insert_nulls='segments' for clean gaps between levels - Multi-language support (translated titles, series names) - Day selection (yesterday/today/tomorrow with correct span config) Service translations: - Added comprehensive field descriptions (all 5 languages: de, en, nb, nl, sv) - Selector translations for all options (day, resolution, output_format, etc.) - ApexCharts title translations in custom_translations/ Technical improvements: - Hourly aggregation uses exact 4-interval windows (:00/:15/:30/:45) - Level/rating aggregation follows sensor logic (aggregate_level_data, aggregate_rating_data) - Midnight extension for last interval of filtered data (seamless day transitions) - Case-insensitive filter matching (normalized to uppercase) - Ruff complexity fixed (extracted _get_level_translation helper) Impact: Users can now generate production-ready ApexCharts YAML with a single service call, or use get_chartdata flexibly with any chart card (ApexCharts, Plotly, Mini Graph, etc.). Supports complex filtering scenarios (e.g., "show only LOW rating periods") with clean visual gaps. Full multi-language support.
851 lines
39 KiB
JSON
851 lines
39 KiB
JSON
{
|
||
"config": {
|
||
"step": {
|
||
"user": {
|
||
"description": "Set up Tibber Price Information & Ratings.\n\nTo generate an API access token, visit https://developer.tibber.com.",
|
||
"data": {
|
||
"access_token": "API access token"
|
||
},
|
||
"submit": "Validate Token"
|
||
},
|
||
"select_home": {
|
||
"description": "Select a home to fetch price information and ratings.",
|
||
"data": {
|
||
"home_id": "Home"
|
||
},
|
||
"title": "Pick a Home",
|
||
"submit": "Select Home"
|
||
},
|
||
"finish": {
|
||
"description": "Select a home to fetch price information and ratings.",
|
||
"data": {
|
||
"home_id": "Home ID"
|
||
},
|
||
"title": "Pick a home",
|
||
"submit": "Select Home"
|
||
},
|
||
"reauth_confirm": {
|
||
"title": "Reauthenticate Tibber Price Integration",
|
||
"description": "The access token for Tibber is no longer valid. Please enter a new API access token to continue using this integration.\n\nTo generate a new API access token, visit https://developer.tibber.com.",
|
||
"data": {
|
||
"access_token": "API access token"
|
||
},
|
||
"submit": "Update Token"
|
||
}
|
||
},
|
||
"error": {
|
||
"auth": "The Tibber Access Token is invalid.",
|
||
"connection": "Unable to connect to Tibber. Please check your internet connection.",
|
||
"unknown": "Unexpected error",
|
||
"cannot_connect": "Failed to connect",
|
||
"invalid_access_token": "Invalid access token",
|
||
"missing_homes": "The new access token does not have access to all configured homes. Please use an access token that has access to the same Tibber homes."
|
||
},
|
||
"abort": {
|
||
"already_configured": "Integration is already configured",
|
||
"entry_not_found": "Tibber configuration entry not found.",
|
||
"setup_complete": "Setup complete! You can change additional options for Tibber Prices in the integration's options after closing this dialog.",
|
||
"reauth_successful": "Reauthentication successful. The integration has been updated with the new access token."
|
||
}
|
||
},
|
||
"common": {
|
||
"step_progress": "Step {step_num} of {total_steps}"
|
||
},
|
||
"config_subentries": {
|
||
"home": {
|
||
"initiate_flow": {
|
||
"user": "Add Tibber Home"
|
||
},
|
||
"title": "Add Tibber Home",
|
||
"step": {
|
||
"user": {
|
||
"title": "Add Tibber Home",
|
||
"description": "Select a home to add to your Tibber integration.\n\n**Note:** After adding this home, you can add additional homes from the integration's context menu by selecting \"Add Tibber Home\".",
|
||
"data": {
|
||
"home_id": "Home"
|
||
}
|
||
}
|
||
},
|
||
"error": {
|
||
"api_error": "Failed to fetch homes from Tibber API"
|
||
},
|
||
"abort": {
|
||
"no_parent_entry": "Parent entry not found",
|
||
"no_access_token": "No access token available",
|
||
"home_not_found": "Selected home not found",
|
||
"api_error": "Failed to fetch homes from Tibber API",
|
||
"no_available_homes": "No additional homes available to add. All homes from your Tibber account have already been added."
|
||
}
|
||
}
|
||
},
|
||
"options": {
|
||
"step": {
|
||
"init": {
|
||
"title": "General Settings",
|
||
"description": "{step_progress}\n\nConfigure general settings for Tibber Price Information & Ratings.\n\nUser: {user_login}",
|
||
"data": {
|
||
"extended_descriptions": "Show extended descriptions in entity attributes"
|
||
},
|
||
"submit": "Next to Step 2"
|
||
},
|
||
"current_interval_price_rating": {
|
||
"title": "Price Rating Thresholds",
|
||
"description": "{step_progress}\n\nConfigure thresholds for price rating levels (low/normal/high) based on comparison with trailing 24-hour average.",
|
||
"data": {
|
||
"price_rating_threshold_low": "Low Rating Threshold (below trailing average)",
|
||
"price_rating_threshold_high": "High Rating Threshold (above trailing average)"
|
||
},
|
||
"submit": "Next to Step 3"
|
||
},
|
||
"best_price": {
|
||
"title": "Best Price Period Settings",
|
||
"description": "{step_progress}\n\nConfigure settings for the Best Price Period binary sensor. This sensor is active during periods with the lowest electricity prices.",
|
||
"data": {
|
||
"best_price_min_period_length": "Minimum Period Length",
|
||
"best_price_flex": "Flexibility: Maximum above minimum price",
|
||
"best_price_min_distance_from_avg": "Minimum Distance: Required below daily average",
|
||
"best_price_max_level": "Price Level Filter (Optional)",
|
||
"best_price_max_level_gap_count": "Level Filter Gap Tolerance",
|
||
"enable_min_periods_best": "Try to Achieve Minimum Period Count",
|
||
"min_periods_best": "Minimum Periods Required",
|
||
"relaxation_step_best": "Filter Relaxation Step Size",
|
||
"relaxation_attempts_best": "Relaxation Attempts"
|
||
},
|
||
"data_description": {
|
||
"best_price_max_level": "Only show best price periods if they contain intervals with price levels ≤ selected value. For example, selecting 'Cheap' means the period must have at least one 'VERY_CHEAP' or 'CHEAP' interval. This ensures 'best price' periods are not just relatively cheap for the day, but actually cheap in absolute terms. Select 'Any' to show best prices regardless of their absolute price level.",
|
||
"best_price_max_level_gap_count": "Maximum number of consecutive intervals allowed that deviate by exactly one level step from the required level. For example: with 'Cheap' filter and gap count 1, a sequence 'CHEAP, CHEAP, NORMAL, CHEAP' is accepted (NORMAL is one step above CHEAP). This prevents periods from being split by occasional level deviations. Default: 0 (strict filtering, no tolerance).",
|
||
"enable_min_periods_best": "When enabled, filters will be gradually relaxed if not enough periods are found. This attempts to reach the desired minimum number of periods, which may include less optimal time windows as best-price periods.",
|
||
"min_periods_best": "Minimum number of best price periods to aim for per day. Filters will be relaxed step-by-step to try achieving this count. Only active when 'Try to Achieve Minimum Period Count' is enabled. Default: 1",
|
||
"relaxation_step_best": "Percentage of the original flexibility threshold to add per relaxation step. For example: with 15% flexibility and 25% step size, filters will try 15%, 18.75%, 22.5%, etc. Higher values mean faster relaxation but less precision.",
|
||
"relaxation_attempts_best": "How many flex levels (attempts) to try before giving up. Each attempt runs all filter combinations at the new flex level. More attempts increase the chance of finding additional periods at the cost of longer processing time."
|
||
},
|
||
"submit": "Next to Step 5"
|
||
},
|
||
"peak_price": {
|
||
"title": "Peak Price Period Settings",
|
||
"description": "{step_progress}\n\nConfigure settings for the Peak Price Period binary sensor. This sensor is active during periods with the highest electricity prices.",
|
||
"data": {
|
||
"peak_price_min_period_length": "Minimum Period Length",
|
||
"peak_price_flex": "Flexibility: Maximum below maximum price (negative value)",
|
||
"peak_price_min_distance_from_avg": "Minimum Distance: Required above daily average",
|
||
"peak_price_min_level": "Price Level Filter (Optional)",
|
||
"peak_price_max_level_gap_count": "Level Filter Gap Tolerance",
|
||
"enable_min_periods_peak": "Try to Achieve Minimum Period Count",
|
||
"min_periods_peak": "Minimum Periods Required",
|
||
"relaxation_step_peak": "Filter Relaxation Step Size",
|
||
"relaxation_attempts_peak": "Relaxation Attempts"
|
||
},
|
||
"data_description": {
|
||
"peak_price_min_level": "Only show peak price periods if they contain intervals with price levels ≥ selected value. For example, selecting 'Expensive' means the period must have at least one 'EXPENSIVE' or 'VERY_EXPENSIVE' interval. This ensures 'peak price' periods are not just relatively expensive for the day, but actually expensive in absolute terms. Select 'Any' to show peak prices regardless of their absolute price level.",
|
||
"peak_price_max_level_gap_count": "Maximum number of consecutive intervals allowed that deviate by exactly one level step from the required level. For example: with 'Expensive' filter and gap count 2, a sequence 'EXPENSIVE, NORMAL, NORMAL, EXPENSIVE' is accepted (NORMAL is one step below EXPENSIVE). This prevents periods from being split by occasional level deviations. Default: 0 (strict filtering, no tolerance).",
|
||
"enable_min_periods_peak": "When enabled, filters will be gradually relaxed if not enough periods are found. This attempts to reach the desired minimum number of periods to ensure you're warned about expensive periods even on days with unusual price patterns.",
|
||
"min_periods_peak": "Minimum number of peak price periods to aim for per day. Filters will be relaxed step-by-step to try achieving this count. Only active when 'Try to Achieve Minimum Period Count' is enabled. Default: 1",
|
||
"relaxation_step_peak": "Percentage of the original flexibility threshold to add per relaxation step. For example: with -15% flexibility and 25% step size, filters will try -15%, -18.75%, -22.5%, etc. Higher values mean faster relaxation but less precision.",
|
||
"relaxation_attempts_peak": "How many flex levels (attempts) to try before giving up. Each attempt runs all filter combinations at the new flex level. More attempts increase the chance of finding additional peak periods at the cost of longer processing time."
|
||
},
|
||
"submit": "Next to Step 6"
|
||
},
|
||
"price_trend": {
|
||
"title": "Price Trend Thresholds",
|
||
"description": "{step_progress}\n\nConfigure thresholds for price trend sensors. These sensors compare the current price with the average of the next N hours to determine if prices are rising, falling, or stable.",
|
||
"data": {
|
||
"price_trend_threshold_rising": "Rising Threshold (above current price)",
|
||
"price_trend_threshold_falling": "Falling Threshold (below current price, negative value)"
|
||
},
|
||
"submit": "Complete Configuration"
|
||
},
|
||
"volatility": {
|
||
"title": "Price Volatility Thresholds",
|
||
"description": "{step_progress}\n\nConfigure thresholds for volatility classification. Volatility measures relative price variation using the coefficient of variation (CV = standard deviation / mean × 100%). These thresholds are percentage values that work across all price levels.\n\nUsed by:\n• Volatility sensors (classification)\n• Trend sensors (adaptive threshold adjustment: <moderate = more sensitive, ≥high = less sensitive)",
|
||
"data": {
|
||
"volatility_threshold_moderate": "Moderate Threshold (CV ≥ this %, e.g., 15)",
|
||
"volatility_threshold_high": "High Threshold (CV ≥ this %, e.g., 30)",
|
||
"volatility_threshold_very_high": "Very High Threshold (CV ≥ this %, e.g., 50)"
|
||
},
|
||
"submit": "Next to Step 4"
|
||
}
|
||
},
|
||
"error": {
|
||
"auth": "The Tibber Access Token is invalid.",
|
||
"connection": "Unable to connect to Tibber. Please check your internet connection.",
|
||
"unknown": "An unexpected error occurred. Please check the logs for details.",
|
||
"cannot_connect": "Failed to connect",
|
||
"invalid_access_token": "Invalid access token",
|
||
"different_home": "The access token is not valid for the home ID this integration is configured for."
|
||
},
|
||
"abort": {
|
||
"entry_not_found": "Tibber configuration entry not found."
|
||
}
|
||
},
|
||
"entity": {
|
||
"sensor": {
|
||
"current_interval_price": {
|
||
"name": "Current Electricity Price"
|
||
},
|
||
"current_interval_price_major": {
|
||
"name": "Current Electricity Price (Energy Dashboard)"
|
||
},
|
||
"next_interval_price": {
|
||
"name": "Next Electricity Price"
|
||
},
|
||
"previous_interval_price": {
|
||
"name": "Previous Electricity Price"
|
||
},
|
||
"current_hour_average_price": {
|
||
"name": "⌀ Hourly Price Current"
|
||
},
|
||
"next_hour_average_price": {
|
||
"name": "⌀ Hourly Price Next"
|
||
},
|
||
"current_interval_price_level": {
|
||
"name": "Current Price Level",
|
||
"state": {
|
||
"very_cheap": "Very Cheap",
|
||
"cheap": "Cheap",
|
||
"normal": "Normal",
|
||
"expensive": "Expensive",
|
||
"very_expensive": "Very Expensive"
|
||
}
|
||
},
|
||
"next_interval_price_level": {
|
||
"name": "Next Price Level",
|
||
"state": {
|
||
"very_cheap": "Very Cheap",
|
||
"cheap": "Cheap",
|
||
"normal": "Normal",
|
||
"expensive": "Expensive",
|
||
"very_expensive": "Very Expensive"
|
||
}
|
||
},
|
||
"previous_interval_price_level": {
|
||
"name": "Previous Price Level",
|
||
"state": {
|
||
"very_cheap": "Very Cheap",
|
||
"cheap": "Cheap",
|
||
"normal": "Normal",
|
||
"expensive": "Expensive",
|
||
"very_expensive": "Very Expensive"
|
||
}
|
||
},
|
||
"current_hour_price_level": {
|
||
"name": "Current Hour Price Level",
|
||
"state": {
|
||
"very_cheap": "Very Cheap",
|
||
"cheap": "Cheap",
|
||
"normal": "Normal",
|
||
"expensive": "Expensive",
|
||
"very_expensive": "Very Expensive"
|
||
}
|
||
},
|
||
"next_hour_price_level": {
|
||
"name": "Next Hour Price Level",
|
||
"state": {
|
||
"very_cheap": "Very Cheap",
|
||
"cheap": "Cheap",
|
||
"normal": "Normal",
|
||
"expensive": "Expensive",
|
||
"very_expensive": "Very Expensive"
|
||
}
|
||
},
|
||
"lowest_price_today": {
|
||
"name": "Today's Lowest Price"
|
||
},
|
||
"highest_price_today": {
|
||
"name": "Today's Highest Price"
|
||
},
|
||
"average_price_today": {
|
||
"name": "⌀ Price Today"
|
||
},
|
||
"lowest_price_tomorrow": {
|
||
"name": "Tomorrow's Lowest Price"
|
||
},
|
||
"highest_price_tomorrow": {
|
||
"name": "Tomorrow's Highest Price"
|
||
},
|
||
"average_price_tomorrow": {
|
||
"name": "⌀ Price Tomorrow"
|
||
},
|
||
"yesterday_price_level": {
|
||
"name": "Yesterday's Price Level",
|
||
"state": {
|
||
"very_cheap": "Very Cheap",
|
||
"cheap": "Cheap",
|
||
"normal": "Normal",
|
||
"expensive": "Expensive",
|
||
"very_expensive": "Very Expensive"
|
||
}
|
||
},
|
||
"today_price_level": {
|
||
"name": "Today's Price Level",
|
||
"state": {
|
||
"very_cheap": "Very Cheap",
|
||
"cheap": "Cheap",
|
||
"normal": "Normal",
|
||
"expensive": "Expensive",
|
||
"very_expensive": "Very Expensive"
|
||
}
|
||
},
|
||
"tomorrow_price_level": {
|
||
"name": "Tomorrow's Price Level",
|
||
"state": {
|
||
"very_cheap": "Very Cheap",
|
||
"cheap": "Cheap",
|
||
"normal": "Normal",
|
||
"expensive": "Expensive",
|
||
"very_expensive": "Very Expensive"
|
||
}
|
||
},
|
||
"yesterday_price_rating": {
|
||
"name": "Yesterday's Price Rating",
|
||
"state": {
|
||
"low": "Low",
|
||
"normal": "Normal",
|
||
"high": "High"
|
||
}
|
||
},
|
||
"today_price_rating": {
|
||
"name": "Today's Price Rating",
|
||
"state": {
|
||
"low": "Low",
|
||
"normal": "Normal",
|
||
"high": "High"
|
||
}
|
||
},
|
||
"tomorrow_price_rating": {
|
||
"name": "Tomorrow's Price Rating",
|
||
"state": {
|
||
"low": "Low",
|
||
"normal": "Normal",
|
||
"high": "High"
|
||
}
|
||
},
|
||
"trailing_price_average": {
|
||
"name": "⌀ Price Trailing 24h"
|
||
},
|
||
"leading_price_average": {
|
||
"name": "⌀ Price Leading 24h"
|
||
},
|
||
"trailing_price_min": {
|
||
"name": "Trailing 24h Minimum Price"
|
||
},
|
||
"trailing_price_max": {
|
||
"name": "Trailing 24h Maximum Price"
|
||
},
|
||
"leading_price_min": {
|
||
"name": "Leading 24h Minimum Price"
|
||
},
|
||
"leading_price_max": {
|
||
"name": "Leading 24h Maximum Price"
|
||
},
|
||
"current_interval_price_rating": {
|
||
"name": "Current Price Rating",
|
||
"state": {
|
||
"low": "Low",
|
||
"normal": "Normal",
|
||
"high": "High"
|
||
}
|
||
},
|
||
"next_interval_price_rating": {
|
||
"name": "Next Price Rating",
|
||
"state": {
|
||
"low": "Low",
|
||
"normal": "Normal",
|
||
"high": "High"
|
||
}
|
||
},
|
||
"previous_interval_price_rating": {
|
||
"name": "Previous Price Rating",
|
||
"state": {
|
||
"low": "Low",
|
||
"normal": "Normal",
|
||
"high": "High"
|
||
}
|
||
},
|
||
"current_hour_price_rating": {
|
||
"name": "Current Hour Price Rating",
|
||
"state": {
|
||
"low": "Low",
|
||
"normal": "Normal",
|
||
"high": "High"
|
||
}
|
||
},
|
||
"next_hour_price_rating": {
|
||
"name": "Next Hour Price Rating",
|
||
"state": {
|
||
"low": "Low",
|
||
"normal": "Normal",
|
||
"high": "High"
|
||
}
|
||
},
|
||
"next_avg_1h": {
|
||
"name": "⌀ Price Next 1h"
|
||
},
|
||
"next_avg_2h": {
|
||
"name": "⌀ Price Next 2h"
|
||
},
|
||
"next_avg_3h": {
|
||
"name": "⌀ Price Next 3h"
|
||
},
|
||
"next_avg_4h": {
|
||
"name": "⌀ Price Next 4h"
|
||
},
|
||
"next_avg_5h": {
|
||
"name": "⌀ Price Next 5h"
|
||
},
|
||
"next_avg_6h": {
|
||
"name": "⌀ Price Next 6h"
|
||
},
|
||
"next_avg_8h": {
|
||
"name": "⌀ Price Next 8h"
|
||
},
|
||
"next_avg_12h": {
|
||
"name": "⌀ Price Next 12h"
|
||
},
|
||
"price_trend_1h": {
|
||
"name": "Price Trend (1h)",
|
||
"state": {
|
||
"rising": "Rising",
|
||
"falling": "Falling",
|
||
"stable": "Stable"
|
||
}
|
||
},
|
||
"price_trend_2h": {
|
||
"name": "Price Trend (2h)",
|
||
"state": {
|
||
"rising": "Rising",
|
||
"falling": "Falling",
|
||
"stable": "Stable"
|
||
}
|
||
},
|
||
"price_trend_3h": {
|
||
"name": "Price Trend (3h)",
|
||
"state": {
|
||
"rising": "Rising",
|
||
"falling": "Falling",
|
||
"stable": "Stable"
|
||
}
|
||
},
|
||
"price_trend_4h": {
|
||
"name": "Price Trend (4h)",
|
||
"state": {
|
||
"rising": "Rising",
|
||
"falling": "Falling",
|
||
"stable": "Stable"
|
||
}
|
||
},
|
||
"price_trend_5h": {
|
||
"name": "Price Trend (5h)",
|
||
"state": {
|
||
"rising": "Rising",
|
||
"falling": "Falling",
|
||
"stable": "Stable"
|
||
}
|
||
},
|
||
"price_trend_6h": {
|
||
"name": "Price Trend (6h)",
|
||
"state": {
|
||
"rising": "Rising",
|
||
"falling": "Falling",
|
||
"stable": "Stable"
|
||
}
|
||
},
|
||
"price_trend_8h": {
|
||
"name": "Price Trend (8h)",
|
||
"state": {
|
||
"rising": "Rising",
|
||
"falling": "Falling",
|
||
"stable": "Stable"
|
||
}
|
||
},
|
||
"price_trend_12h": {
|
||
"name": "Price Trend (12h)",
|
||
"state": {
|
||
"rising": "Rising",
|
||
"falling": "Falling",
|
||
"stable": "Stable"
|
||
}
|
||
},
|
||
"current_price_trend": {
|
||
"name": "Current Price Trend",
|
||
"state": {
|
||
"rising": "Rising",
|
||
"falling": "Falling",
|
||
"stable": "Stable"
|
||
}
|
||
},
|
||
"next_price_trend_change": {
|
||
"name": "Next Price Trend Change"
|
||
},
|
||
"daily_rating": {
|
||
"name": "Daily Price Rating"
|
||
},
|
||
"monthly_rating": {
|
||
"name": "Monthly Price Rating"
|
||
},
|
||
"data_timestamp": {
|
||
"name": "Price Data Expiration"
|
||
},
|
||
"today_volatility": {
|
||
"name": "Today's Price Volatility",
|
||
"state": {
|
||
"low": "Low",
|
||
"moderate": "Moderate",
|
||
"high": "High",
|
||
"very_high": "Very High"
|
||
}
|
||
},
|
||
"tomorrow_volatility": {
|
||
"name": "Tomorrow's Price Volatility",
|
||
"state": {
|
||
"low": "Low",
|
||
"moderate": "Moderate",
|
||
"high": "High",
|
||
"very_high": "Very High"
|
||
}
|
||
},
|
||
"next_24h_volatility": {
|
||
"name": "Next 24h Price Volatility",
|
||
"state": {
|
||
"low": "Low",
|
||
"moderate": "Moderate",
|
||
"high": "High",
|
||
"very_high": "Very High"
|
||
}
|
||
},
|
||
"today_tomorrow_volatility": {
|
||
"name": "Today+Tomorrow Price Volatility",
|
||
"state": {
|
||
"low": "Low",
|
||
"moderate": "Moderate",
|
||
"high": "High",
|
||
"very_high": "Very High"
|
||
}
|
||
},
|
||
"best_price_end_time": {
|
||
"name": "Best Price End"
|
||
},
|
||
"best_price_period_duration": {
|
||
"name": "Best Price Duration"
|
||
},
|
||
"best_price_remaining_minutes": {
|
||
"name": "Best Price Remaining Time"
|
||
},
|
||
"best_price_progress": {
|
||
"name": "Best Price Progress"
|
||
},
|
||
"best_price_next_start_time": {
|
||
"name": "Best Price Start"
|
||
},
|
||
"best_price_next_in_minutes": {
|
||
"name": "Best Price Starts In"
|
||
},
|
||
"peak_price_end_time": {
|
||
"name": "Peak Price End"
|
||
},
|
||
"peak_price_period_duration": {
|
||
"name": "Peak Price Duration"
|
||
},
|
||
"peak_price_remaining_minutes": {
|
||
"name": "Peak Price Remaining Time"
|
||
},
|
||
"peak_price_progress": {
|
||
"name": "Peak Price Progress"
|
||
},
|
||
"peak_price_next_start_time": {
|
||
"name": "Peak Price Start"
|
||
},
|
||
"peak_price_next_in_minutes": {
|
||
"name": "Peak Price Starts In"
|
||
},
|
||
"price_forecast": {
|
||
"name": "Price Forecast"
|
||
},
|
||
"home_type": {
|
||
"name": "Home Type",
|
||
"state": {
|
||
"apartment": "Apartment",
|
||
"rowhouse": "Rowhouse",
|
||
"house": "House",
|
||
"cottage": "Cottage"
|
||
}
|
||
},
|
||
"home_size": {
|
||
"name": "Home Size"
|
||
},
|
||
"main_fuse_size": {
|
||
"name": "Main Fuse Size"
|
||
},
|
||
"number_of_residents": {
|
||
"name": "Number of Residents"
|
||
},
|
||
"primary_heating_source": {
|
||
"name": "Primary Heating Source",
|
||
"state": {
|
||
"air2air_heatpump": "Air-to-Air Heat Pump",
|
||
"air2water_heatpump": "Air-to-Water Heat Pump",
|
||
"boiler": "Boiler",
|
||
"central_heating": "Central Heating",
|
||
"district_heating": "District Heating",
|
||
"district": "District Heating",
|
||
"electric_boiler": "Electric Boiler",
|
||
"electricity": "Electricity",
|
||
"floor": "Floor Heating",
|
||
"gas": "Gas",
|
||
"ground_heatpump": "Ground Heat Pump",
|
||
"ground": "Ground Heat Pump",
|
||
"oil": "Oil",
|
||
"other": "Other",
|
||
"waste": "Waste Heat"
|
||
}
|
||
},
|
||
"grid_company": {
|
||
"name": "Grid Company"
|
||
},
|
||
"grid_area_code": {
|
||
"name": "Grid Area Code"
|
||
},
|
||
"price_area_code": {
|
||
"name": "Price Area Code"
|
||
},
|
||
"consumption_ean": {
|
||
"name": "Consumption EAN"
|
||
},
|
||
"production_ean": {
|
||
"name": "Production EAN"
|
||
},
|
||
"energy_tax_type": {
|
||
"name": "Energy Tax Type"
|
||
},
|
||
"vat_type": {
|
||
"name": "VAT Type"
|
||
},
|
||
"estimated_annual_consumption": {
|
||
"name": "Estimated Annual Consumption"
|
||
},
|
||
"subscription_status": {
|
||
"name": "Subscription Status",
|
||
"state": {
|
||
"running": "Running",
|
||
"ended": "Ended",
|
||
"pending": "Pending",
|
||
"unknown": "Unknown"
|
||
}
|
||
}
|
||
},
|
||
"binary_sensor": {
|
||
"peak_price_period": {
|
||
"name": "Peak Price Period"
|
||
},
|
||
"best_price_period": {
|
||
"name": "Best Price Period"
|
||
},
|
||
"connection": {
|
||
"name": "Tibber API Connection"
|
||
},
|
||
"tomorrow_data_available": {
|
||
"name": "Tomorrow's Data Available"
|
||
},
|
||
"has_ventilation_system": {
|
||
"name": "Has Ventilation System"
|
||
},
|
||
"realtime_consumption_enabled": {
|
||
"name": "Realtime Consumption Enabled"
|
||
}
|
||
}
|
||
},
|
||
"issues": {
|
||
"new_homes_available": {
|
||
"title": "New Tibber homes detected",
|
||
"description": "We detected {count} new home(s) on your Tibber account: {homes}. You can add them to Home Assistant through the Tibber integration configuration."
|
||
},
|
||
"homes_removed": {
|
||
"title": "Tibber homes removed",
|
||
"description": "We detected that {count} home(s) have been removed from your Tibber account: {homes}. Please review your Tibber integration configuration."
|
||
}
|
||
},
|
||
"services": {
|
||
"get_apexcharts_yaml": {
|
||
"name": "Get ApexCharts Card YAML",
|
||
"description": "Returns a ready-to-copy YAML snippet for an ApexCharts card visualizing Tibber Prices for the selected day. Use this to easily add a pre-configured chart to your dashboard. The YAML will use the get_chartdata service for data.",
|
||
"fields": {
|
||
"entry_id": {
|
||
"name": "Entry ID",
|
||
"description": "The config entry ID for the Tibber integration."
|
||
},
|
||
"day": {
|
||
"name": "Day",
|
||
"description": "Which day to visualize (yesterday, today, or tomorrow)."
|
||
},
|
||
"level_type": {
|
||
"name": "Level Type",
|
||
"description": "Select which price level classification to visualize: 'rating_level' (low/normal/high based on your configured thresholds) or 'level' (Tibber API levels: very cheap/cheap/normal/expensive/very expensive)."
|
||
}
|
||
}
|
||
},
|
||
"get_chartdata": {
|
||
"name": "Get Chart Data",
|
||
"description": "Returns price data in a simple chart-friendly format compatible with the Tibber Core integration output structure. Perfect for use with popular chart cards like ha-price-timeline-card, ApexCharts Card, Plotly Graph Card, Mini Graph Card, or the built-in History Graph Card. Field names and data structure can be customized to match your specific chart requirements.",
|
||
"fields": {
|
||
"entry_id": {
|
||
"name": "Entry ID",
|
||
"description": "The config entry ID for the Tibber integration."
|
||
},
|
||
"day": {
|
||
"name": "Day",
|
||
"description": "Which day(s) to fetch prices for. You can select multiple days. If not specified, returns all available data (today + tomorrow if available)."
|
||
},
|
||
"resolution": {
|
||
"name": "Resolution",
|
||
"description": "Time resolution for the returned data. Options: 'interval' (default, 15-minute intervals, 96 points per day), 'hourly' (hourly averages, 24 points per day)."
|
||
},
|
||
"output_format": {
|
||
"name": "Output Format",
|
||
"description": "Output format for the returned data. Options: 'array_of_objects' (default, array of objects with customizable field names), 'array_of_arrays' (array of [timestamp, price] arrays with trailing null point for stepline charts)."
|
||
},
|
||
"array_fields": {
|
||
"name": "Array Fields (Array of Arrays only)",
|
||
"description": "[ONLY FOR Array of Arrays FORMAT] Define which fields to include. Use field names in curly braces, separated by commas. Available fields: start_time, price_per_kwh, level, rating_level, average. Fields will be automatically enabled even if include_* options are not set. Leave empty for default (timestamp and price only)."
|
||
},
|
||
"minor_currency": {
|
||
"name": "Minor Currency",
|
||
"description": "Return prices in minor currency units (cents for EUR, øre for NOK/SEK) instead of major currency units. Disabled by default."
|
||
},
|
||
"round_decimals": {
|
||
"name": "Round Decimals",
|
||
"description": "Number of decimal places to round prices to (0-10). If not specified, uses default precision (4 decimals for major currency, 2 for minor currency)."
|
||
},
|
||
"include_level": {
|
||
"name": "Include Level (Array of Objects only)",
|
||
"description": "[ONLY FOR Array of Objects FORMAT] Include the Tibber price level field (VERY_CHEAP, CHEAP, NORMAL, EXPENSIVE, VERY_EXPENSIVE) in each data point."
|
||
},
|
||
"include_rating_level": {
|
||
"name": "Include Rating Level (Array of Objects only)",
|
||
"description": "[ONLY FOR Array of Objects FORMAT] Include the calculated rating level field (LOW, NORMAL, HIGH) based on your configured thresholds in each data point."
|
||
},
|
||
"include_average": {
|
||
"name": "Include Average (Array of Objects only)",
|
||
"description": "[ONLY FOR Array of Objects FORMAT] Include the daily average price in each data point for comparison."
|
||
},
|
||
"level_filter": {
|
||
"name": "Level Filter",
|
||
"description": "Filter intervals to include only specific Tibber price levels (VERY_CHEAP, CHEAP, NORMAL, EXPENSIVE, VERY_EXPENSIVE). If not specified, all levels are included."
|
||
},
|
||
"rating_level_filter": {
|
||
"name": "Rating Level Filter",
|
||
"description": "Filter intervals to include only specific rating levels (LOW, NORMAL, HIGH). If not specified, all rating levels are included."
|
||
},
|
||
"insert_nulls": {
|
||
"name": "Insert NULL Values",
|
||
"description": "Control NULL value insertion for filtered data. 'none' (default): No NULL values, only matching intervals. 'segments': Add NULL points at segment boundaries for clean gaps in charts (recommended for stepline charts). 'all': Insert NULL for all timestamps where filter doesn't match (useful for continuous time series visualization)."
|
||
},
|
||
"add_trailing_null": {
|
||
"name": "Add Trailing Null Point",
|
||
"description": "[BOTH FORMATS] Add a final data point with null values (except timestamp) at the end. Some chart libraries need this to prevent extrapolation/interpolation to the viewport edge when using stepline rendering. Leave disabled unless your chart requires it."
|
||
},
|
||
"timestamp_field": {
|
||
"name": "Timestamp Field Name (Array of Objects only)",
|
||
"description": "[ONLY FOR Array of Objects FORMAT] Custom name for the timestamp field in the output. Defaults to 'start_time' if not specified."
|
||
},
|
||
"price_field": {
|
||
"name": "Price Field Name (Array of Objects only)",
|
||
"description": "[ONLY FOR Array of Objects FORMAT] Custom name for the price field in the output. Defaults to 'price_per_kwh' if not specified."
|
||
},
|
||
"level_field": {
|
||
"name": "Level Field Name (Array of Objects only)",
|
||
"description": "[ONLY FOR Array of Objects FORMAT] Custom name for the level field in the output. Defaults to 'level' if not specified. Only used when include_level is enabled."
|
||
},
|
||
"rating_level_field": {
|
||
"name": "Rating Level Field Name (Array of Objects only)",
|
||
"description": "[ONLY FOR Array of Objects FORMAT] Custom name for the rating_level field in the output. Defaults to 'rating_level' if not specified. Only used when include_rating_level is enabled."
|
||
},
|
||
"average_field": {
|
||
"name": "Average Field Name (Array of Objects only)",
|
||
"description": "[ONLY FOR Array of Objects FORMAT] Custom name for the average field in the output. Defaults to 'average' if not specified. Only used when include_average is enabled."
|
||
},
|
||
"data_key": {
|
||
"name": "Data Key (both formats)",
|
||
"description": "[BOTH FORMATS] Custom name for the top-level data key in the response. Defaults to 'data' if not specified. For ApexCharts compatibility with Array of Arrays, use 'points'."
|
||
}
|
||
}
|
||
},
|
||
"refresh_user_data": {
|
||
"name": "Refresh User Data",
|
||
"description": "Forces a refresh of the user data (homes, profile information) from the Tibber API. This can be useful after making changes to your Tibber account or when troubleshooting connectivity issues.",
|
||
"fields": {
|
||
"entry_id": {
|
||
"name": "Entry ID",
|
||
"description": "The config entry ID for the Tibber integration."
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"selector": {
|
||
"day": {
|
||
"options": {
|
||
"yesterday": "Yesterday",
|
||
"today": "Today",
|
||
"tomorrow": "Tomorrow"
|
||
}
|
||
},
|
||
"resolution": {
|
||
"options": {
|
||
"interval": "Interval (15 min)",
|
||
"hourly": "Hourly"
|
||
}
|
||
},
|
||
"output_format": {
|
||
"options": {
|
||
"array_of_objects": "Array of Objects",
|
||
"array_of_arrays": "Array of Arrays"
|
||
}
|
||
},
|
||
"level_type": {
|
||
"options": {
|
||
"rating_level": "Rating Level (low/normal/high)",
|
||
"level": "Tibber Level (very cheap to very expensive)"
|
||
}
|
||
},
|
||
"level_filter": {
|
||
"options": {
|
||
"very_cheap": "Very cheap",
|
||
"cheap": "Cheap",
|
||
"normal": "Normal",
|
||
"expensive": "Expensive",
|
||
"very_expensive": "Very expensive"
|
||
}
|
||
},
|
||
"rating_level_filter": {
|
||
"options": {
|
||
"low": "Low",
|
||
"normal": "Normal",
|
||
"high": "High"
|
||
}
|
||
},
|
||
"insert_nulls": {
|
||
"options": {
|
||
"none": "None",
|
||
"segments": "Segments",
|
||
"all": "All"
|
||
}
|
||
},
|
||
"volatility": {
|
||
"options": {
|
||
"low": "Low",
|
||
"moderate": "Moderate",
|
||
"high": "High",
|
||
"very_high": "Very high"
|
||
}
|
||
},
|
||
"current_interval_price_level": {
|
||
"options": {
|
||
"any": "Any",
|
||
"very_cheap": "Very cheap",
|
||
"cheap": "Cheap",
|
||
"normal": "Normal",
|
||
"expensive": "Expensive",
|
||
"very_expensive": "Very expensive"
|
||
}
|
||
}
|
||
},
|
||
"title": "Tibber Price Information & Ratings"
|
||
}
|