Difference between revisions of "Trigger: Calendar Event"
| (10 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | <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 | ||
| − | |||
| − | + | ''' 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 | |
| − | Use negative | + | ** 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 ''' |
| − | <pre style=" | + | |
| − | Use | + | 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]] | ||
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