(56 intermediate revisions by 6 users not shown)
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.
  
[[Activity Recognition]]
+
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.
  
[[Airplane mode changed]]
+
= List of Triggers =
  
[[Android Wear]]
+
[[Trigger: Activity Recognition|Activity Recognition]]
  
[[App Install/Remove/Update]]
+
[[Trigger: Airplane mode changed|Airplane mode changed]]
  
[[Application Launches/Closed]]
+
[[Trigger: Android Wear|Android Wear]]
  
[[Auto Rotate changed]]
+
[[Trigger: App Install/Remove/Update|App Install/Remove/Update]]
  
[[Autosync changed]]
+
[[Trigger: Application Launched/Closed|Application Launched/Closed]]
  
[[Battery Level]]
+
[[Trigger: Auto Rotate changed|Auto Rotate changed]]
  
[[Battery Saver State]]
+
[[Trigger: Autosync changed|Autosync changed]]
  
[[Battery Temperature]]
+
[[Trigger: Battery Level|Battery Level]]
  
[[Bluetooth Beacon (experimental)]]
+
[[Trigger: Battery Saver State|Battery Saver State]]
  
[[Bluetooth Event]]
+
[[Trigger: Battery Temperature|Battery Temperature]]
  
[[Calendar Event]]
+
[[Trigger: Bluetooth Beacon (experimental)|Bluetooth Beacon (experimental)]]
  
[[Call Active]]
+
[[Trigger: Bluetooth Event|Bluetooth Event]]
  
[[Call Ended]]
+
[[Trigger: Calendar Event|Calendar Event]]
  
[[Call Incoming]]
+
[[Trigger: Call Active|Call Active]]
  
[[Call Missed]]
+
[[Trigger: Call Ended|Call Ended]]
  
[[Call Outgoing]]
+
[[Trigger: Call Incoming|Call Incoming]]
  
[[Cell Tower Change]]
+
[[Trigger: Call Missed|Call Missed]]
  
[[Clipboard Change]]
+
[[Trigger: Call Outgoing|Call Outgoing]]
  
[[Data Connectivity Change]]
+
[[Trigger: Cell Tower Change|Cell Tower Change]]
  
[[Day of Week/Month]]
+
[[Trigger: Clipboard Change|Clipboard Change]]
  
[[Day/Time Trigger]]
+
[[Trigger: Dark Theme Change|Dark Theme Change]]
  
[[Daydream On/Off]]
+
[[Trigger: Data Connectivity Change|Data Connectivity Change]]
  
[[Device Boot]]
+
[[Trigger: Day of Week/Month|Day of Week/Month]]
  
[[Device Docked/Undocked]]
+
[[Trigger: Day/Time Trigger|Day/Time Trigger]]
  
[[Dial Phone Number]]
+
[[Trigger: Daydream On/Off|Daydream On/Off]]
  
[[Empty Trigger]]
+
[[Trigger: Device Boot|Device Boot]]
  
[[Failed Login Attempt]]
+
[[Trigger: Device Docked/Undocked|Device Docked/Undocked]]
  
[[Fingerprint Gesture]]
+
[[Trigger: Dial Phone Number|Dial Phone Number]]
  
[[Flip Device]]
+
[[Trigger: Empty Trigger|Empty Trigger]]
  
[[Floating Buttn]]
+
[[Trigger: Failed Login Attempt|Failed Login Attempt]]
  
[[Geofence Trigger]]
+
[[Trigger: Fingerprint Gesture|Fingerprint Gesture]]
  
[[GPS Enabled/Disabled]]
+
[[Trigger: Flip Device|Flip Device]]
  
[[Headphones Insert/Removed]]
+
[[Trigger: Floating Button|Floating Button]]
  
[[Home Button Long Press]]
+
[[Trigger: Geofence Trigger|Geofence Trigger]]
  
[[Hotspot Enabled/Disabled]]
+
[[Trigger: GPS Enabled/Disabled|GPS Enabled/Disabled]]
  
[[Intent Received]]
+
[[Trigger: Headphones Insert/Removed|Headphones Insert/Removed]]
  
