From 76b0d0a76681eca2b4853510485676217fd52fe1 Mon Sep 17 00:00:00 2001 From: Julian Pawlowski Date: Sat, 15 Nov 2025 18:00:38 +0000 Subject: [PATCH] docs(user): add dynamic icon and color guides for dashboard customization Added comprehensive user documentation for visual dashboard customization: - docs/user/icon-colors.md: New guide for using icon_color attribute * Explains CSS variable approach for theme compatibility * Shows when to use icon_color vs state interpretation * Examples for Custom Button Card, Entities Card, Mushroom, Glance * Custom color override options (theme-based and direct) * All state values use lowercase (HA convention) - docs/user/dynamic-icons.md: New guide for automatic icon changes * Explains state-based icon behavior without cataloging specifics * Dashboard examples with standard and custom cards * Icon override instructions for fixed icons * Binary sensor icon behavior details * Integration with dynamic colors - Updated cross-references in README.md, sensors.md, automation-examples.md to link both new guides Impact: Users can now create visually rich dashboards with color-coded and icon-changing sensors without writing complex conditional logic. Documentation focuses on principles and practical examples rather than exhaustive listings, making it easy to understand and maintain. --- docs/user/README.md | 42 +-- docs/user/automation-examples.md | 2 + docs/user/dynamic-icons.md | 178 +++++++++++++ docs/user/icon-colors.md | 443 +++++++++++++++++++++++++++++++ docs/user/sensors.md | 7 +- 5 files changed, 650 insertions(+), 22 deletions(-) create mode 100644 docs/user/dynamic-icons.md create mode 100644 docs/user/icon-colors.md diff --git a/docs/user/README.md b/docs/user/README.md index 98f8d72..cec9a7b 100644 --- a/docs/user/README.md +++ b/docs/user/README.md @@ -4,13 +4,15 @@ Welcome to Tibber Prices! This integration provides enhanced electricity price d ## πŸ“š Documentation -- **[Installation](installation.md)** - How to install via HACS and configure the integration -- **[Configuration](configuration.md)** - Setting up your Tibber API token and price thresholds -- **[Period Calculation](period-calculation.md)** - How Best/Peak Price periods are calculated and configured -- **[Sensors](sensors.md)** - Available sensors, their states, and attributes -- **[Services](services.md)** - Custom services and how to use them -- **[Automation Examples](automation-examples.md)** - Ready-to-use automation recipes -- **[Troubleshooting](troubleshooting.md)** - Common issues and solutions +- **[Installation](installation.md)** - How to install via HACS and configure the integration +- **[Configuration](configuration.md)** - Setting up your Tibber API token and price thresholds +- **[Period Calculation](period-calculation.md)** - How Best/Peak Price periods are calculated and configured +- **[Sensors](sensors.md)** - Available sensors, their states, and attributes +- **[Dynamic Icons](dynamic-icons.md)** - State-based automatic icon changes +- **[Dynamic Icon Colors](icon-colors.md)** - Using icon_color attribute for color-coded dashboards +- **[Services](services.md)** - Custom services and how to use them +- **[Automation Examples](automation-examples.md)** - Ready-to-use automation recipes +- **[Troubleshooting](troubleshooting.md)** - Common issues and solutions ## πŸš€ Quick Start @@ -22,25 +24,25 @@ Welcome to Tibber Prices! This integration provides enhanced electricity price d ## ✨ Key Features -- **Quarter-hourly precision** - 15-minute intervals for accurate price tracking -- **Statistical analysis** - Trailing/leading 24h averages for context -- **Price ratings** - LOW/NORMAL/HIGH classification based on your thresholds -- **Best/Peak hour detection** - Automatic detection of cheapest/peak periods with configurable filters ([learn how](period-calculation.md)) -- **ApexCharts integration** - Custom services for beautiful price charts -- **Multi-currency support** - EUR, NOK, SEK with proper minor units (ct, ΓΈre, ΓΆre) +- **Quarter-hourly precision** - 15-minute intervals for accurate price tracking +- **Statistical analysis** - Trailing/leading 24h averages for context +- **Price ratings** - LOW/NORMAL/HIGH classification based on your thresholds +- **Best/Peak hour detection** - Automatic detection of cheapest/peak periods with configurable filters ([learn how](period-calculation.md)) +- **ApexCharts integration** - Custom services for beautiful price charts +- **Multi-currency support** - EUR, NOK, SEK with proper minor units (ct, ΓΈre, ΓΆre) ## πŸ”— Useful Links -- [GitHub Repository](https://github.com/jpawlowski/hass.tibber_prices) -- [Issue Tracker](https://github.com/jpawlowski/hass.tibber_prices/issues) -- [Release Notes](https://github.com/jpawlowski/hass.tibber_prices/releases) -- [Home Assistant Community](https://community.home-assistant.io/) +- [GitHub Repository](https://github.com/jpawlowski/hass.tibber_prices) +- [Issue Tracker](https://github.com/jpawlowski/hass.tibber_prices/issues) +- [Release Notes](https://github.com/jpawlowski/hass.tibber_prices/releases) +- [Home Assistant Community](https://community.home-assistant.io/) ## 🀝 Need Help? -- Check the [Troubleshooting Guide](troubleshooting.md) -- Search [existing issues](https://github.com/jpawlowski/hass.tibber_prices/issues) -- Open a [new issue](https://github.com/jpawlowski/hass.tibber_prices/issues/new) if needed +- Check the [Troubleshooting Guide](troubleshooting.md) +- Search [existing issues](https://github.com/jpawlowski/hass.tibber_prices/issues) +- Open a [new issue](https://github.com/jpawlowski/hass.tibber_prices/issues/new) if needed --- diff --git a/docs/user/automation-examples.md b/docs/user/automation-examples.md index f1f5c35..2a40617 100644 --- a/docs/user/automation-examples.md +++ b/docs/user/automation-examples.md @@ -2,6 +2,8 @@ > **Note:** This guide is under construction. +> **Tip:** For dashboard examples with dynamic icons and colors, see the **[Dynamic Icons Guide](dynamic-icons.md)** and **[Dynamic Icon Colors Guide](icon-colors.md)**. + ## Price-Based Automations Coming soon... diff --git a/docs/user/dynamic-icons.md b/docs/user/dynamic-icons.md new file mode 100644 index 0000000..7138641 --- /dev/null +++ b/docs/user/dynamic-icons.md @@ -0,0 +1,178 @@ +# Dynamic Icons + +Many sensors in the Tibber Prices integration automatically change their icon based on their current state. This provides instant visual feedback about price levels, trends, and periods without needing to read the actual values. + +## What are Dynamic Icons? + +Instead of having a fixed icon, some sensors update their icon to reflect their current state: + +- **Price level sensors** show different cash/money icons depending on whether prices are cheap or expensive +- **Price rating sensors** show thumbs up/down based on how the current price compares to average +- **Volatility sensors** show different chart types based on price stability +- **Binary sensors** show different icons when ON vs OFF (e.g., piggy bank when in best price period) + +The icons change automatically - no configuration needed! + +## How to Check if a Sensor Has Dynamic Icons + +To see which icon a sensor currently uses: + +1. Go to **Developer Tools** β†’ **States** in Home Assistant +2. Search for your sensor (e.g., `sensor.tibber_home_current_interval_price_level`) +3. Look at the icon displayed in the entity row +4. Change conditions (wait for price changes) and check if the icon updates + +**Common sensor types with dynamic icons:** + +- Price level sensors (e.g., `current_interval_price_level`) +- Price rating sensors (e.g., `current_interval_price_rating`) +- Volatility sensors (e.g., `volatility_today`) +- Binary sensors (e.g., `best_price_period`, `peak_price_period`) + +## Using Dynamic Icons in Your Dashboard + +### Standard Entity Cards + +Dynamic icons work automatically in standard Home Assistant cards: + +```yaml +type: entities +entities: + - entity: sensor.tibber_home_current_interval_price_level + - entity: sensor.tibber_home_current_interval_price_rating + - entity: sensor.tibber_home_volatility_today + - entity: binary_sensor.tibber_home_best_price_period +``` + +The icons will update automatically as the sensor states change. + +### Glance Card + +```yaml +type: glance +entities: + - entity: sensor.tibber_home_current_interval_price_level + name: Price Level + - entity: sensor.tibber_home_current_interval_price_rating + name: Rating + - entity: binary_sensor.tibber_home_best_price_period + name: Best Price +``` + +### Custom Button Card + +```yaml +type: custom:button-card +entity: sensor.tibber_home_current_interval_price_level +name: Current Price Level +show_state: true +# Icon updates automatically - no need to specify it! +``` + +### Mushroom Entity Card + +```yaml +type: custom:mushroom-entity-card +entity: sensor.tibber_home_volatility_today +name: Price Volatility +# Icon changes automatically based on volatility level +``` + +## Overriding Dynamic Icons + +If you want to use a fixed icon instead of the dynamic one: + +### In Entity Cards + +```yaml +type: entities +entities: + - entity: sensor.tibber_home_current_interval_price_level + icon: mdi:lightning-bolt # Fixed icon, won't change +``` + +### In Custom Button Card + +```yaml +type: custom:button-card +entity: sensor.tibber_home_current_interval_price_rating +name: Price Rating +icon: mdi:chart-line # Fixed icon overrides dynamic behavior +show_state: true +``` + +## Combining with Dynamic Colors + +Dynamic icons work great together with dynamic colors! See the **[Dynamic Icon Colors Guide](icon-colors.md)** for examples. + +**Example: Dynamic icon AND color** + +```yaml +type: custom:button-card +entity: sensor.tibber_home_current_interval_price_level +name: Current Price +show_state: true +# Icon changes automatically (cheap/expensive cash icons) +styles: + icon: + - color: | + [[[ + return entity.attributes.icon_color || 'var(--state-icon-color)'; + ]]] +``` + +This gives you both: + +- βœ… Different icon based on state (e.g., cash-plus when cheap, cash-remove when expensive) +- βœ… Different color based on state (e.g., green when cheap, red when expensive) + +## Icon Behavior Details + +### Binary Sensors + +Binary sensors may have different icons for different states: + +- **ON state**: Typically shows an active/alert icon +- **OFF state**: May show different icons depending on whether future periods exist + - Has upcoming periods: Timer/waiting icon + - No upcoming periods: Sleep/inactive icon + +**Example:** `binary_sensor.tibber_home_best_price_period` + +- When ON: Shows a piggy bank (good time to save money) +- When OFF with future periods: Shows a timer (waiting for next period) +- When OFF without future periods: Shows a sleep icon (no periods expected soon) + +### State-Based Icons + +Sensors with text states (like `cheap`, `normal`, `expensive`) typically show icons that match the meaning: + +- Lower/better values β†’ More positive icons +- Higher/worse values β†’ More cautionary icons +- Normal/average values β†’ Neutral icons + +The exact icons are chosen to be intuitive and meaningful in the Home Assistant ecosystem. + +## Troubleshooting + +**Icon not changing:** + +- Wait for the sensor state to actually change (prices update every 15 minutes) +- Check in Developer Tools β†’ States that the sensor state is changing +- If you've set a custom icon in your card, it will override the dynamic icon + +**Want to see the icon code:** + +- Look at the entity in Developer Tools β†’ States +- The `icon` attribute shows the current Material Design icon code (e.g., `mdi:cash-plus`) + +**Want different icons:** + +- You can override icons in your card configuration (see examples above) +- Or create a template sensor with your own icon logic + +## See Also + +- [Dynamic Icon Colors](icon-colors.md) - Color your icons based on state +- [Sensors Reference](sensors.md) - Complete list of available sensors +- [Automation Examples](automation-examples.md) - Use dynamic icons in automations diff --git a/docs/user/icon-colors.md b/docs/user/icon-colors.md new file mode 100644 index 0000000..77f3f06 --- /dev/null +++ b/docs/user/icon-colors.md @@ -0,0 +1,443 @@ +# Dynamic Icon Colors + +Many sensors in the Tibber Prices integration provide an `icon_color` attribute that allows you to dynamically color elements in your dashboard based on the sensor's state. This is particularly useful for visual dashboards where you want instant recognition of price levels or states. + +**What makes icon_color special:** Instead of writing complex if/else logic to interpret the sensor state, you can simply use the `icon_color` value directly - it already contains the appropriate CSS color variable for the current state. + +> **Related:** Many sensors also automatically change their **icon** based on state. See the **[Dynamic Icons Guide](dynamic-icons.md)** for details. + +## What is icon_color? + +The `icon_color` attribute contains a **CSS variable name** (not a direct color value) that changes based on the sensor's state. For example: + +- **Price level sensors**: `var(--success-color)` for cheap, `var(--error-color)` for expensive +- **Binary sensors**: `var(--success-color)` when in best price period, `var(--error-color)` during peak price +- **Volatility**: `var(--success-color)` for low volatility, `var(--error-color)` for very high + +### Why CSS Variables? + +Using CSS variables like `var(--success-color)` instead of hardcoded colors (like `#00ff00`) has important advantages: + +- βœ… **Automatic theme adaptation** - Colors change with light/dark mode +- βœ… **Consistent with your theme** - Uses your theme's color scheme +- βœ… **Future-proof** - Works with custom themes and future HA updates + +You can use the `icon_color` attribute directly in your card templates, or interpret the sensor state yourself if you prefer custom colors (see examples below). + +## Which Sensors Support icon_color? + +Many sensors provide the `icon_color` attribute for dynamic styling. To see if a sensor has this attribute: + +1. Go to **Developer Tools** β†’ **States** in Home Assistant +2. Search for your sensor (e.g., `sensor.tibber_home_current_interval_price_level`) +3. Look for `icon_color` in the attributes section + +**Common sensor types with icon_color:** + +- Price level sensors (e.g., `current_interval_price_level`) +- Price rating sensors (e.g., `current_interval_price_rating`) +- Volatility sensors (e.g., `volatility_today`) +- Price trend sensors (e.g., `price_trend_next_3h`) +- Binary sensors (e.g., `best_price_period`, `peak_price_period`) +- Timing sensors (e.g., `best_price_time_until_start`, `best_price_progress`) + +The colors adapt to the sensor's state - cheaper prices typically show green, expensive prices red, and neutral states gray. + +## When to Use icon_color vs. State Value + +**Use `icon_color` when:** + +- βœ… You can apply the CSS variable directly (icons, text colors, borders) +- βœ… Your card supports CSS variable substitution +- βœ… You want simple, clean code without if/else logic + +**Use the state value directly when:** + +- ⚠️ You need to convert the color (e.g., CSS variable β†’ RGBA with transparency) +- ⚠️ You need different colors than what `icon_color` provides +- ⚠️ You're building complex conditional logic anyway + +**Example of when NOT to use icon_color:** + +```yaml +# ❌ DON'T: Converting icon_color requires if/else anyway +card: + - background: | + [[[ + const color = entity.attributes.icon_color; + if (color === 'var(--success-color)') return 'rgba(76, 175, 80, 0.1)'; + if (color === 'var(--error-color)') return 'rgba(244, 67, 54, 0.1)'; + // ... more if statements + ]]] + +# βœ… DO: Interpret state directly if you need custom logic +card: + - background: | + [[[ + const level = entity.state; + if (level === 'very_cheap' || level === 'cheap') return 'rgba(76, 175, 80, 0.1)'; + if (level === 'very_expensive' || level === 'expensive') return 'rgba(244, 67, 54, 0.1)'; + return 'transparent'; + ]]] +``` + +The advantage of `icon_color` is simplicity - if you need complex logic, you lose that advantage. + +## How to Use icon_color in Your Dashboard + +### Method 1: Custom Button Card (Recommended) + +The [custom:button-card](https://github.com/custom-cards/button-card) from HACS supports dynamic icon colors. + +**Example: Icon color only** + +```yaml +type: custom:button-card +entity: sensor.tibber_home_current_interval_price_level +name: Current Price Level +show_state: true +icon: mdi:cash +styles: + icon: + - color: | + [[[ + return entity.attributes.icon_color || 'var(--state-icon-color)'; + ]]] +``` + +**Example: Icon AND state value with same color** + +```yaml +type: custom:button-card +entity: sensor.tibber_home_current_interval_price_level +name: Current Price Level +show_state: true +icon: mdi:cash +styles: + icon: + - color: | + [[[ + return entity.attributes.icon_color || 'var(--state-icon-color)'; + ]]] + state: + - color: | + [[[ + return entity.attributes.icon_color || 'var(--primary-text-color)'; + ]]] + - font-weight: bold +``` + +### Method 2: Entities Card with card_mod + +Use Home Assistant's built-in entities card with card_mod for icon and state colors: + +```yaml +type: entities +entities: + - entity: sensor.tibber_home_current_interval_price_level +card_mod: + style: + hui-generic-entity-row: + $: | + state-badge { + color: {{ state_attr('sensor.tibber_home_current_interval_price_level', 'icon_color') }} !important; + } + .info { + color: {{ state_attr('sensor.tibber_home_current_interval_price_level', 'icon_color') }} !important; + } +``` + +### Method 3: Mushroom Cards + +The [Mushroom cards](https://github.com/piitaya/lovelace-mushroom) support card_mod for icon and text colors: + +**Icon color only:** + +```yaml +type: custom:mushroom-entity-card +entity: binary_sensor.tibber_home_best_price_period +name: Best Price Period +icon: mdi:piggy-bank +card_mod: + style: | + ha-card { + --card-mod-icon-color: {{ state_attr('binary_sensor.tibber_home_best_price_period', 'icon_color') }}; + } +``` + +**Icon and state value:** + +```yaml +type: custom:mushroom-entity-card +entity: sensor.tibber_home_current_interval_price_level +name: Price Level +card_mod: + style: | + ha-card { + --card-mod-icon-color: {{ state_attr('sensor.tibber_home_current_interval_price_level', 'icon_color') }}; + --primary-text-color: {{ state_attr('sensor.tibber_home_current_interval_price_level', 'icon_color') }}; + } +``` + +### Method 4: Glance Card with card_mod + +Combine multiple sensors with dynamic colors: + +```yaml +type: glance +entities: + - entity: sensor.tibber_home_current_interval_price_level + - entity: sensor.tibber_home_volatility_today + - entity: binary_sensor.tibber_home_best_price_period +card_mod: + style: | + ha-card div.entity:nth-child(1) state-badge { + color: {{ state_attr('sensor.tibber_home_current_interval_price_level', 'icon_color') }} !important; + } + ha-card div.entity:nth-child(2) state-badge { + color: {{ state_attr('sensor.tibber_home_volatility_today', 'icon_color') }} !important; + } + ha-card div.entity:nth-child(3) state-badge { + color: {{ state_attr('binary_sensor.tibber_home_best_price_period', 'icon_color') }} !important; + } +``` + +## Complete Dashboard Example + +Here's a complete example combining multiple sensors with dynamic colors: + +```yaml +type: vertical-stack +cards: + # Current price status + - type: horizontal-stack + cards: + - type: custom:button-card + entity: sensor.tibber_home_current_interval_price_level + name: Price Level + show_state: true + styles: + icon: + - color: | + [[[ + return entity.attributes.icon_color || 'var(--state-icon-color)'; + ]]] + + - type: custom:button-card + entity: sensor.tibber_home_current_interval_price_rating + name: Price Rating + show_state: true + styles: + icon: + - color: | + [[[ + return entity.attributes.icon_color || 'var(--state-icon-color)'; + ]]] + + # Binary sensors for periods + - type: horizontal-stack + cards: + - type: custom:button-card + entity: binary_sensor.tibber_home_best_price_period + name: Best Price Period + show_state: true + icon: mdi:piggy-bank + styles: + icon: + - color: | + [[[ + return entity.attributes.icon_color || 'var(--state-icon-color)'; + ]]] + + - type: custom:button-card + entity: binary_sensor.tibber_home_peak_price_period + name: Peak Price Period + show_state: true + icon: mdi:alert-circle + styles: + icon: + - color: | + [[[ + return entity.attributes.icon_color || 'var(--state-icon-color)'; + ]]] + + # Volatility and trends + - type: horizontal-stack + cards: + - type: custom:button-card + entity: sensor.tibber_home_volatility_today + name: Volatility + show_state: true + styles: + icon: + - color: | + [[[ + return entity.attributes.icon_color || 'var(--state-icon-color)'; + ]]] + + - type: custom:button-card + entity: sensor.tibber_home_price_trend_next_3h + name: Next 3h Trend + show_state: true + styles: + icon: + - color: | + [[[ + return entity.attributes.icon_color || 'var(--state-icon-color)'; + ]]] +``` + +## CSS Color Variables + +The integration uses Home Assistant's standard CSS variables for theme compatibility: + +- `var(--success-color)` - Green (good/cheap/low) +- `var(--info-color)` - Blue (informational) +- `var(--warning-color)` - Orange (caution/expensive) +- `var(--error-color)` - Red (alert/very expensive/high) +- `var(--state-icon-color)` - Gray (neutral/normal) +- `var(--disabled-color)` - Light gray (no data/inactive) + +These automatically adapt to your theme's light/dark mode and custom color schemes. + +### Using Custom Colors + +If you want to override the theme colors with your own, you have two options: + +#### Option 1: Use icon_color but Override in Your Theme + +Define custom colors in your theme configuration (`themes.yaml`): + +```yaml +my_custom_theme: + # Override standard variables + success-color: "#00C853" # Custom green + error-color: "#D32F2F" # Custom red + warning-color: "#F57C00" # Custom orange + info-color: "#0288D1" # Custom blue +``` + +The `icon_color` attribute will automatically use your custom theme colors. + +#### Option 2: Interpret State Value Directly + +Instead of using `icon_color`, read the sensor state and apply your own colors: + +**Example: Custom colors for price level** + +```yaml +type: custom:button-card +entity: sensor.tibber_home_current_interval_price_level +name: Current Price Level +show_state: true +icon: mdi:cash +styles: + icon: + - color: | + [[[ + const level = entity.state; + if (level === 'very_cheap') return '#00E676'; // Bright green + if (level === 'cheap') return '#66BB6A'; // Light green + if (level === 'normal') return '#9E9E9E'; // Gray + if (level === 'expensive') return '#FF9800'; // Orange + if (level === 'very_expensive') return '#F44336'; // Red + return 'var(--state-icon-color)'; // Fallback + ]]] +``` + +**Example: Custom colors for binary sensor** + +```yaml +type: custom:button-card +entity: binary_sensor.tibber_home_best_price_period +name: Best Price Period +show_state: true +icon: mdi:piggy-bank +styles: + icon: + - color: | + [[[ + // Use state directly, not icon_color + return entity.state === 'on' ? '#4CAF50' : '#9E9E9E'; + ]]] + card: + - background: | + [[[ + return entity.state === 'on' ? 'rgba(76, 175, 80, 0.1)' : 'transparent'; + ]]] +``` + +**Example: Custom colors for volatility** + +```yaml +type: custom:button-card +entity: sensor.tibber_home_volatility_today +name: Volatility Today +show_state: true +styles: + icon: + - color: | + [[[ + const volatility = entity.state; + if (volatility === 'low') return '#4CAF50'; // Green + if (volatility === 'moderate') return '#2196F3'; // Blue + if (volatility === 'high') return '#FF9800'; // Orange + if (volatility === 'very_high') return '#F44336'; // Red + return 'var(--state-icon-color)'; + ]]] +``` + +**Example: Custom colors for price rating** + +```yaml +type: custom:button-card +entity: sensor.tibber_home_current_interval_price_rating +name: Price Rating +show_state: true +styles: + icon: + - color: | + [[[ + const rating = entity.state; + if (rating === 'low') return '#00C853'; // Dark green + if (rating === 'normal') return '#78909C'; // Blue-gray + if (rating === 'high') return '#D32F2F'; // Dark red + return 'var(--state-icon-color)'; + ]]] +``` + +### Which Approach Should You Use? + +| Use Case | Recommended Approach | +| ------------------------------------- | ---------------------------------- | +| Want theme-consistent colors | βœ… Use `icon_color` directly | +| Want light/dark mode support | βœ… Use `icon_color` directly | +| Want custom theme colors | βœ… Override CSS variables in theme | +| Want specific hardcoded colors | ⚠️ Interpret state value directly | +| Multiple themes with different colors | βœ… Use `icon_color` directly | + +**Recommendation:** Use `icon_color` whenever possible for better theme integration. Only interpret the state directly if you need very specific color values that shouldn't change with themes. + +## Troubleshooting + +**Icons not changing color:** + +- Make sure you're using a card that supports custom styling (like custom:button-card or card_mod) +- Check that the entity actually has the `icon_color` attribute (inspect in Developer Tools β†’ States) +- Verify your Home Assistant theme supports the CSS variables + +**Colors look wrong:** + +- The colors are theme-dependent. Try switching themes to see if they appear correctly +- Some custom themes may override the standard CSS variables with unexpected colors + +**Want different colors?** + +- You can override the colors in your theme configuration +- Or use conditional logic in your card templates based on the state value instead of `icon_color` + +## See Also + +- [Sensors Reference](sensors.md) - Complete list of available sensors +- [Automation Examples](automation-examples.md) - Use color-coded sensors in automations +- [Configuration Guide](configuration.md) - Adjust thresholds for price levels and ratings diff --git a/docs/user/sensors.md b/docs/user/sensors.md index 940d88b..c91c387 100644 --- a/docs/user/sensors.md +++ b/docs/user/sensors.md @@ -2,6 +2,8 @@ > **Note:** This guide is under construction. For now, please refer to the [main README](../../README.md) for available sensors. +> **Tip:** Many sensors have dynamic icons and colors! See the **[Dynamic Icons Guide](dynamic-icons.md)** and **[Dynamic Icon Colors Guide](icon-colors.md)** to enhance your dashboards. + ## Binary Sensors ### Best Price Period & Peak Price Period @@ -9,8 +11,9 @@ These binary sensors indicate when you're in a detected best or peak price period. See the **[Period Calculation Guide](period-calculation.md)** for a detailed explanation of how these periods are calculated and configured. **Quick overview:** -- **Best Price Period**: Turns ON during periods with significantly lower prices than the daily average -- **Peak Price Period**: Turns ON during periods with significantly higher prices than the daily average + +- **Best Price Period**: Turns ON during periods with significantly lower prices than the daily average +- **Peak Price Period**: Turns ON during periods with significantly higher prices than the daily average Both sensors include rich attributes with period details, intervals, relaxation status, and more.