v3.1.0

Calendar Card Pro v3.1.0

Enhanced internationalization and improved customization. This release significantly expands language support for the visual configuration editor while adding powerful new customization options and fixing important display issues.

🎉 New Features

🌐 Expanded Editor Language Support

Calendar Card Pro's visual configuration editor now supports three additional languages, making configuration accessible to even more users:

• Norwegian Bokmål Editor Translation - Complete translation for the visual configuration editor interface (Thanks @mathiasbk, #235)
• German Editor Translation - Complete translation for the visual configuration editor interface (Thanks @NetSecond, #237)
• Swedish Editor Translation - Complete translation for the visual configuration editor interface (Thanks @JonasHedberg, #238)

The visual editor now supports 5 languages total: English, Slovak, Norwegian, German, and Swedish.

🆕 New Language Addition

• Bulgarian Language Support - Added complete Bulgarian translation for the calendar card interface, bringing the total number of supported languages to 30! (Thanks @kyutov, #246)

🎨 Enhanced Styling Capabilities

• Tomorrow CSS Class - Added new HTML tomorrow CSS class to tomorrow's events, enabling users to use card-mod to apply specific styling to tomorrow's events that's distinct from other future events. See the ReadMe for an example. (Thanks @Squazel, #249)

🐛 Bug Fixes

Weather Display Improvements

• Zero Temperature Display Fix - Fixed an issue where minimum temperature values of exactly 0° would not be displayed in the date column when show_low_temp: true was configured. The condition now properly handles zero values by checking for undefined instead of using truthy evaluation. (Thanks @DaveOzzie, #252)

Layout and Container Issues

• Grid Container Overflow Fix - Resolved an issue where the calendar card would exceed its container boundaries and overlay other sections when grid_options.rows was configured. The card now properly respects container boundaries in all grid configurations. (Thanks @Deltids, #233)

Related Issues

• #235 - Added editor values to Norwegian bokmål language by @mathiasbk
• #237 - Update de.json (complete) by @NetSecond
• #238 - Swedish Translation by @JonasHedberg
• #246 - Add support for Bulgarian language by @kyutov
• #248 - [Feature]: Include HTML class to indicate "tomorrow" by @Squazel
• #249 - feat(tomorrow): Added new HTML class 'tomorrow' by @Squazel
• #252 - [Bug]: Weather minimum temperature not displayed if it's zero degrees by @DaveOzzie
• #233 - [Bug]: Calendar card exceeds container when grid_options.rows is set by @Deltids

Full Changelog: v3.0.6...v3.1.0

v3.0.6

Calendar Card Pro v3.0.6

🎉 New Features

• Slovak Editor Translation - Added complete Slovak translation for the visual configuration editor, making Slovak the second fully supported editor language after English. (Thanks @jose1711, #230)

🐛 Bug Fixes

• Event Background Color Fix - Fixed an issue where the event background color did not correctly use the global accent_color setting when no entity-specific accent_color was defined. The event background now properly matches the global accent color setting.
• Slovak Translation Typo Fix - Fixed a small typo in the Slovak translation for the calendar card interface. (Thanks @jose1711, #230)

Related Issues

• #230 - Update Slovak translation by @jose1711
• #232 - Update FUNDING.yml by @benjamin-dcs

Full Changelog: v3.0.5...v3.0.6

v3.0.5

Calendar Card Pro v3.0.5

🐛 Bug Fixes

• Allowlist/Blocklist Filtering Fix - Fixed incorrect behavior when using multiple configurations for the same calendar entity with different allowlist/blocklist filters. Each entity configuration is now processed independently, correctly applying filters and event limits.
• Empty Space Removal - Resolved an issue causing excessive empty space when compact_events_to_show was set only at the entity level without a global limit. Days without visible events are now properly filtered out, eliminating unnecessary empty space.
• Ukrainian Translation Fix - Corrected incorrect Ukrainian translations for calendar elements.

Related Issues

• #228 - Calendar event filtering applies incorrectly to multiple instances of the same calendar entity by @Zerosignal84
• #223 - Incorrect Ukrainian translation by @merlin-zaraza
• #224 - Fix Ukrainian translation by @merlin-zaraza

Full Changelog: v3.0.4...v3.0.5

v3.0.4

Calendar Card Pro v3.0.4

🐛 Bug Fixes

• Fixed accent color backgrounds - Resolved an issue where event background colors wouldn't display properly when using named colors like "blue" in the accent_color setting (RGB and hex values were unaffected)

Related Issues

• #219 - Shaded Accent Backgrounds fail after 3.0.x by @dml105

Full Changelog: v3.0.3...v3.0.4

---

Calendar Card Pro v3.0.0

Visual configuration meets weather integration. This major release transforms how you interact with and view calendar information, combining intuitive visual configuration with powerful weather forecasts—making your calendar both easier to set up and more contextually informative than ever before.

🎉 New Features

⚙️ Visual Configuration Editor

Calendar Card Pro now includes a comprehensive visual editor that makes configuration simple and intuitive! This highly-requested feature provides a rich, guided interface for customizing every aspect of your calendar card.

• Native Home Assistant Design - Built with the same UI components as Home Assistant for perfect visual integration and consistent theming
• Smart, Context-Aware Interface - Options only appear when relevant, reducing clutter and simplifying configuration
• Organized Configuration Sections - Settings are grouped into logical, collapsible panels for easy navigation
• Automatic Config Upgrader - ✨ Detects deprecated settings and updates your configuration with one click
• Specialized Input Helpers - Advanced pickers for entities, icons, colors and other complex options
• Mobile-Friendly Design - Fully responsive interface that works on any device

Upgrading from previous versions? When you first open the editor after updating, any deprecated parameters in your configuration will be automatically detected. Simply click the "Update config..." button that appears to instantly migrate to the latest parameter names!

Note: The visual configuration editor is currently only available in English. The configured calendar card will still display in your selected language, but the editor interface itself is English-only at this time.

Editor Feature Details

• Logical Organization - Edit configuration in intuitive sections including Calendar Entities, Core Settings, Appearance & Layout, Date Display, Event Display, Weather Integration, and Interactions
• Dynamic Fields - Options for styling and advanced features only appear when their parent features are enabled
• Smart Validation - Type-specific input fields with validation ensure your configuration is always correct
• Visual Helpers - Specialized selectors for today indicators, calendar labels, and other visual elements
• Enhanced Accessibility - Inclusive design principles ensure the editor is usable by everyone

🌦️ Weather Integration

Calendar Card Pro now supports displaying weather forecasts directly alongside your calendar events! This powerful new integration allows you to see the expected weather conditions for each day or for specific events.

• Dual Display Positions: Show weather in the date column, event column, or both
• Customizable Information: Choose what weather data to display independently for each position
• Per-Position Styling: Control the appearance and content of weather data independently in each position
• Automatic Forecast Matching: Weather data automatically matches the correct day or event time
• Home Assistant Integration: Uses your existing weather entities and requires no additional setup

Pro Tip: The new visual editor makes configuring weather integration simple! Just select your weather entity and customize display options through the intuitive Weather Integration panel.

Manual YAML Configuration Details

type: custom:calendar-card-pro
# Basic weather configuration
weather:
  entity: weather.your_weather_entity
  position: date # Options: 'date', 'event', or 'both'
  date:
    show_conditions: true
    show_high_temp: true
    show_low_temp: false
  event:
    show_conditions: true
    show_temp: true

For full parameter documentation including styling options, see our GitHub README.

🕒 Improved Time Format Detection

Calendar Card Pro now correctly integrates with all Home Assistant time format settings:

• Complete HA Integration - Properly detects and respects all four Home Assistant time format options: 12-hour, 24-hour, language-based, and system-based settings
• Smart Language Detection - When HA is set to use language-based time format, the card intelligently determines the appropriate format based on the language
• System Settings Support - Properly detects system/browser time format preferences when HA is configured to use them
• Override Capability - Still allows explicit time format configuration via the card's time_24h setting, independent of Home Assistant settings

New Languages

Extended language support to further regions, so that 29 languages are now supported:

• Croatian Language - Added complete Croatian translations for all calendar elements

Parameter Updates

The following parameters have been renamed or removed in v3.0.0 (the editor will automatically detect and update these for you):

• max_events_to_show → compact_events_to_show (both global and entity-level)
• vertical_line_color → accent_color
• horizontal_line_width → day_separator_width
• horizontal_line_color → day_separator_color

🐛 Bug Fixes

Today Indicator Emoji Detection

• Improved Emoji Support – Today indicator now reliably detects and displays all emoji characters, including complex and multi-codepoint emojis, by using Unicode property escapes for robust emoji detection.

Entity-level Settings Consistency

• Fixed Entity-level Location Display - Entity-specific show_location: true now correctly overrides the global show_location: false setting, ensuring consistent behavior with other entity-level settings like show_time.

Related Issues

This release addresses community-reported issues:

• #107 - Weather Forecast Integration by @rothomas
• #196 - Auto-detect 12/24h time format from HA by @tomofdarkness
• #199 - Added Croatian language translation by @adamivangrgic

Full Changelog: v2.4.5...v3.0.0

v3.0.3

Calendar Card Pro v3.0.3

Editor functionality and documentation fixes. This release addresses issues with the visual editor and clarifies documentation for filtering options.

🐛 Bug Fixes

• Fixed entity picker selection in editor - Resolved an issue where in rare cases calendar and weather entity selections wouldn't register in the dropdown, preventing users from selecting or changing weather entities through the UI
• Clarified blocklist/allowlist documentation - Updated field descriptions to correctly specify pipe separator (|) rather than commas, matching the actual implementation

Related Issues

• #214 - Entity picker selection doesn't register in editor by @mhoogenbosch and @dives11
• #216 - Incorrect blocklist/allowlist format documentation by @Kuddelsoft

Full Changelog: v3.0.0...v3.0.3

---

Calendar Card Pro v3.0.0

Visual configuration meets weather integration. This major release transforms how you interact with and view calendar information, combining intuitive visual configuration with powerful weather forecasts—making your calendar both easier to set up and more contextually informative than ever before.

🎉 New Features

⚙️ Visual Configuration Editor

Calendar Card Pro now includes a comprehensive visual editor that makes configuration simple and intuitive! This highly-requested feature provides a rich, guided interface for customizing every aspect of your calendar card.

• Native Home Assistant Design - Built with the same UI components as Home Assistant for perfect visual integration and consistent theming
• Smart, Context-Aware Interface - Options only appear when relevant, reducing clutter and simplifying configuration
• Organized Configuration Sections - Settings are grouped into logical, collapsible panels for easy navigation
• Automatic Config Upgrader - ✨ Detects deprecated settings and updates your configuration with one click
• Specialized Input Helpers - Advanced pickers for entities, icons, colors and other complex options
• Mobile-Friendly Design - Fully responsive interface that works on any device

Upgrading from previous versions? When you first open the editor after updating, any deprecated parameters in your configuration will be automatically detected. Simply click the "Update config..." button that appears to instantly migrate to the latest parameter names!

Note: The visual configuration editor is currently only available in English. The configured calendar card will still display in your selected language, but the editor interface itself is English-only at this time.

Editor Feature Details

• Logical Organization - Edit configuration in intuitive sections including Calendar Entities, Core Settings, Appearance & Layout, Date Display, Event Display, Weather Integration, and Interactions
• Dynamic Fields - Options for styling and advanced features only appear when their parent features are enabled
• Smart Validation - Type-specific input fields with validation ensure your configuration is always correct
• Visual Helpers - Specialized selectors for today indicators, calendar labels, and other visual elements
• Enhanced Accessibility - Inclusive design principles ensure the editor is usable by everyone

🌦️ Weather Integration

Calendar Card Pro now supports displaying weather forecasts directly alongside your calendar events! This powerful new integration allows you to see the expected weather conditions for each day or for specific events.

• Dual Display Positions: Show weather in the date column, event column, or both
• Customizable Information: Choose what weather data to display independently for each position
• Per-Position Styling: Control the appearance and content of weather data independently in each position
• Automatic Forecast Matching: Weather data automatically matches the correct day or event time
• Home Assistant Integration: Uses your existing weather entities and requires no additional setup

Pro Tip: The new visual editor makes configuring weather integration simple! Just select your weather entity and customize display options through the intuitive Weather Integration panel.

Manual YAML Configuration Details

type: custom:calendar-card-pro
# Basic weather configuration
weather:
  entity: weather.your_weather_entity
  position: date # Options: 'date', 'event', or 'both'
  date:
    show_conditions: true
    show_high_temp: true
    show_low_temp: false
  event:
    show_conditions: true
    show_temp: true

For full parameter documentation including styling options, see our GitHub README.

🕒 Improved Time Format Detection

Calendar Card Pro now correctly integrates with all Home Assistant time format settings:

• Complete HA Integration - Properly detects and respects all four Home Assistant time format options: 12-hour, 24-hour, language-based, and system-based settings
• Smart Language Detection - When HA is set to use language-based time format, the card intelligently determines the appropriate format based on the language
• System Settings Support - Properly detects system/browser time format preferences when HA is configured to use them
• Override Capability - Still allows explicit time format configuration via the card's time_24h setting, independent of Home Assistant settings

New Languages

Extended language support to further regions, so that 29 languages are now supported:

• Croatian Language - Added complete Croatian translations for all calendar elements

Parameter Updates

The following parameters have been renamed or removed in v3.0.0 (the editor will automatically detect and update these for you):

• max_events_to_show → compact_events_to_show (both global and entity-level)
• vertical_line_color → accent_color
• horizontal_line_width → day_separator_width
• horizontal_line_color → day_separator_color

🐛 Bug Fixes

Today Indicator Emoji Detection

• Improved Emoji Support – Today indicator now reliably detects and displays all emoji characters, including complex and multi-codepoint emojis, by using Unicode property escapes for robust emoji detection.

Entity-level Settings Consistency

• Fixed Entity-level Location Display - Entity-specific show_location: true now correctly overrides the global show_location: false setting, ensuring consistent behavior with other entity-level settings like show_time.

Related Issues

This release addresses community-reported issues:

• #107 - Weather Forecast Integration by @rothomas
• #196 - Auto-detect 12/24h time format from HA by @tomofdarkness
• #199 - Added Croatian language translation by @adamivangrgic

Full Changelog: v2.4.5...v3.0.0

v3.0.2

Calendar Card Pro v3.0.2

Configuration and editor bugfixes. This release addresses issues with configuration handling discovered after the v3.0.0 release.

🐛 Bug Fixes

• Fixed configuration filtering for weather settings - Resolved UI synchronization issues by preserving the complete weather configuration structure even when values match defaults, preventing toggle switches and selectors from becoming out of sync
• Fixed all-day event weather display - Ensured daily weather forecasts are properly fetched and displayed for all-day events when weather position is set to "event"

Full Changelog: v3.0.1...v3.0.2

---

Calendar Card Pro v3.0.1

Configuration and editor bugfixes. This release addresses issues with configuration handling discovered after the v3.0.0 release.

🐛 Bug Fixes

• Fixed configuration bloat by properly handling default values and empty strings
• Fixed week numbers unexpectedly showing when they shouldn't be enabled
• Fixed UI-only fields being incorrectly saved to user configurations
• Improved code documentation for special cases in the editor

Related Issues

• #209 - Week separator requires week number by @LiquidPT

Full Changelog: v3.0.0...v3.0.1

---

Calendar Card Pro v3.0.0

Visual configuration meets weather integration. This major release transforms how you interact with and view calendar information, combining intuitive visual configuration with powerful weather forecasts—making your calendar both easier to set up and more contextually informative than ever before.

🎉 New Features

⚙️ Visual Configuration Editor

Calendar Card Pro now includes a comprehensive visual editor that makes configuration simple and intuitive! This highly-requested feature provides a rich, guided interface for customizing every aspect of your calendar card.

• Native Home Assistant Design - Built with the same UI components as Home Assistant for perfect visual integration and consistent theming
• Smart, Context-Aware Interface - Options only appear when relevant, reducing clutter and simplifying configuration
• Organized Configuration Sections - Settings are grouped into logical, collapsible panels for easy navigation
• Automatic Config Upgrader - ✨ Detects deprecated settings and updates your configuration with one click
• Specialized Input Helpers - Advanced pickers for entities, icons, colors and other complex options
• Mobile-Friendly Design - Fully responsive interface that works on any device

Upgrading from previous versions? When you first open the editor after updating, any deprecated parameters in your configuration will be automatically detected. Simply click the "Update config..." button that appears to instantly migrate to the latest parameter names!

Note: The visual configuration editor is currently only available in English. The configured calendar card will still display in your selected language, but the editor interface itself is English-only at this time.

Editor Feature Details

• Logical Organization - Edit configuration in intuitive sections including Calendar Entities, Core Settings, Appearance & Layout, Date Display, Event Display, Weather Integration, and Interactions
• Dynamic Fields - Options for styling and advanced features only appear when their parent features are enabled
• Smart Validation - Type-specific input fields with validation ensure your configuration is always correct
• Visual Helpers - Specialized selectors for today indicators, calendar labels, and other visual elements
• Enhanced Accessibility - Inclusive design principles ensure the editor is usable by everyone

🌦️ Weather Integration

Calendar Card Pro now supports displaying weather forecasts directly alongside your calendar events! This powerful new integration allows you to see the expected weather conditions for each day or for specific events.

• Dual Display Positions: Show weather in the date column, event column, or both
• Customizable Information: Choose what weather data to display independently for each position
• Per-Position Styling: Control the appearance and content of weather data independently in each position
• Automatic Forecast Matching: Weather data automatically matches the correct day or event time
• Home Assistant Integration: Uses your existing weather entities and requires no additional setup

Pro Tip: The new visual editor makes configuring weather integration simple! Just select your weather entity and customize display options through the intuitive Weather Integration panel.

Manual YAML Configuration Details

type: custom:calendar-card-pro
# Basic weather configuration
weather:
  entity: weather.your_weather_entity
  position: date # Options: 'date', 'event', or 'both'
  date:
    show_conditions: true
    show_high_temp: true
    show_low_temp: false
  event:
    show_conditions: true
    show_temp: true

For full parameter documentation including styling options, see our GitHub README.

🕒 Improved Time Format Detection

Calendar Card Pro now correctly integrates with all Home Assistant time format settings:

• Complete HA Integration - Properly detects and respects all four Home Assistant time format options: 12-hour, 24-hour, language-based, and system-based settings
• Smart Language Detection - When HA is set to use language-based time format, the card intelligently determines the appropriate format based on the language
• System Settings Support - Properly detects system/browser time format preferences when HA is configured to use them
• Override Capability - Still allows explicit time format configuration via the card's time_24h setting, independent of Home Assistant settings

New Languages

Extended language support to further regions, so that 29 languages are now supported:

• Croatian Language - Added complete Croatian translations for all calendar elements

Parameter Updates

The following parameters have been renamed or removed in v3.0.0 (the editor will automatically detect and update these for you):

• max_events_to_show → compact_events_to_show (both global and entity-level)
• vertical_line_color → accent_color
• horizontal_line_width → day_separator_width
• horizontal_line_color → day_separator_color

🐛 Bug Fixes

Today Indicator Emoji Detection

• Improved Emoji Support – Today indicator now reliably detects and displays all emoji characters, including complex and multi-codepoint emojis, by using Unicode property escapes for robust emoji detection.

Entity-level Settings Consistency

• Fixed Entity-level Location Display - Entity-specific show_location: true now correctly overrides the global show_location: false setting, ensuring consistent behavior with other entity-level settings like show_time.

Related Issues

This release addresses community-reported issues:

• #107 - Weather Forecast Integration by @rothomas
• #196 - Auto-detect 12/24h time format from HA by @tomofdarkness
• #199 - Added Croatian language translation by @adamivangrgic

Full Changelog: v2.4.5...v3.0.0

v3.0.1

Calendar Card Pro v3.0.1

Configuration and editor bugfixes. This release addresses issues with configuration handling discovered after the v3.0.0 release.

🐛 Bug Fixes

• Fixed configuration bloat by properly handling default values and empty strings
• Fixed week numbers unexpectedly showing when they shouldn't be enabled
• Fixed UI-only fields being incorrectly saved to user configurations
• Improved code documentation for special cases in the editor

Related Issues

• #209 - Week separator requires week number by @LiquidPT

Full Changelog: v3.0.0...v3.0.1

---

Calendar Card Pro v3.0.0

Visual configuration meets weather integration. This major release transforms how you interact with and view calendar information, combining intuitive visual configuration with powerful weather forecasts—making your calendar both easier to set up and more contextually informative than ever before.

🎉 New Features

⚙️ Visual Configuration Editor

Calendar Card Pro now includes a comprehensive visual editor that makes configuration simple and intuitive! This highly-requested feature provides a rich, guided interface for customizing every aspect of your calendar card.

• Native Home Assistant Design - Built with the same UI components as Home Assistant for perfect visual integration and consistent theming
• Smart, Context-Aware Interface - Options only appear when relevant, reducing clutter and simplifying configuration
• Organized Configuration Sections - Settings are grouped into logical, collapsible panels for easy navigation
• Automatic Config Upgrader - ✨ Detects deprecated settings and updates your configuration with one click
• Specialized Input Helpers - Advanced pickers for entities, icons, colors and other complex options
• Mobile-Friendly Design - Fully responsive interface that works on any device

Upgrading from previous versions? When you first open the editor after updating, any deprecated parameters in your configuration will be automatically detected. Simply click the "Update config..." button that appears to instantly migrate to the latest parameter names!

Note: The visual configuration editor is currently only available in English. The configured calendar card will still display in your selected language, but the editor interface itself is English-only at this time.

Editor Feature Details

• Logical Organization - Edit configuration in intuitive sections including Calendar Entities, Core Settings, Appearance & Layout, Date Display, Event Display, Weather Integration, and Interactions
• Dynamic Fields - Options for styling and advanced features only appear when their parent features are enabled
• Smart Validation - Type-specific input fields with validation ensure your configuration is always correct
• Visual Helpers - Specialized selectors for today indicators, calendar labels, and other visual elements
• Enhanced Accessibility - Inclusive design principles ensure the editor is usable by everyone

🌦️ Weather Integration

Calendar Card Pro now supports displaying weather forecasts directly alongside your calendar events! This powerful new integration allows you to see the expected weather conditions for each day or for specific events.

• Dual Display Positions: Show weather in the date column, event column, or both
• Customizable Information: Choose what weather data to display independently for each position
• Per-Position Styling: Control the appearance and content of weather data independently in each position
• Automatic Forecast Matching: Weather data automatically matches the correct day or event time
• Home Assistant Integration: Uses your existing weather entities and requires no additional setup

Pro Tip: The new visual editor makes configuring weather integration simple! Just select your weather entity and customize display options through the intuitive Weather Integration panel.

Manual YAML Configuration Details

type: custom:calendar-card-pro
# Basic weather configuration
weather:
  entity: weather.your_weather_entity
  position: date # Options: 'date', 'event', or 'both'
  date:
    show_conditions: true
    show_high_temp: true
    show_low_temp: false
  event:
    show_conditions: true
    show_temp: true

For full parameter documentation including styling options, see our GitHub README.

🕒 Improved Time Format Detection

Calendar Card Pro now correctly integrates with all Home Assistant time format settings:

• Complete HA Integration - Properly detects and respects all four Home Assistant time format options: 12-hour, 24-hour, language-based, and system-based settings
• Smart Language Detection - When HA is set to use language-based time format, the card intelligently determines the appropriate format based on the language
• System Settings Support - Properly detects system/browser time format preferences when HA is configured to use them
• Override Capability - Still allows explicit time format configuration via the card's time_24h setting, independent of Home Assistant settings

New Languages

Extended language support to further regions, so that 29 languages are now supported:

• Croatian Language - Added complete Croatian translations for all calendar elements

Parameter Updates

The following parameters have been renamed or removed in v3.0.0 (the editor will automatically detect and update these for you):

• max_events_to_show → compact_events_to_show (both global and entity-level)
• vertical_line_color → accent_color
• horizontal_line_width → day_separator_width
• horizontal_line_color → day_separator_color

🐛 Bug Fixes

Today Indicator Emoji Detection

• Improved Emoji Support – Today indicator now reliably detects and displays all emoji characters, including complex and multi-codepoint emojis, by using Unicode property escapes for robust emoji detection.

Entity-level Settings Consistency

• Fixed Entity-level Location Display - Entity-specific show_location: true now correctly overrides the global show_location: false setting, ensuring consistent behavior with other entity-level settings like show_time.

Related Issues

This release addresses community-reported issues:

• #107 - Weather Forecast Integration by @rothomas
• #196 - Auto-detect 12/24h time format from HA by @tomofdarkness
• #199 - Added Croatian language translation by @adamivangrgic

Full Changelog: v2.4.5...v3.0.0

v3.0.0

Calendar Card Pro v3.0.0

Visual configuration meets weather integration. This major release transforms how you interact with and view calendar information, combining intuitive visual configuration with powerful weather forecasts—making your calendar both easier to set up and more contextually informative than ever before.

🎉 New Features

⚙️ Visual Configuration Editor

Calendar Card Pro now includes a comprehensive visual editor that makes configuration simple and intuitive! This highly-requested feature provides a rich, guided interface for customizing every aspect of your calendar card.

• Native Home Assistant Design - Built with the same UI components as Home Assistant for perfect visual integration and consistent theming
• Smart, Context-Aware Interface - Options only appear when relevant, reducing clutter and simplifying configuration
• Organized Configuration Sections - Settings are grouped into logical, collapsible panels for easy navigation
• Automatic Config Upgrader - ✨ Detects deprecated settings and updates your configuration with one click
• Specialized Input Helpers - Advanced pickers for entities, icons, colors and other complex options
• Mobile-Friendly Design - Fully responsive interface that works on any device

Upgrading from previous versions? When you first open the editor after updating, any deprecated parameters in your configuration will be automatically detected. Simply click the "Update config..." button that appears to instantly migrate to the latest parameter names!

Note: The visual configuration editor is currently only available in English. The configured calendar card will still display in your selected language, but the editor interface itself is English-only at this time.

Editor Feature Details

• Logical Organization - Edit configuration in intuitive sections including Calendar Entities, Core Settings, Appearance & Layout, Date Display, Event Display, Weather Integration, and Interactions
• Dynamic Fields - Options for styling and advanced features only appear when their parent features are enabled
• Smart Validation - Type-specific input fields with validation ensure your configuration is always correct
• Visual Helpers - Specialized selectors for today indicators, calendar labels, and other visual elements
• Enhanced Accessibility - Inclusive design principles ensure the editor is usable by everyone

🌦️ Weather Integration

Calendar Card Pro now supports displaying weather forecasts directly alongside your calendar events! This powerful new integration allows you to see the expected weather conditions for each day or for specific events.

• Dual Display Positions: Show weather in the date column, event column, or both
• Customizable Information: Choose what weather data to display independently for each position
• Per-Position Styling: Control the appearance and content of weather data independently in each position
• Automatic Forecast Matching: Weather data automatically matches the correct day or event time
• Home Assistant Integration: Uses your existing weather entities and requires no additional setup

Pro Tip: The new visual editor makes configuring weather integration simple! Just select your weather entity and customize display options through the intuitive Weather Integration panel.

Manual YAML Configuration Details

type: custom:calendar-card-pro
# Basic weather configuration
weather:
  entity: weather.your_weather_entity
  position: date # Options: 'date', 'event', or 'both'
  date:
    show_conditions: true
    show_high_temp: true
    show_low_temp: false
  event:
    show_conditions: true
    show_temp: true

For full parameter documentation including styling options, see our GitHub README.

🕒 Improved Time Format Detection

Calendar Card Pro now correctly integrates with all Home Assistant time format settings:

• Complete HA Integration - Properly detects and respects all four Home Assistant time format options: 12-hour, 24-hour, language-based, and system-based settings
• Smart Language Detection - When HA is set to use language-based time format, the card intelligently determines the appropriate format based on the language
• System Settings Support - Properly detects system/browser time format preferences when HA is configured to use them
• Override Capability - Still allows explicit time format configuration via the card's time_24h setting, independent of Home Assistant settings

New Languages

Extended language support to further regions, so that 29 languages are now supported:

• Croatian Language - Added complete Croatian translations for all calendar elements

Parameter Updates

The following parameters have been renamed or removed in v3.0.0 (the editor will automatically detect and update these for you):

• max_events_to_show → compact_events_to_show (both global and entity-level)
• vertical_line_color → accent_color
• horizontal_line_width → day_separator_width
• horizontal_line_color → day_separator_color

🐛 Bug Fixes

Today Indicator Emoji Detection

• Improved Emoji Support – Today indicator now reliably detects and displays all emoji characters, including complex and multi-codepoint emojis, by using Unicode property escapes for robust emoji detection.

Entity-level Settings Consistency

• Fixed Entity-level Location Display - Entity-specific show_location: true now correctly overrides the global show_location: false setting, ensuring consistent behavior with other entity-level settings like show_time.

Related Issues

This release addresses community-reported issues:

• #107 - Weather Forecast Integration by @rothomas
• #196 - Auto-detect 12/24h time format from HA by @tomofdarkness
• #199 - Added Croatian language translation by @adamivangrgic

Full Changelog: v2.4.5...v3.0.0

v2.4.5

Calendar Card Pro v2.4.5

Consistent calendar display in all scenarios. This release fixes an important bug affecting the display of empty days when an API call returns no events.

🐛 Bug Fixes

Completely Consistent Empty Days Display

• Unified Empty Days Logic - Removed separate rendering paths for different empty day scenarios, ensuring consistent behavior in all cases
• Fixed Show Empty Days Setting - Corrected the handling of show_empty_days: true when the calendar API returns zero events
• Proper Days To Show Respect - The card now correctly honors the days_to_show setting even when there are no calendar events
• Single Code Path - Simplified the code by using a single, unified approach to empty days generation in all scenarios

📖 Documentation Improvements

New Card-Mod Examples

• Time Next to Event Title - Added documentation for displaying time in the same row as event titles using card-mod, keeping location on its own row below:

card_mod:
  style: |
    div.event-content {
      display: grid;
      grid-template-areas: 
        "title time"
        "location location";
      grid-template-columns: 1fr auto;
      column-gap: 10px;
      row-gap: 0px;
    }

    div.summary {
      grid-area: title;
      overflow: hidden;
      text-overflow: ellipsis;
    }

    div.time {
      grid-area: time;
      white-space: nowrap;
    }

    div.location {
      grid-area: location;
      white-space: normal;
      overflow: hidden;
      text-overflow: ellipsis;
    }

    div.time-location {
      display: contents;
    }

Related Issues

This release addresses community-reported issues:

• #37 - Added documentation for showing time in the same row as event titles using card-mod

How Has This Been Tested

Testing has been conducted across:

• Empty calendar scenarios where API returns zero events
• Multiple days_to_show values (2, 3, 5, 7)
• Both show_empty_days: true and show_empty_days: false settings
• Different combinations of compact and expanded modes
• Various calendar entity configurations
• Card-mod customization examples

Full Changelog: v2.4.4...v2.4.5

v2.4.4

Calendar Card Pro v2.4.4

More consistent empty days behavior. This release fixes an important bug affecting the display of empty days, ensuring the calendar shows exactly what you expect in all configurations.

🐛 Bug Fixes

Improved Empty Days Display

• Fixed Empty Days Behavior - Resolved an issue where empty days weren't consistently displayed when show_empty_days: true was configured, particularly at the end of the date range
• Proper Mode Handling - Fixed how empty days interact with compact mode settings, correctly handling both compact_days_to_show and compact_events_to_show parameters
• Edge Case Support - Better handling of date ranges with sparse events, ensuring consistent behavior regardless of event distribution
• Parameter Validation - Ensures compact_days_to_show never exceeds days_to_show to prevent showing empty days beyond the API fetch range

Related Issues

This release addresses a community-reported issue:

• #189 - Fixed bug where empty days weren't shown at the end of the date range when show_empty_days: true was configured

How Has This Been Tested

Testing has been conducted across:

• Multiple calendar configurations with various days_to_show ranges
• Scenarios with events in different distribution patterns (beginning, middle, or end of range)
• Different combinations of compact mode parameters
• Various empty days settings
• Configurations where compact_days_to_show is greater than days_to_show

Full Changelog: v2.4.3...v2.4.4