(52 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: Accessibility Service State|Accessibility Service State]]
  
[[App Install/Remove/Update]]
+
[[Trigger: Activity Recognition|Activity Recognition]]
  
[[Application Launches/Closed]]
+
[[Trigger: Airplane mode changed|Airplane mode changed]]
  
[[Auto Rotate changed]]
+
[[Trigger: Android Wear|Android Wear]]
  
[[Autosync changed]]
+
[[Trigger: App Install/Remove/Update|App Install/Remove/Update]]
  
[[Battery Level]]
+
[[Trigger: Application Launched/Closed|Application Launched/Closed]]
  
[[Battery Saver State]]
+
[[Trigger: Auto Rotate changed|Auto Rotate changed]]
  
[[Battery Temperature]]
+
[[Trigger: Autosync changed|Autosync changed]]
  
[[Bluetooth Beacon (experimental)]]
+
[[Trigger: Battery Level|Battery Level]]
  
[[Bluetooth Event]]
+
[[Trigger: Battery Saver State|Battery Saver State]]
  
[[Calendar Event]]
+
[[Trigger: Battery Temperature|Battery Temperature]]
  
[[Call Active]]
+
[[Trigger: Bluetooth Beacon (experimental)|Bluetooth Beacon (experimental)]]
  
[[Call Ended]]
+
[[Trigger: Bluetooth Event|Bluetooth Event]]
  
[[Call Incoming]]
+
[[Trigger: Calendar Event|Calendar Event]]
  
[[Call Missed]]
+
[[Trigger: Call Active|Call Active]]
  
[[Call Outgoing]]
+
[[Trigger: Call Ended|Call Ended]]
  
[[Cell Tower Change]]
+
[[Trigger: Call Incoming|Call Incoming]]
  
[[Clipboard Change]]
+
[[Trigger: Call Missed|Call Missed]]
  
[[Data Connectivity Change]]
+
[[Trigger: Call Outgoing|Call Outgoing]]
  
[[Day of Week/Month]]
+
[[Trigger: Cell Tower Change|Cell Tower Change]]
  
[[Day/Time Trigger]]
+
[[Trigger: Clipboard Change|Clipboard Change]]
  
[[Daydream On/Off]]
+
[[Trigger: Dark Theme Change|Dark Theme Change]]
  
[[Device Boot]]
+
[[Trigger: Data Connectivity Change|Data Connectivity Change]]
  
[[Device Docked/Undocked]]
+
[[Trigger: Day of Week/Month|Day of Week/Month]]
  
[[Dial Phone Number]]
+
[[Trigger: Day/Time Trigger|Day/Time Trigger]]
  
[[Empty Trigger]]
+
[[Trigger: Daydream On/Off|Daydream On/Off]]
  
[[Failed Login Attempt]]
+
[[Trigger: Device Boot|Device Boot]]
  
[[Fingerprint Gesture]]
+
[[Trigger: Device Docked/Undocked|Device Docked/Undocked]]
  
[[Flip Device]]
+
[[Trigger: Dial Phone Number|Dial Phone Number]]
  
[[Floating Buttn]]
+
[[Trigger: Empty Trigger|Empty Trigger]]
  
[[Geofence Trigger]]
+
[[Trigger: Failed Login Attempt|Failed Login Attempt]]
  
[[GPS Enabled/Disabled]]
+
[[Trigger: File Shared to MacroDroid|File Shared to MacroDroid]]
  
[[Headphones Insert/Removed]]
+
[[Trigger: Fingerprint Gesture|Fingerprint Gesture]]
  
[[Home Button Long Press]]
+
[[Trigger: Flip Device|Flip Device]]
  
[[Hotspot Enabled/Disabled]]
+
[[Trigger: Floating Button|Floating Button]]
  
[[Intent Received]]
+
[[Trigger: Fold State|Fold State]]
  
[[IP address Change]]
+
[[Trigger: Geofence Trigger|Geofence Trigger]]
  
[[Light Sensor]]
+
[[Trigger: GPS Enabled/Disabled|GPS Enabled/Disabled]]
  
[[Location Trigger]]
+
[[Trigger: Headphones Insert/Removed|Headphones Insert/Removed]]
  
