Difference between revisions of "Trigger: Calendar Event"

m
 
(15 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
<pre class="header-style">
 
This trigger will fire when a specific calendar event starts/ends.
 
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.
 
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>
  
'''Example Usage'''<br/>
+
'''Magic Text'''<br/>
Calendar event (work meeting) > activate do not disturb mode.
+
When this trigger is used, you can access magic text via the [...] button where available.<br/>[https://macrodroidforum.com/wiki/index.php/Magic_text#Bluethooth_.28Device_connected_or_device_disconnected.29 Magic text]
 +
 
 +
'''Configuration Options'''
 +
 
 +
* '''Event starts / Event ends'''
 +
Defines whether the event will start at the beginning of the event or at the end of the event.
 +
 
 +
* '''Calendar'''
 +
Choose the specific calendar that you want to monitor for events.
 +
 
 +
* '''Availability'''
 +
You can choose to trigger only if the free/busy state is set or trigger on any state (default).
 +
 
 +
* '''Title (Optional)'''
 +
The event must match this title.
 +
 
 +
* '''Event detail (Optional)'''
 +
The event must match the detail text.
 +
 
 +
* '''Enable regular expression matching'''
 +
Regular expression matching (or regex matching) is a technique for finding patterns within text using a specialized syntax known as regular expressions. It's a powerful tool for text processing and pattern recognition.
 +
 
 +
* '''Case insensitive'''
 +
If enabled the text comparison will ignore any differences in upper and lower case text in the title and detail text.
 +
 
 +
* '''Ignore all day events'''
 +
When enabled, any events defined as full day will be ignored by the trigger.
 +
 
 +
* '''Check in advance'''
 +
Instead of triggering at the exact moment the calendar event triggers, it will check for events int he future (for example 2 hours in advance). This way, you can receive alerts in advance about a specific calendar event.
 +
 
 +
* '''Use negative value'''
 +
When using this option the trigger will fire at the specified time after the calendar event occurred (e.g. 2 hours after the calendar event).
 +
 
 +
* '''Use alarm'''
 +
Use this option if the trigger time is not accurate (and you need it) e.g. for high importance events it is recommended to enable this option else the calendar checking will likely be very sporadic.

Latest revision as of 22:06, 10 June 2024

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.

Magic Text
When this trigger is used, you can access magic text via the [...] button where available.
Magic text

Configuration Options

  • Event starts / Event ends

Defines whether the event will start at the beginning of the event or at the end of the event.

  • Calendar

Choose the specific calendar that you want to monitor for events.

  • Availability

You can choose to trigger only if the free/busy state is set or trigger on any state (default).

  • Title (Optional)

The event must match this title.

  • Event detail (Optional)

The event must match the detail text.

  • Enable regular expression matching

Regular expression matching (or regex matching) is a technique for finding patterns within text using a specialized syntax known as regular expressions. It's a powerful tool for text processing and pattern recognition.

  • Case insensitive

If enabled the text comparison will ignore any differences in upper and lower case text in the title and detail text.

  • Ignore all day events

When enabled, any events defined as full day will be ignored by the trigger.

  • Check in advance

Instead of triggering at the exact moment the calendar event triggers, it will check for events int he future (for example 2 hours in advance). This way, you can receive alerts in advance about a specific calendar event.

  • Use negative value

When using this option the trigger will fire at the specified time after the calendar event occurred (e.g. 2 hours after the calendar event).

  • Use alarm

Use this option if the trigger time is not accurate (and you need it) e.g. for high importance events it is recommended to enable this option else the calendar checking will likely be very sporadic.