997
edits
Changes
no edit summary
<pre class="header-style">The Calendar Event trigger fires when a specified calendar event starts or ends. This allows you to automate actions based on your calendar schedule, such as enabling silent mode during meetings or sending reminders before appointments.</pre>
''' Options '''
* '''Event Starts''' - Trigger fires when the calendar event begins
Calendar event (work meeting) > activate do not disturb mode.
* '''Event Ends''' - Trigger fires when the calendar event ends
''' Configuration '''
The trigger offers extensive configuration options:
'''Calendar Selection'''
* Choose which calendar to monitor from your synced calendars
'''Availability Filter'''
* '''Any''' - Trigger for all events regardless of availability status
* '''Busy''' - Only trigger for events marked as busy
'''Title Match (Optional)'''
* Enter text to match against the event title
* Supports regex patterns when enabled
* Case-insensitive matching option available
'''Detail/Description Match (Optional)'''
* Enter text to match against the event description
* Supports regex patterns when enabled
'''Text Matching Options'''
* '''Enable Regex''' - Use regular expressions for pattern matching
* '''Ignore Case''' - Perform case-insensitive matching (disabled when regex is enabled)
'''Event Filtering'''
* '''Ignore All Day Events''' - Exclude all-day events from triggering
'''Timing Options'''
* '''Check in Advance''' - Fire the trigger before the event starts
** Set days, hours, and minutes in advance
** Use negative values to fire after the event (e.g., 2 hours after end)
* '''Use Alarm''' - Ensures more accurate triggering timing for important events
''' Magic Text '''
When this trigger fires, the following information is available via magic text:
* Event title - {calendar_title}
* Event description/detail - {calendar_detail}
* Event location - {calendar_location}
* Event start date and time - {calendar_start_date}, {calendar_start_time}
* Event end date and time - {calendar_end_date}, {calendar_end_time}
''' Examples '''
''Example 1: Silent Mode During Meetings''
<pre class="trigger-style">Triggers
Calendar Event - Event Starts (Busy)</pre>
<pre class="action-style">Actions
Volume Change: Ring to 0 (Silent)
Volume Change: Notification to 0</pre>
''Example 2: Reminder 30 Minutes Before Appointment''
<pre class="trigger-style">Triggers
Calendar Event - Event Starts [+30m] (Title: Doctor)</pre>
<pre class="action-style">Actions
Notification: Doctor appointment in 30 minutes!</pre>
''' Notes '''
* This trigger normally only fires on 5-minute boundaries (configurable in settings), so events that start between boundaries may fire a few minutes late
* The update rate can be adjusted in MacroDroid settings
* Use the "Use Alarm" option for more accurate timing on important events
* When importing macros, the trigger will attempt to match the calendar by name on the new device
* Regex matching automatically disables the "Ignore Case" option (use regex flags instead)
''' Permissions Required '''
* '''Calendar Permission''' - READ_CALENDAR permission required to access calendar events
* '''Schedule Exact Alarm''' - Required for precise timing
''' See Also '''
* [[Action:_Calendar_-_Add_Event|Add Calendar Event Action]]
* [[Constraint:_Calendar_Entry|Calendar Event Constraint]]