Changes

no edit summary
Line 1: Line 1:  +
<pre class="header-style">
 
A trigger is an instantaneous event that your device can detect to make a macro run. A macro must have at least one trigger to be valid.
 
A trigger is an instantaneous event that your device can detect to make a macro run. A macro must have at least one trigger to be valid.
   −
It is possible to add multiple triggers to a single macro and in this case any single trigger firing will cause the macro to be invoked. It is not possible to combine triggers with AND logic because in MacroDroid a trigger is an instantaneous event, so it is not possible (or highly improbable) to get a state where two instantaneous events happen at exactly the same time.
+
For a trigger to fire, the macro must be enabled (i.e. ready to run, not disabled) at the exact time the event occurs.
 +
</pre>
   −
As an alternative to combining triggers with an AND statement it is generally possible to add constraint logic to individual triggers such that they can be limited to run when only some other state is also true.
+
It is possible to add multiple triggers to a single macro and in this case any single trigger firing will cause the macro to be invoked.
   −
== List of Triggers ==
+
It is not possible to combine triggers with AND logic when using [[Constraint: Trigger Fired|Trigger Fired]] constraint (Basically saying "If trigger 1 fired AND trigger 2 fired") because a trigger is an instantaneous event, so it is not possible (or highly improbable) to get a state where two instantaneous events happen at exactly the same time. There's always exactly 1 trigger that started an execution of your macro actions.
 +
 
 +
As an alternative to combining triggers with an AND statement it is generally possible to add constraint logic to individual triggers such that they can be limited to fire when only some other state is also true.
 +
 
 +
= List of Triggers =
 +
 
 +
[[Trigger: Accessibility Service State|Accessibility Service State]]
    
[[Trigger: Activity Recognition|Activity Recognition]]
 
[[Trigger: Activity Recognition|Activity Recognition]]
Line 29: Line 37:  
[[Trigger: Bluetooth Beacon (experimental)|Bluetooth Beacon (experimental)]]
 
[[Trigger: Bluetooth Beacon (experimental)|Bluetooth Beacon (experimental)]]
   −
[[Bluetooth Event]]
+
[[Trigger: Bluetooth Event|Bluetooth Event]]
   −
[[Calendar Event]]
+
[[Trigger: Calendar Event|Calendar Event]]
   −
[[Call Active]]
+
[[Trigger: Call Active|Call Active]]
   −
[[Call Ended]]
+
[[Trigger: Call Ended|Call Ended]]
   −
[[Call Incoming]]
+
[[Trigger: Call Incoming|Call Incoming]]
   −
[[Call Missed]]
+
[[Trigger: Call Missed|Call Missed]]
   −
[[Call Outgoing]]
+
[[Trigger: Call Outgoing|Call Outgoing]]
    
[[Trigger: Cell Tower Change|Cell Tower Change]]
 
[[Trigger: Cell Tower Change|Cell Tower Change]]
    
[[Trigger: Clipboard Change|Clipboard Change]]
 
[[Trigger: Clipboard Change|Clipboard Change]]
 +
 +
[[Trigger: Dark Theme Change|Dark Theme Change]]
    
[[Trigger: Data Connectivity Change|Data Connectivity Change]]
 
[[Trigger: Data Connectivity Change|Data Connectivity Change]]
Line 64: Line 74:     
[[Trigger: Failed Login Attempt|Failed Login Attempt]]
 
[[Trigger: Failed Login Attempt|Failed Login Attempt]]
 +
 +
[[Trigger: File Shared to MacroDroid|File Shared to MacroDroid]]
    
[[Trigger: Fingerprint Gesture|Fingerprint Gesture]]
 
[[Trigger: Fingerprint Gesture|Fingerprint Gesture]]
Line 70: Line 82:     
[[Trigger: Floating Button|Floating Button]]
 
[[Trigger: Floating Button|Floating Button]]
 +
 +
[[Trigger: Fold State|Fold State]]
    
[[Trigger: Geofence Trigger|Geofence Trigger]]
 
[[Trigger: Geofence Trigger|Geofence Trigger]]
Line 80: Line 94:     
[[Trigger: Hotspot Enabled/Disabled|Hotspot Enabled/Disabled]]
 
[[Trigger: Hotspot Enabled/Disabled|Hotspot Enabled/Disabled]]
 +
 +
[[Trigger: HTTP Server Request|HTTP Server Request]]
    
[[Trigger: Intent Received|Intent Received]]
 
[[Trigger: Intent Received|Intent Received]]
Line 90: Line 106:     
[[Trigger: Logcat Message|Logcat Message]]
 
[[Trigger: Logcat Message|Logcat Message]]
 +
 +
[[Trigger: Macro enabled|Macro enabled]]
 +
 +
[[Trigger: Macro finished|Macro finished]]
    