[[IP address Change]]
+
[[Trigger: Home Button Long Press|Home Button Long Press]]
  
[[Light Sensor]]
+
[[Trigger: Hotspot Enabled/Disabled|Hotspot Enabled/Disabled]]
  
[[Location Trigger]]
+
[[Trigger: HTTP Server Request|HTTP Server Request]]
  
[[Logcat Message]]
+
[[Trigger: Intent Received|Intent Received]]
  
[[MacroDroid Drawer Open/Close]]
+
[[Trigger: IP address Change|IP address Change]]
  
[[MacroDroid Initialised]]
+
[[Trigger: Light Sensor|Light Sensor]]
  
[[MacroDroid Mode Change]]
+
[[Trigger: Location Trigger|Location Trigger]]
  
[[MacroDroid Variable Change]]
+
[[Trigger: Logcat Message|Logcat Message]]
  
[[Media Button Pressed]]
+
[[Trigger: Macro enabled|Macro enabled]]
  
[[Media Button V2 Beta]]
+
[[Trigger: Macro finished|Macro finished]]
  
[[Mobile Service Status]]
+
[[Trigger: MacroDroid Drawer Open/Close|MacroDroid Drawer Open/Close]]
  
[[Music/Sound playing]]
+
[[Trigger: MacroDroid Initialised|MacroDroid Initialised]]
  
[[NFC Tag]]
+
[[Trigger: MacroDroid Mode Change|MacroDroid Mode Change]]
  
[[Notification]]
+
[[Trigger: MacroDroid Variable Change|MacroDroid Variable Change]]
  
[[Notification Bar Button]]
+
[[Trigger: Media Button Pressed|Media Button Pressed]]
  
[[Power Button Toggle]]
+
[[Trigger: Media Button V2 Beta|Media Button V2 Beta]]
  
[[Power Connected/Disconnected]]
+
[[Trigger: Mobile Service Status|Mobile Service Status]]
  
[[Priority Mode/Do Not Disturb]]
+
[[Trigger: Music/Sound playing|Music/Sound playing]]
  
[[Proximity Sensor]]
+
[[Trigger: NFC Tag|NFC Tag]]
  
[[Quick Settings tile]]
+
[[Trigger: Notification|Notification]]
  
[[Recent Apps Opened]]
+
[[Trigger: Notification Bar Button|Notification Bar Button]]
  
[[Regular Interval]]
+
[[Trigger: Power Button Long Press|Power Button Long Press]]
  
[[Roaming Started/Stopped]]
+
[[Trigger: Power Button Toggle|Power Button Toggle]]
  
[[Screen On/Off]]
+
[[Trigger: Power Connected/Disconnected|Power Connected/Disconnected]]
  
[[Screen Orientation]]
+
[[Trigger: Priority Mode/Do Not Disturb|Priority Mode/Do Not Disturb]]
  
[[Screen Unlocked]]
+
[[Trigger: Proximity Sensor|Proximity Sensor]]
  
[[Shake Device]]
+
[[Trigger: Quick Settings tile|Quick Settings tile]]
  
[[Shortcut Launched]]
+
[[Trigger: Recent Apps Opened|Recent Apps Opened]]
  
[[Silent Mode Enabled/Disabled]]
+
[[Trigger: Regular Interval|Regular Interval]]
  
[[Sim Card Change]]
+
[[Trigger: Roaming Started/Stopped|Roaming Started/Stopped]]
  
[[SMS Received]]
+
[[Trigger: Screen content|Screen content]]
  
[[Stopwatch]]
+
[[Trigger: Screen On/Off|Screen On/Off]]
  
[[Sunset/Sunrise]]
+
[[Trigger: Screen Orientation|Screen Orientation]]
  
[[Swipe Screen]]
+
[[Trigger: Screen Unlocked|Screen Unlocked]]
  
[[Tasker/Locale Plugin]]
+
[[Trigger: Shake Device|Shake Device]]
  
[[USB Device Connect/Disconnect]]
+
[[Trigger: Shortcut Launched|Shortcut Launched]]
  