[[Logcat Message]]
+
[[Trigger: Home Button Long Press|Home Button Long Press]]
  
[[MacroDroid Drawer Open/Close]]
+
[[Trigger: Hotspot Enabled/Disabled|Hotspot Enabled/Disabled]]
 +
 
 +
[[Trigger: HTTP Server Request|HTTP Server Request]]
 +
 
 +
[[Trigger: Intent Received|Intent Received]]
 +
 
 +
[[Trigger: IP address Change|IP address Change]]
 +
 
 +
[[Trigger: Light Sensor|Light Sensor]]
 +
 
 +
[[Trigger: Location Trigger|Location Trigger]]
 +
 
 +
[[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 Icon Long Press Shortcut|MacroDroid Icon Long Press Shortcut]]
  
 
[[Trigger: MacroDroid Initialised|MacroDroid Initialised]]
 
[[Trigger: MacroDroid Initialised|MacroDroid Initialised]]
  
[[MacroDroid Mode Change]]
+
[[Trigger: MacroDroid Mode Change|MacroDroid Mode Change]]
 +
 
 +
[[Trigger: MacroDroid Variable Change|MacroDroid Variable Change]]
 +
 
 +
[[Trigger: Media Button Pressed|Media Button Pressed]]
 +
 
 +
[[Trigger: Media Button V2 Beta|Media Button V2 Beta]]
 +
 
 +
[[Trigger: Media Track Changed|Media Track Changed]]
 +
 
 +
[[Trigger: Mobile Service Status|Mobile Service Status]]
  
[[MacroDroid Variable Change]]
+
[[Trigger: Music/Sound playing|Music/Sound playing]]
  
[[Media Button Pressed]]
+
[[Trigger: NFC Enabled State|NFC Enabled State]]
  
[[Media Button V2 Beta]]
+
[[Trigger: NFC Tag|NFC Tag]]
  
[[Mobile Service Status]]
+
[[Trigger: Notification|Notification]]
  
[[Music/Sound playing]]
+
[[Trigger: Notification Bar Button|Notification Bar Button]]
  
[[NFC Tag]]
+
[[Trigger: Photo Taken|Photo Taken]]
  
[[Notification]]
+
[[Trigger: Popup Message|Popup Message]]
  
[[Notification Bar Button]]
+
[[Trigger: Power Button Long Press|Power Button Long Press]]
  
 
[[Trigger: Power Button Toggle|Power Button Toggle]]
 
[[Trigger: Power Button Toggle|Power Button Toggle]]
  
[[Power Connected/Disconnected]]
+
[[Trigger: Power Connected/Disconnected|Power Connected/Disconnected]]
  
[[Priority Mode/Do Not Disturb]]
+
[[Trigger: Priority Mode/Do Not Disturb|Priority Mode/Do Not Disturb]]
  
[[Proximity Sensor]]
+
[[Trigger: Proximity Sensor|Proximity Sensor]]
  
[[Quick Settings tile]]
+
[[Trigger: Quick Settings tile|Quick Settings tile]]
  
[[Recent Apps Opened]]
+
[[Trigger: Recent Apps Opened|Recent Apps Opened]]
  
 
[[Trigger: Regular Interval|Regular Interval]]
 
[[Trigger: Regular Interval|Regular Interval]]
  
 
[[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]]

Latest revision as of 10:00, 9 January 2026

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

Accessibility Service State

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

File Shared to MacroDroid

Fingerprint Gesture

Flip Device

Floating Button

Fold State

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 Icon Long Press Shortcut

MacroDroid Initialised

MacroDroid Mode Change

MacroDroid Variable Change

Media Button Pressed

Media Button V2 Beta

Media Track Changed

Mobile Service Status

Music/Sound playing

NFC Enabled State

NFC Tag

Notification

Notification Bar Button

Photo Taken

Popup Message

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

Screenshot Content

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

Torch On/Off

UI Click

USB Device Connect/Disconnect

USB Tethering

Volume Button Long Press

Volume Button Press

VPN State

Weather

Webhook (URL)

Widget Button

Wifi SSID Transition

Wifi State Change