Calendar Card Pro v2.2.0

Calendar filtering and customization, redefined. This release focuses on giving you precise control over which events appear on your dashboard and how they're displayed, with powerful filtering capabilities and enhanced visual options.

→→→ Please see the 🆕 What's New section in the README for an overview of v2.2 features with links to their detailed documentation. ←←←

🎉 New Features

Advanced Event Filtering

Calendar Card Pro now provides powerful filtering capabilities with regex-based blocklist and allowlist patterns for each calendar entity:

# Exclude specific events by pattern:
entities:
  - entity: calendar.work
    blocklist: "Private|Conference" # Hide private meetings and conferences

# Only show specific events:
entities:
  - entity: calendar.family
    allowlist: "Birthday|Anniversary" # Only show birthdays and anniversaries

• Per-Entity Filtering - Each calendar can have its own filter rules
• Regular Expression Support - Use pattern matching for flexible event filtering
• Precise Control - Include or exclude events based on title text patterns
• Priority System - When both filters are specified, allowlist takes precedence

Filter Duplicate Events

Automatically detect and remove redundant events that appear in multiple calendars:

entities:
  - calendar.personal # Events from this calendar are prioritized
  - calendar.family   # Duplicates from this calendar will be hidden
filter_duplicates: true

• Smart Prioritization - When duplicates are found, keeps events from calendars listed first
• Complete Matching - Compares event title, times, and location for accurate detection
• Better Organization - Creates a cleaner view when subscribing to multiple calendars with overlapping events

Enhanced Calendar Labels

Calendar labels now support multiple formats for better visual customization:

entities:
  - entity: calendar.work
    label: '💻' # Original emoji style
  - entity: calendar.family
    label: 'mdi:account-group' # Material Design Icon
  - entity: calendar.vacation
    label: '/local/icons/beach.png' # Custom image

• Material Design Icons - Use mdi:icon-name to display any Material Design icon
• Custom Images - Reference images from your /local/ directory
• Emoji & Text - Original label functionality still supported
• Automatic Format Detection - The card detects and renders the appropriate format

Smart Country Filtering

Enhanced control over country names in location displays with three operating modes:

# Option 1: Specify exactly which countries to remove
remove_location_country: "USA|United States|Canada"

# Option 2: Use built-in country detection (previous behavior)
remove_location_country: true

# Option 3: Keep all country information (new default)
remove_location_country: false

• Extended Parameter - Now accepts custom country name patterns in addition to boolean values
• Backward Compatible - Still supports the previous true/false options
• Regular Expression Support - Match multiple country variations with one pattern
• Enhanced Flexibility - Keep international locations intact while simplifying domestic addresses
• ⚠ Default Changed - Now defaults to false for more predictable global behavior

Customizable Empty Day Styling

Control how days without events appear in your calendar:

empty_day_color: "#ff5722" # Use custom color

• Custom Text Color - Set the perfect color for "No events" messages
• Theme Integration - Works with Home Assistant theme variables
• Enhanced Accessibility - Better control over contrast ratios

🐛 Bug Fixes

• Fixed Multi-Day Event Time Display - Multi-day events now correctly show start time when viewing before or on the event's start date
• Improved Country Detection - Enhanced location parsing for more reliable country name removal

Related Issues

This release addresses the following feature requests and bug reports:

• #32 - Event filtering capabilities (requested by @hlymn231)
• #110 - Event filtering capabilities (requested by @tkabt06)
• #104 - Labels for different event types (requested by @AlexanderTurnowsky)
• #33 - Filter duplicate events (requested by @Bastian007)
• #118 - Support for images in labels (requested by @Raznor09)
• #116 - Fixed multi-day event time display and country detection (reported by @roblombardo)

Additional contributions by @netsoft-ruidias who provided proposals and implementation suggestions for filtering features.

Full Changelog: v2.1.2...v2.2.0

Thank you to everyone who contributed feature requests and bug reports that made this release possible!