Difference between revisions of "Trigger: Calendar Event"

 
(3 intermediate revisions by the same user not shown)
Line 8: Line 8:
 
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]
 
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]
  
==<p><b>Supported configurations</b></p>==
+
'''Configuration Options'''
  
 
* '''Event starts / Event ends'''
 
* '''Event starts / Event ends'''
Line 14: Line 14:
  
 
* '''Calendar'''
 
* '''Calendar'''
Choose the account where the event is located, you can also select the category, e.g. birthdays, family, holidays in Mexico.
+
Choose the specific calendar that you want to monitor for events.
  
'''''Availability'''''
+
* '''Availability'''
It starts only if you are free/busy or any.
+
You can choose to trigger only if the free/busy state is set or trigger on any state (default).
  
'''''Title (Optional)'''''
+
* '''Title (Optional)'''
The event must have this title.
+
The event must match this title.
  
'''''Event detail (Optional)'''''
+
* '''Event detail (Optional)'''
The event must have these details/description.
+
The event must match the detail text.
  
'''''Enable regular expression matching'''''
+
* '''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.
 
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'''''
+
* '''Case insensitive'''
It will ignore the use of upper and lower case in title and detail.
+
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'''''
+
* '''Ignore all day events'''
Events defined as full day will be ignored by the trigger.
+
When enabled, any events defined as full day will be ignored by the trigger.
  
'''''Check in advance'''''
+
* '''Check in advance'''
Instead of triggering at the exact moment the calendar event triggers, it will check for it (for example) 2 hours in advance. This way, you can receive alerts in advance about a specific calendar event.
+
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'''''
+
* '''Use negative value'''
Use negative value (trigger x time after the event)
+
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 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 use an 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.