Difference between revisions of "Trigger: Calendar Event"

Latest revision as of 21:57, 5 January 2026

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.

Options

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

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

Triggers

Calendar Event - Event Starts (Busy)

Actions

Volume Change: Ring to 0 (Silent)
Volume Change: Notification to 0

Example 2: Reminder 30 Minutes Before Appointment

Triggers

Calendar Event - Event Starts [+30m] (Title: Doctor)

Actions

Notification: Doctor appointment in 30 minutes!

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

@@ Line 1: / Line 1: @@
-<pre style="background-color: #EEEEEE; color: Black; border-radius: 10px; padding: 10px;">
+<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>
-This trigger will fire when a specific calendar event starts/ends.
-Note that this trigger normally only fires on 5 minute boundaries, so if you have an event that starts between the boundaries, it may fire a few minutes later.</pre>
+''' Options '''
-<br>
-'''Example Usage'''<br/>
-Calendar event, work meeting then activate do not disturb mode.
-<pre style="background-color: #AC2424; color: white; border-radius: 10px; padding: 10px;">
-Triggers
-Calendar event (Work meeting)
+* '''Event Starts''' - Trigger fires when the calendar event begins
-</pre><br>
+* '''Event Ends''' - Trigger fires when the calendar event ends
-<pre style="background-color: #1665B0; color: white; border-radius: 10px; padding: 10px;">
-Actions
-Activate do not disturb mode
+''' Configuration '''
-</pre><br>
-<pre style="background-color: green; color: white; border-radius: 10px; padding: 10px;">
-Constraints
+The trigger offers extensive configuration options:
-</pre><br>
+'''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]]