[[Volume Button Long Press]]
+
[[Trigger: Silent Mode Enabled/Disabled|Silent Mode Enabled/Disabled]]
  
[[Volume Button Press]]
+
[[Trigger: Sim Card Change|Sim Card Change]]
  
[[VPN State]]
+
[[Trigger: Sleep|Sleep]]
  
[[Weather]]
+
[[Trigger: SMS Received|SMS Received]]
  
[[Webhook (URL)]]
+
[[Trigger: SMS Sent|SMS Sent]]
  
[[Widget Button]]
+
[[Trigger: Spotify|Spotify]]
  
[[Wifi SSID Transition]]
+
[[Trigger: Stopwatch|Stopwatch]]
  
[[Wifi State Change]]
+
[[Trigger: Sunset/Sunrise|Sunset/Sunrise]]
 +
 
 +
[[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: Text Shared to MacroDroid|Text Shared to MacroDroid]]
 +
 
 +
[[Trigger: UI Click|UI Click]]
 +
 
 +
[[Trigger: USB Device Connect/Disconnect|USB Device Connect/Disconnect]]
 +
 
 +
[[Trigger: Volume Button Long Press|Volume Button Long Press]]
 +
 
 +
[[Trigger: Volume Button Press|Volume Button Press]]
 +
 
 +
[[Trigger: VPN State|VPN State]]
 +
 
 +
[[Trigger: Weather|Weather]]
 +
 
 +
[[Trigger: Webhook (URL)|Webhook (URL)]]
 +
 
 +
[[Trigger: Widget Button|Widget Button]]
 +
 
 +
[[Trigger: Wifi SSID Transition|Wifi SSID Transition]]
 +
 
 +
[[Trigger: Wifi State Change|Wifi State Change]]

Latest revision as of 22:17, 10 June 2024

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.

For a trigger to fire, the macro must be enabled (i.e. ready to run, not disabled) at the exact time the event occurs.

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 when using 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

Activity Recognition

Airplane mode changed

Android Wear

App Install/Remove/Update

Application Launched/Closed

Auto Rotate changed

Autosync changed

Battery Level

Battery Saver State

Battery Temperature

Bluetooth Beacon (experimental)

Bluetooth Event

Calendar Event

Call Active

Call Ended

Call Incoming

Call Missed

Call Outgoing

Cell Tower Change

Clipboard Change

Dark Theme Change

Data Connectivity Change

Day of Week/Month

Day/Time Trigger

Daydream On/Off

Device Boot

Device Docked/Undocked

Dial Phone Number

Empty Trigger

Failed Login Attempt

Fingerprint Gesture

Flip Device

Floating Button

Geofence Trigger

GPS Enabled/Disabled

Headphones Insert/Removed

Home Button Long Press

Hotspot Enabled/Disabled

HTTP Server Request

Intent Received

IP address Change

Light Sensor

Location Trigger

Logcat Message

Macro enabled

Macro finished

MacroDroid Drawer Open/Close

MacroDroid Initialised

MacroDroid Mode Change

MacroDroid Variable Change

Media Button Pressed

Media Button V2 Beta

Mobile Service Status

Music/Sound playing

NFC Tag

Notification

Notification Bar Button

Power Button Long Press

Power Button Toggle

Power Connected/Disconnected

Priority Mode/Do Not Disturb

Proximity Sensor

Quick Settings tile

Recent Apps Opened

Regular Interval

Roaming Started/Stopped

Screen content

Screen On/Off

Screen Orientation

Screen Unlocked

Shake Device

Shortcut Launched

Silent Mode Enabled/Disabled

Sim Card Change

Sleep

SMS Received

SMS Sent

Spotify

Stopwatch

Sunset/Sunrise

Swipe Screen

System Log Entry

System Setting Change

Tasker/Locale Plugin

Text Shared to MacroDroid

UI Click

USB Device Connect/Disconnect

Volume Button Long Press

Volume Button Press

VPN State

Weather

Webhook (URL)

Widget Button

Wifi SSID Transition

Wifi State Change