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>
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
''' Options '''
* '''''Calendar'''''
* '''Event Starts''' - Trigger fires when the calendar event begins
* '''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
* '''''Enable regular expression matching'''''
'''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
* '''''Check in advance'''''
'''Text Matching Options'''
* '''Enable Regex''' - Use regular expressions for pattern matching
* '''Ignore Case''' - Perform case-insensitive matching (disabled when regex is enabled)
'''''Use negative value'''''
'''Event Filtering'''
* '''Ignore All Day Events''' - Exclude all-day events from triggering
* '''''Use alarm'''''
'''Timing Options'''
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
* '''Check in Advance''' - Fire the trigger before the event starts
Use this option if the trigger time is not accurate (and you need it) e.g. for high importance events it is recommended to use alarm.
** 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]]