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

Revision as of 22:39, 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

When selecting consecutive days (e.g., Monday through Friday), the display will show this as a range (Mon - Fri) for brevity.
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

@@ Line 1: / Line 1: @@
 <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>
-'''Configuration Options'''
+''' Options '''
-* Days/Time
+* '''Time''' - Set the hour, minute, and optionally seconds for when the trigger should fire.
-You can enable one or more specific days of the week and select a fixed time of day. For example, every Monday-Friday at 8 am.
+* '''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
+* '''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.
-Modern Android devices can delay waking up the device at the requested time, so please enable this option to ensure the device will wake up and trigger the macro at exactly the desired time.
+* '''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)
-'''Example Usage'''<br/>
+''' Examples '''
-From Monday to Friday I always leave home at 7 am, so this macro deactivates the wifi and activates the mobile data and bluetooth ready to connect to my car.
-<pre class="trigger-style">
-Triggers
-Day/Time 07:00 Mon - fri
+Example 1: Morning alarm on weekdays
-</pre>
-<pre class="action-style">
+  <pre class="trigger-style">Triggers
-Actions
+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 '''
+* When selecting consecutive days (e.g., Monday through Friday), the display will show this as a range (Mon - Fri) for brevity.
+* 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 Bluetooth
+* [[Trigger:_Stopwatch|Stopwatch Trigger]]
-</pre>