Difference between revisions of "Trigger: Day/Time Trigger"

 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<pre class="header-style">
 
<pre class="header-style">
This trigger will fire on the selected days of the week at the defined time.
+
This trigger can be configured to fire at a certain time of day on selected days of the week.
 
</pre>
 
</pre>
  
'''Configuration Options'''
+
''' Options '''
  
You can choose a specific day of the week and time, for example, every Monday at 8 am.
+
* '''Time''' - Set the hour, minute, and optionally seconds for when the trigger should fire.
  
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.
+
* '''Days of Week''' - Select one or more days of the week when the trigger should be active. You can select any combination of Monday through Sunday.
  
'''Example Usage'''<br/>
+
* '''Use Alarm Clock''' - When enabled, the system treats this as an alarm clock event, which may provide more reliable timing on some devices that aggressively manage background processes.
From Monday to Friday I always leave home at 7 am, so this macro deactivates the wifi and activates the mobile data and activates the car mode.
 
<pre class="trigger-style">
 
Triggers
 
  
Day/Time 07:00 Mon - fri
+
* '''Use Variable''' - Instead of fixed values, you can use a dictionary variable to dynamically control the trigger timing. The variable should contain:
</pre>
+
** hour (integer 0-23)
<pre class="action-style">
+
** minute (integer 0-59)
Actions
+
** second (integer 0-59, optional)
 +
** days (array of 7 booleans for Mon, Tue, Wed, Thu, Fri, Sat, Sun)
 +
 
 +
''' Examples '''
 +
 
 +
Example 1: Morning alarm on weekdays
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Day/Time [07:00 Mon, Tue, Wed, Thu, Fri]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Play Sound: Alarm tone
 +
Set Volume: Media 70%</pre>
 +
 
 +
Example 2: Weekend notification
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Day/Time [10:00 Sat, Sun]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Notification: Good morning! Enjoy your weekend!</pre>
 +
 
 +
Example 3: Daily backup at midnight
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Day/Time [00:00 Mon - Sun]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Export Macros</pre>
 +
  <pre class="constraint-style">Constraints
 +
 
 +
WiFi Connected</pre>
 +
 
 +
''' Notes '''
 +
 
 +
* The trigger automatically adjusts for timezone changes, rescheduling when the timezone is modified.
 +
* When using variable mode, the trigger will automatically reschedule when the variable value changes.
 +
* The trigger schedules only the next upcoming alarm time, not all instances, for efficiency.
 +
* Requires the SCHEDULE_EXACT_ALARM permission on Android 12+ for reliable timing.
 +
* If you need a trigger for a specific day of the month rather than day of the week, use the Day of Week/Month trigger instead.
 +
 
 +
''' Permissions Required '''
 +
 
 +
* SCHEDULE_EXACT_ALARM (Android 12+)
 +
 
 +
''' See Also '''
  
Disable WIFI
+
* [[Trigger:_Day_of_Week/Month|Day of Week/Month Trigger]]
Enable mobile data
+
* [[Trigger:_Regular_Interval|Regular Interval Trigger]]
Enable car mode
+
* [[Trigger:_Stopwatch|Stopwatch Trigger]]
</pre>
 

Latest revision as of 22:40, 5 January 2026

This trigger can be configured to fire at a certain time of day on selected days of the week.

Options

  • Time - Set the hour, minute, and optionally seconds for when the trigger should fire.
  • Days of Week - Select one or more days of the week when the trigger should be active. You can select any combination of Monday through Sunday.
  • Use Alarm Clock - When enabled, the system treats this as an alarm clock event, which may provide more reliable timing on some devices that aggressively manage background processes.
  • Use Variable - Instead of fixed values, you can use a dictionary variable to dynamically control the trigger timing. The variable should contain:
    • hour (integer 0-23)
    • minute (integer 0-59)
    • second (integer 0-59, optional)
    • days (array of 7 booleans for Mon, Tue, Wed, Thu, Fri, Sat, Sun)

Examples

Example 1: Morning alarm on weekdays

Triggers

Day/Time [07:00 Mon, Tue, Wed, Thu, Fri]
Actions

Play Sound: Alarm tone
Set Volume: Media 70%

Example 2: Weekend notification

Triggers

Day/Time [10:00 Sat, Sun]
Actions

Notification: Good morning! Enjoy your weekend!

Example 3: Daily backup at midnight

Triggers

Day/Time [00:00 Mon - Sun]
Actions

Export Macros
Constraints

WiFi Connected

Notes

  • The trigger automatically adjusts for timezone changes, rescheduling when the timezone is modified.
  • When using variable mode, the trigger will automatically reschedule when the variable value changes.
  • The trigger schedules only the next upcoming alarm time, not all instances, for efficiency.
  • Requires the SCHEDULE_EXACT_ALARM permission on Android 12+ for reliable timing.
  • If you need a trigger for a specific day of the month rather than day of the week, use the Day of Week/Month trigger instead.

Permissions Required

  • SCHEDULE_EXACT_ALARM (Android 12+)

See Also