Calendar Card Pro v2.4.0

Visually intelligent and precisely configured. This release brings visual highlights for the current day, progress tracking for running events, and enhanced compact mode controls - making Calendar Card Pro more visually informative and customizable than ever.

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

🎉 New Features

Today Indicator

Visually highlight the current day in your calendar with customizable indicators:

# Enable and choose indicator type
today_indicator: true     # Simple dot indicator
today_indicator: pulse    # Animated pulsing dot
today_indicator: glow     # Glowing dot effect
today_indicator: mdi:star # Custom Material Design icon
today_indicator: 🎯       # Emoji character
today_indicator: /local/custom-indicator.png # Custom image

# Position the indicator precisely
today_indicator_position: "15% 50%" # Left-center (default)
today_indicator_position: "85% 15%" # Top-right corner

• Multiple Indicator Types - Choose from dots, animations, icons, emojis, or custom images
• Precise Positioning - Control exact placement with CSS-like position syntax
• Perfect Centering - Transform-based alignment ensures proper centering
• Theme Integration - Indicator color follows your Home Assistant theme

Today's Date Styling

Customize the appearance of today's date with dedicated color options:

# Style today's date components individually
today_weekday_color: '#03a9f4' # Color for today's weekday name
today_day_color: '#03a9f4' # Color for today's day number
today_month_color: '#03a9f4' # Color for today's month name

• Component-Level Control - Independently style the weekday name, day number, and month
• Smart Inheritance - Undefined values automatically inherit from base or weekend styling
• Priority System - Today's styling takes precedence when today falls on a weekend
• Enhanced Visual Cues - Makes the current day immediately identifiable at a glance

Progress Bars for Running Events

Show visual progress indicators for events that are currently in progress:

# Enable progress bars for running events
show_progress_bar: true
progress_bar_color: '#03a9f4'
progress_bar_height: '10px'
progress_bar_width: '60px'

• Real-time Updates - Progress bars show the current completion percentage of events
• Customizable Appearance - Control color, height, and width to match your theme
• Automatic Calculation - Intelligently determines how much of the event has completed
• Visual Timeline - Quickly see how far along your current activities are

Split Multi-Day Events

Display multi-day events on each day they cover for better visibility:

# Show multi-day events on every day they cover
split_multiday_events: true

# Control splitting on a per-calendar basis
entities:
  - entity: calendar.personal
    split_multiday_events: true
  - entity: calendar.work
    split_multiday_events: false

• Improved Conflict Detection - Easily see when multi-day events overlap with other activities
• Complete Daily View - See all active events for any given day at a glance
• Consistent Formatting - Maintains proper time and styling information for each segment
• Calendar-Specific Control - Enable or disable splitting per calendar entity

Enhanced Compact Mode Controls

Gain precise control over your compact calendar view:

# Display fewer days in compact mode
compact_days_to_show: 2 # Show just 2 days in compact mode
days_to_show: 7 # Show full 7 days when expanded

# Limit events in compact mode
compact_events_to_show: 5 # Show only 5 events in compact mode

# Ensure complete days are shown
compact_events_complete_days: true # Never show partial days

• Optimized Space Usage - Show fewer days in compact mode while keeping more days available when expanded
• Clearer Parameter Naming - More intuitive configuration with compact_events_to_show
• Complete Days Option - Prevent confusion by showing all events from partially visible days
• Backward Compatible - Legacy max_events_to_show parameter still supported

Related Issues

This release addresses the following feature requests and bug reports:

• #100 - Show progress bar for running events (requested by @vichjiri)
• #93 - Limit to number of days instead of events (requested by @mr-light-show)
• #81 - Soft events limit (requested by @noxhirsch)
• #140 - Show "Today" for events on the current day (requested by @martinsheldon)

Full Changelog: v2.3.1...v2.4.0

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