m
 
(26 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>
  
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.
+
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:
 
For example:
 +
 +
  
 
  AND
 
  AND
Line 19: 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]]
 +
 +
[[Constraint: Macro(s) Enabled/Disabled|Macro(s) Enabled/Disabled]]
 +
 +
[[Constraint: Macro(s) Invoked/Not invoked Recently|Macro(s) Invoked/Not invoked Recently]]
 +
 +
[[Constraint: MacroDroid Invocation Method|MacroDroid Invocation Method]]
 +
 +
[[Constraint: MacroDroid Mode|MacroDroid Mode]]
 +
 +
[[Constraint: MacroDroid Variable|MacroDroid Variable]]
 +
 +
[[Constraint: Mobile Data On/Off|Mobile Data On/Off]]
 +
 +
[[Constraint: Mobile Service Status|Mobile Service Status]]
 +
 +
[[Constraint: Month of the Year|Month of the Year]]
 +
 +
[[Constraint: Music Active|Music Active]]
 +
 +
[[Constraint: NFC State|NFC State]]
 +
 +
[[Constraint: Notification Present|Notification Present]]
 +
 +
[[Constraint: Notification Volume|Notification Volume]]
 +
 +
[[Constraint: Phone Ringing|Phone Ringing]]
 +
 +
[[Constraint: Power Connected|Power Connected]]
 +
 +
[[Constraint: Priority Mode / Do Not Disturb|Priority Mode / Do Not Disturb]]
 +
 +
[[Constraint: Proximity Sensor|Proximity Sensor]]
 +
 +
[[Constraint: Quick Tile State|Quick Tile State]]
 +
 +
[[Constraint: Ringer Volume|Ringer Volume]]
 +
 +
[[Constraint: Roaming Enabled|Roaming Enabled]]
 +
 +
[[Constraint: Rooted Device|Rooted Device]]
 +
 +
[[Constraint: Screen On/Off|Screen On/Off]]
 +
 +
[[Constraint: Speakerphone On/Off|Speakerphone On/Off]]
 +
 +
[[Constraint: Stopwatch|Stopwatch]]
 +
 +
[[Constraint: Sunrise/Sunset|Sunrise/Sunset]]
 +
 +
[[Constraint: System Settings|System Settings]]
 +
 +
[[Constraint: Time of Day|Time of Day]]
 +
 +
[[Constraint: Time Since Boot|Time Since Boot]]
 +
 +
[[Constraint: Torch On/Off|Torch On/Off]]
 +
 +
[[Constraint: Trigger Fired|Trigger Fired]]
 +
 +
[[Constraint: Volume Level|Volume Level]]
 +
 +
[[Constraint: VPN State|VPN State]]
  
== List of Constraints ==
+
[[Constraint: Wifi HotSpot State|Wifi HotSpot State]]
  
[[Airplane Mode]]
+
[[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