m
 
(24 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Constraints are optional and can be used to allow or prevent a macro/action from running based on certain conditions.
+
<span style="color: #0E9549; font-size: 24px;">'''What is a constraint?'''</span>
  
Constraints can be placed on macros to allow or prevent the entire macro firing based on the set condition(s). You can also add constraints directly to individual triggers and actions from the 'Edit Macro' screen, by clicking on the trigger/action and selecting "Add constraint"
+
Constraints in MacroDroid are optional tools that allow you to control when a macro or a specific action is triggered.
  
A constraint is evaluated at the point a trigger fires or actions runs and a macro/action will only run if the <strong>constraint condition is true.</strong>
+
They are based on certain conditions that must be met to allow or prevent the execution of macros and actions.
  
By default if adding more than one constraint to a macro they will be combined with an AND condition (e.g. all added constraints must be true). This can be changed in the dropdown in the constraints title to an OR condition. In this case only one of the added constraints needs to be true for the macro to run.
 
  
<strong>Nesting constraints</strong>
+
<span style="color: #0E9549; font-size: 24px;">'''Apply to entire macros:'''</span>
 +
 
 +
You can apply constraints to an entire macro (at the bottom of the 'Constraints' tab).
 +
 
 +
This means that the macro will only be activated if the conditions set by the constraints are met.
 +
 
 +
<span style="color: #0E9549; font-size: 24px;">'''Restrictions on Triggers and Individual Actions:'''</span>
 +
 
 +
As well as being applied to an entire macro, constraints can be added directly to individual triggers and actions.
 +
 
 +
This is done from the 'Edit Macro' screen by selecting the trigger or action and selecting 'Add Constraint'.
 +
 
 +
<span style="color: #0E9549; font-size: 24px;">'''Nesting constraints'''</span>  
 +
 
 +
If you need more sophisticated logic applied to constraint there is a special AND/OR/XOR/NOT constraint that can be used.
 +
 
 +
Any constraints nested under the logic constraint will have that logic operator applied. It's also possible to nest multiple logic constraints to create complex logic.
 +
For example:
 +
 
  
If you need more sophisticated logic applied to constraint there is a special AND/OR/XOR/NOT constraint that can be used. Any constraints nested under the logic constraint will have that logic operator applied. It's also possible to nest multiple logic constraints to create complex logic. For example:
 
  
 
  AND
 
  AND
Line 17: Line 33:
 
       | - Constraint 3
 
       | - Constraint 3
  
 +
In the above example, Constraint 1 must always be true '''AND''' at least one of (Constraint 2 '''OR''' Constraint 3) must be true.
 +
 +
<span style="color: #0E9549; font-size: 24px;"><strong>List of Constraints</strong></span>
 +
 +
[[Constraint: ADB Hacked|ADB Hacked]]
 +
 +
[[Constraint: Airplane Mode|Airplane Mode]]
 +
 +
[[Constraint: AND / OR / XOR / NOT|AND / OR / XOR / NOT]]
 +
 +
[[Constraint: Application Running|Application Running]]
 +
 +
[[Constraint: Auto Rotate|Auto Rotate]]
 +
 +
[[Constraint: Auto Sync|Auto Sync]]
 +
 +
[[Constraint: Battery Level|Battery Level]]
 +
 +
[[Constraint: Battery Saver State|Battery Saver State]]
 +
 +
[[Constraint: Battery Temperature|Battery Temperature]]
 +
 +
[[Constraint: Bluetooth State|Bluetooth State]]
 +
 +
[[Constraint: Brightness|Brightness]]
 +
 +
[[Constraint: Calendar Entry|Calendar Entry]]
 +
 +
[[Constraint: Call State|Call State]]
 +
 +
[[Constraint: Category Enabled/Disabled|Category Enabled/Disabled]]
 +
 +
[[Constraint: Cell Towers|Cell Towers]]
 +
 +
[[Constraint: Clipboard content|Clipboard content]]
 +
 +
[[Constraint: Compare Values|Compare Values]]
 +
 +
[[Constraint: Dark Mode|Dark Mode]]
 +
 +
[[Constraint: Day of the Month|Day of the Month]]
 +
 +
[[Constraint: Day of the Week|Day of the Week]]
 +
 +
[[Constraint: Device Facing|Device Facing]]
 +
 +
[[Constraint: Device Locked/Unlocked|Device Locked/Unlocked]]
 +
 +
[[Constraint: Device Orientation|Device Orientation]]
 +
 +
[[Constraint: Floating Button|Floating Button]]
 +
 +
[[Constraint: Floating Text|Floating Text]]
 +
 +
[[Constraint: Geofence|Geofence (Location)]]
 +
 +
[[Constraint: GPS State|GPS State]]
 +
 +
[[Constraint: Headphone Connection|Headphone Connection]]
 +
 +
[[Constraint: IP address|IP address]]
 +
 +
[[Constraint: Is Roaming|Is Roaming]]
 +
 +
[[Constraint: Light Sensor|Light Sensor]]
 +
 +
[[Constraint: Location Mode|Location Mode]]
 +
 +
[[Constraint: Macro Running|Macro Running]]
  
== List of Constraints ==
+
[[Constraint: Macro(s) Enabled/Disabled|Macro(s) Enabled/Disabled]]
  
[[Airplane Mode]]
+
[[Constraint: Macro(s) Invoked/Not invoked Recently|Macro(s) Invoked/Not invoked Recently]]
  
[[AND / OR / NOT]]
+
[[Constraint: MacroDroid Invocation Method|MacroDroid Invocation Method]]
  
[[Application Running]]
+
[[Constraint: MacroDroid Mode|MacroDroid Mode]]
  
[[Auto Rotate]]
+
[[Constraint: MacroDroid Variable|MacroDroid Variable]]
  
[[Auto Sync]]
+
[[Constraint: Mobile Data On/Off|Mobile Data On/Off]]
  
[[Battery Level]]
+
[[Constraint: Mobile Service Status|Mobile Service Status]]
  
[[Battery Saver State]]
+
[[Constraint: Month of the Year|Month of the Year]]
  
[[Battery Temperature]]
+
[[Constraint: Music Active|Music Active]]
  
[[Bluetooth State]]
+
[[Constraint: NFC State|NFC State]]
  
[[Brightness]]
+
[[Constraint: Notification Present|Notification Present]]
  
[[Calendar Entry]]
+
[[Constraint: Notification Volume|Notification Volume]]
  
[[Call State]]
+
[[Constraint: Phone Ringing|Phone Ringing]]
  
[[Cell Towers]]
+
[[Constraint: Power Connected|Power Connected]]
  
[[Dark Mode]]
+
[[Constraint: Priority Mode / Do Not Disturb|Priority Mode / Do Not Disturb]]
  
[[Day of the Month]]
+
[[Constraint: Proximity Sensor|Proximity Sensor]]
  
[[Day of the Week]]
+
[[Constraint: Quick Tile State|Quick Tile State]]
  
[[Device Facing]]
+
[[Constraint: Ringer Volume|Ringer Volume]]
  
[[Device Locked/Unlocked]]
+
[[Constraint: Roaming Enabled|Roaming Enabled]]
  
[[Device Orientation]]
+
[[Constraint: Rooted Device|Rooted Device]]
  
[[GPS State]]
+
[[Constraint: Screen On/Off|Screen On/Off]]
  
[[Headphone Connection]]
+
[[Constraint: Speakerphone On/Off|Speakerphone On/Off]]
  
[[Is Roaming]]
+
[[Constraint: Stopwatch|Stopwatch]]
  
[[Light Sensor]]
+
[[Constraint: Sunrise/Sunset|Sunrise/Sunset]]
  
[[Location Mode]]
+
[[Constraint: System Settings|System Settings]]
  
[[Macro(s) Enabled/Disabled]]
+
[[Constraint: Time of Day|Time of Day]]
  
[[Macro(s) Invoked/Not invoked Recently]]
+
[[Constraint: Time Since Boot|Time Since Boot]]
  
[[MacroDroid Mode]]
+
[[Constraint: Torch On/Off|Torch On/Off]]
  
[[MacroDroid Variable]]
+
[[Constraint: Trigger Fired|Trigger Fired]]
  
[[Mobile Data On/Off]]
+
[[Constraint: Volume Level|Volume Level]]
  
[[Mobile Service Status]]
+
[[Constraint: VPN State|VPN State]]
  
[[Month of the Year]]
+
[[Constraint: Wifi HotSpot State|Wifi HotSpot State]]
  
[[
+
[[Constraint: Wifi State|Wifi State]]

Latest revision as of 15:51, 23 April 2024

What is a constraint?

Constraints in MacroDroid are optional tools that allow you to control when a macro or a specific action is triggered.

They are based on certain conditions that must be met to allow or prevent the execution of macros and actions.


Apply to entire macros:

You can apply constraints to an entire macro (at the bottom of the 'Constraints' tab).

This means that the macro will only be activated if the conditions set by the constraints are met.

Restrictions on Triggers and Individual Actions:

As well as being applied to an entire macro, constraints can be added directly to individual triggers and actions.

This is done from the 'Edit Macro' screen by selecting the trigger or action and selecting 'Add Constraint'.

Nesting constraints

If you need more sophisticated logic applied to constraint there is a special AND/OR/XOR/NOT constraint that can be used.

Any constraints nested under the logic constraint will have that logic operator applied. It's also possible to nest multiple logic constraints to create complex logic. For example:


AND
 | - Constraint 1
 | - OR
     | - Constraint 2
     | - Constraint 3

In the above example, Constraint 1 must always be true AND at least one of (Constraint 2 OR Constraint 3) must be true.

List of Constraints

ADB Hacked

Airplane Mode

AND / OR / XOR / NOT

Application Running

Auto Rotate

Auto Sync

Battery Level

Battery Saver State

Battery Temperature

Bluetooth State

Brightness

Calendar Entry

Call State

Category Enabled/Disabled

Cell Towers

Clipboard content

Compare Values

Dark Mode

Day of the Month

Day of the Week

Device Facing

Device Locked/Unlocked

Device Orientation

Floating Button

Floating Text

Geofence (Location)

GPS State

Headphone Connection

IP address

Is Roaming

Light Sensor

Location Mode

Macro Running

Macro(s) Enabled/Disabled

Macro(s) Invoked/Not invoked Recently

MacroDroid Invocation Method

MacroDroid Mode

MacroDroid Variable

Mobile Data On/Off

Mobile Service Status

Month of the Year

Music Active

NFC State

Notification Present

Notification Volume

Phone Ringing

Power Connected

Priority Mode / Do Not Disturb

Proximity Sensor

Quick Tile State

Ringer Volume

Roaming Enabled

Rooted Device

Screen On/Off

Speakerphone On/Off

Stopwatch

Sunrise/Sunset

System Settings

Time of Day

Time Since Boot

Torch On/Off

Trigger Fired

Volume Level

VPN State

Wifi HotSpot State

Wifi State