[[Trigger: MacroDroid Drawer Open/Close|MacroDroid Drawer Open/Close]]
 
[[Trigger: MacroDroid Drawer Open/Close|MacroDroid Drawer Open/Close]]
 +
 +
[[Trigger: MacroDroid Icon Long Press Shortcut|MacroDroid Icon Long Press Shortcut]]
    
[[Trigger: MacroDroid Initialised|MacroDroid Initialised]]
 
[[Trigger: MacroDroid Initialised|MacroDroid Initialised]]
Line 102: Line 124:     
[[Trigger: Media Button V2 Beta|Media Button V2 Beta]]
 
[[Trigger: Media Button V2 Beta|Media Button V2 Beta]]
 +
 +
[[Trigger: Media Track Changed|Media Track Changed]]
    
[[Trigger: Mobile Service Status|Mobile Service Status]]
 
[[Trigger: Mobile Service Status|Mobile Service Status]]
    
[[Trigger: Music/Sound playing|Music/Sound playing]]
 
[[Trigger: Music/Sound playing|Music/Sound playing]]
 +
 +
[[Trigger: NFC Enabled State|NFC Enabled State]]
    
[[Trigger: NFC Tag|NFC Tag]]
 
[[Trigger: NFC Tag|NFC Tag]]
Line 113: Line 139:  
[[Trigger: Notification Bar Button|Notification Bar Button]]
 
[[Trigger: Notification Bar Button|Notification Bar Button]]
   −
[[Trigger: Power Button Toggle|Power Button Toggle|Power Button Toggle|Power Button Toggle]]
+
[[Trigger: Photo Taken|Photo Taken]]
 +
 
 +
[[Trigger: Popup Message|Popup Message]]
 +
 
 +
[[Trigger: Power Button Long Press|Power Button Long Press]]
 +
 
 +
[[Trigger: Power Button Toggle|Power Button Toggle]]
    
[[Trigger: Power Connected/Disconnected|Power Connected/Disconnected]]
 
[[Trigger: Power Connected/Disconnected|Power Connected/Disconnected]]
Line 128: Line 160:     
[[Trigger: Roaming Started/Stopped|Roaming Started/Stopped]]
 
[[Trigger: Roaming Started/Stopped|Roaming Started/Stopped]]
 +
 +
[[Trigger: Screen content|Screen content]]
    
[[Trigger: Screen On/Off|Screen On/Off]]
 
[[Trigger: Screen On/Off|Screen On/Off]]
Line 134: Line 168:     
[[Trigger: Screen Unlocked|Screen Unlocked]]
 
[[Trigger: Screen Unlocked|Screen Unlocked]]
 +
 +
[[Trigger: Screenshot Content|Screenshot Content]]
    
[[Trigger: Shake Device|Shake Device]]
 
[[Trigger: Shake Device|Shake Device]]
   −
[[Trigger: Shortcut Launched]]
+
[[Trigger: Shortcut Launched|Shortcut Launched]]
   −
[[Silent Mode Enabled/Disabled]]
+
[[Trigger: Silent Mode Enabled/Disabled|Silent Mode Enabled/Disabled]]
    
[[Trigger: Sim Card Change|Sim Card Change]]
 
[[Trigger: Sim Card Change|Sim Card Change]]
 +
 +
[[Trigger: Sleep|Sleep]]
    
[[Trigger: SMS Received|SMS Received]]
 
[[Trigger: SMS Received|SMS Received]]
 +
 +
[[Trigger: SMS Sent|SMS Sent]]
 +
 +
[[Trigger: Spotify|Spotify]]
    
[[Trigger: Stopwatch|Stopwatch]]
 
[[Trigger: Stopwatch|Stopwatch]]
Line 150: Line 192:     
[[Trigger: Swipe Screen|Swipe Screen]]
 
[[Trigger: Swipe Screen|Swipe Screen]]
 +
 +
[[Trigger: System log|System Log Entry]]
 +
 +
[[Trigger: System Setting Change|System Setting Change]]
    
[[Trigger: Tasker/Locale Plugin|Tasker/Locale Plugin]]
 
[[Trigger: Tasker/Locale Plugin|Tasker/Locale Plugin]]
 +
 +
[[Trigger: Text Shared to MacroDroid|Text Shared to MacroDroid]]
 +
 +
[[Trigger: Torch On/Off|Torch On/Off]]
 +
 +
[[Trigger: UI Click|UI Click]]
    
[[Trigger: USB Device Connect/Disconnect|USB Device Connect/Disconnect]]
 
[[Trigger: USB Device Connect/Disconnect|USB Device Connect/Disconnect]]
 +
 +
[[Trigger: USB Tethering|USB Tethering]]
    
[[Trigger: Volume Button Long Press|Volume Button Long Press]]
 
[[Trigger: Volume Button Long Press|Volume Button Long Press]]