MacroDroid Wiki

Difference between revisions of "Constraints"

Page Discussion
m
 
(23 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]]
  
−
== List of Constraints ==
+
[[Constraint: Floating Text|Floating Text]]
  
−
[[Airplane Mode]]
+
[[Constraint: Geofence|Geofence (Location)]]
  
−
[[AND / OR / NOT]]
+
[[Constraint: GPS State|GPS State]]
  
−
[[Application Running]]
+
[[Constraint: Headphone Connection|Headphone Connection]]
  
−
[[Auto Rotate]]
+
[[Constraint: IP address|IP address]]
  
−
[[Auto Sync]]
+
[[Constraint: Is Roaming|Is Roaming]]
  
−
[[Battery Level]]
+
[[Constraint: Light Sensor|Light Sensor]]
  
−
[[Battery Saver State]]
+
[[Constraint: Location Mode|Location Mode]]
  
−
[[Battery Temperature]]
+
[[Constraint: Macro Running|Macro Running]]
  
−
[[Bluetooth State]]
+
[[Constraint: Macro(s) Enabled/Disabled|Macro(s) Enabled/Disabled]]
  
−
[[Brightness]]
+
[[Constraint: Macro(s) Invoked/Not invoked Recently|Macro(s) Invoked/Not invoked Recently]]
  
−
[[Calendar Entry]]
+
[[Constraint: MacroDroid Invocation Method|MacroDroid Invocation Method]]
  
−
[[Call State]]
+
[[Constraint: MacroDroid Mode|MacroDroid Mode]]
  
−
[[Cell Towers]]
+
[[Constraint: MacroDroid Variable|MacroDroid Variable]]
  
−
[[Dark Mode]]
+
[[Constraint: Mobile Data On/Off|Mobile Data On/Off]]
  
−
[[Day of the Month]]
+
[[Constraint: Mobile Service Status|Mobile Service Status]]
  
−
[[Day of the Week]]
+
[[Constraint: Month of the Year|Month of the Year]]
  
−
[[Device Facing]]
+
[[Constraint: Music Active|Music Active]]
  
−
[[Device Locked/Unlocked]]
+
[[Constraint: NFC State|NFC State]]
  
−
[[Device Orientation]]
+
[[Constraint: Notification Present|Notification Present]]
  
−
[[GPS State]]
+
[[Constraint: Notification Volume|Notification Volume]]
  
−
[[Headphone Connection]]
+
[[Constraint: Phone Ringing|Phone Ringing]]
  
−
[[Is Roaming]]
+
[[Constraint: Power Connected|Power Connected]]
  
−
[[Light Sensor]]
+
[[Constraint: Priority Mode / Do Not Disturb|Priority Mode / Do Not Disturb]]
  
−
[[Location Mode]]
+
[[Constraint: Proximity Sensor|Proximity Sensor]]
  
−
[[Macro(s) Enabled/Disabled]]
+
[[Constraint: Quick Tile State|Quick Tile State]]
  
−
[[Macro(s) Invoked/Not invoked Recently]]
+
[[Constraint: Ringer Volume|Ringer Volume]]
  
−
[[MacroDroid Mode]]
+
[[Constraint: Roaming Enabled|Roaming Enabled]]
  
−
[[MacroDroid Variable]]
+
[[Constraint: Rooted Device|Rooted Device]]
  
−
[[Mobile Data On/Off]]
+
[[Constraint: Screen On/Off|Screen On/Off]]
  
−
[[Mobile Service Status]]
+
[[Constraint: Speakerphone On/Off|Speakerphone On/Off]]
  
−
[[Month of the Year]]
+
[[Constraint: Stopwatch|Stopwatch]]
  
−
[[Music Active]]
+
[[Constraint: Sunrise/Sunset|Sunrise/Sunset]]
  
−
[[NFC State]]
+
[[Constraint: System Settings|System Settings]]
  
−
[[Notification Present]]
+
[[Constraint: Time of Day|Time of Day]]
  
−
[[Notification Volume]]
+
[[Constraint: Time Since Boot|Time Since Boot]]
  
−
[[Phone Ringing]]
+
[[Constraint: Torch On/Off|Torch On/Off]]
  
−
[[Power Connected]]
+
[[Constraint: Trigger Fired|Trigger Fired]]
  
−
[[Priority Mode / Do Not Disturb]]
+
[[Constraint: Volume Level|Volume Level]]
  
−
[[Proximity Sensor]]
+
[[Constraint: VPN State|VPN State]]
  
−
[[Ringer Volume]]
+
[[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

Retrieved from ‘https://macrodroidforum.com/wiki/index.php?title=Constraints&oldid=2212’