(57 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
<span style="color: #B22A2A; font-size: 24px; display: inline-block; margin-top: 15px; margin-bottom: 0px;"><strong>About Triggers</strong></span>
 +
 
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.
  
== List of Triggers ==
+
For a trigger to fire, the macro must be available (i.e. ready to run, not disabled) at the exact time the event occurs. Otherwise, it is generally possible to check the state of a component or event (such as Battery level, Notification content, WiFi connection...) testing appropriate Magic Text value.
 +
 
 +
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 [[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: Activity Recognition|Activity Recognition]]
 +
 
 +
[[Trigger: Airplane mode changed|Airplane mode changed]]
 +
 
 +
[[Trigger: Android Wear|Android Wear]]
 +
 
 +
[[Trigger: App Install/Remove/Update|App Install/Remove/Update]]
 +
 
 +
[[Trigger: Application Launched/Closed|Application Launched/Closed]]
 +
 
 +
[[Trigger: Auto Rotate changed|Auto Rotate changed]]
 +
 
 +
[[Trigger: Autosync changed|Autosync changed]]
 +
 
 +
[[Trigger: Battery Level|Battery Level]]
 +
 
 +
[[Trigger: Battery Saver State|Battery Saver State]]
 +
 
 +
[[Trigger: Battery Temperature|Battery Temperature]]
 +
 
 +
[[Trigger: Bluetooth Beacon (experimental)|Bluetooth Beacon (experimental)]]
 +
 
 +
[[Trigger: Bluetooth Event|Bluetooth Event]]
 +
 
 +
[[Trigger: Calendar Event|Calendar Event]]
 +
 
 +
[[Trigger: Call Active|Call Active]]
 +
 
 +
[[Trigger: Call Ended|Call Ended]]
 +
 
 +
[[Trigger: Call Incoming|Call Incoming]]
 +
 
 +
[[Trigger: Call Missed|Call Missed]]
 +
 
 +
[[Trigger: Call Outgoing|Call Outgoing]]
 +
 
 +
[[Trigger: Cell Tower Change|Cell Tower Change]]
 +
 
 +
[[Trigger: Clipboard Change|Clipboard Change]]
 +
 
 +
[[Trigger: Dark Theme Change|Dark Theme Change]]
 +
 
 +
[[Trigger: Data Connectivity Change|Data Connectivity Change]]
 +
 
 +
[[Trigger: Day of Week/Month|Day of Week/Month]]
 +
 
 +
[[Trigger: Day/Time Trigger|Day/Time Trigger]]
 +
 
 +
[[Trigger: Daydream On/Off|Daydream On/Off]]
 +
 
 +
[[Trigger: Device Boot|Device Boot]]
 +
 
 +
[[Trigger: Device Docked/Undocked|Device Docked/Undocked]]
 +
 
 +
[[Trigger: Dial Phone Number|Dial Phone Number]]
 +
 
 +
[[Trigger: Empty Trigger|Empty Trigger]]
 +
 
 +
[[Trigger: Failed Login Attempt|Failed Login Attempt]]
 +
 
 +
[[Trigger: Fingerprint Gesture|Fingerprint Gesture]]
 +
 
 +
[[Trigger: Flip Device|Flip Device]]
 +
 
 +
[[Trigger: Floating Button|Floating Button]]
 +
 
 +
[[Trigger: Geofence Trigger|Geofence Trigger]]
 +
 
 +
[[Trigger: GPS Enabled/Disabled|GPS Enabled/Disabled]]
 +
 
 +
[[Trigger: Headphones Insert/Removed|Headphones Insert/Removed]]
 +
 
 +
[[Trigger: Home Button Long Press|Home Button Long Press]]
 +
 
 +
[[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]]
  
[[Activity Recognition]]
+
[[Trigger: Light Sensor|Light Sensor]]
  
[[Airplane mode changed]]
+
[[Trigger: Location Trigger|Location Trigger]]
  
[[Android Wear]]
+
[[Trigger: Logcat Message|Logcat Message]]
  
[[App Install/Remove/Update]]
+
[[Trigger: Macro enabled|Macro enabled]]
  
[[Application Launches/Closed]]
+
[[Trigger: Macro finished|Macro finished]]
  
[[Auto Rotate changed]]
+
[[Trigger: MacroDroid Drawer Open/Close|MacroDroid Drawer Open/Close]]
  
[[Autosync changed]]
+
[[Trigger: MacroDroid Initialised|MacroDroid Initialised]]
  
[[Battery Level]]
+
[[Trigger: MacroDroid Mode Change|MacroDroid Mode Change]]
  
[[Battery Saver State]]
+
[[Trigger: MacroDroid Variable Change|MacroDroid Variable Change]]
  
[[Battery Temperature]]
+
[[Trigger: Media Button Pressed|Media Button Pressed]]
  
[[Bluetooth Beacon (experimental]]
+
[[Trigger: Media Button V2 Beta|Media Button V2 Beta]]
  
[[Bluetooth Event]]
+
[[Trigger: Mobile Service Status|Mobile Service Status]]
  
[[Calendar Event]]
+
[[Trigger: Music/Sound playing|Music/Sound playing]]
  
[[Call Active]]
+
[[Trigger: NFC Tag|NFC Tag]]
  
[[Call Ended]]
+
[[Trigger: Notification|Notification]]
  
[[Call Incoming]]
+
[[Trigger: Notification Bar Button|Notification Bar Button]]
  
[[Call Missed]]
+
[[Trigger: Power Button Long Press|Power Button Long Press]]
  
[[Call Outgoing]]
+
[[Trigger: Power Button Toggle|Power Button Toggle]]
  
[[Cell Tower Change]]
+
[[Trigger: Power Connected/Disconnected|Power Connected/Disconnected]]
  
[[Data Connectivity Change]]
+
[[Trigger: Priority Mode/Do Not Disturb|Priority Mode/Do Not Disturb]]
  
[[Day of Week/Month]]
+
[[Trigger: Proximity Sensor|Proximity Sensor]]
  
[[Day/Time Trigger]]
+
[[Trigger: Quick Settings tile|Quick Settings tile]]
  
[[Daydream On/Off]]
+
[[Trigger: Recent Apps Opened|Recent Apps Opened]]
  
[[Device Boot]]
+
[[Trigger: Regular Interval|Regular Interval]]
  
[[Device Docked/Undocked]]
+
[[Trigger: Roaming Started/Stopped|Roaming Started/Stopped]]
  
[[Dial Phone Number]]
+
[[Trigger: Screen content|Screen content]]
  
[[Empty Trigger]]
+
[[Trigger: Screen On/Off|Screen On/Off]]
  
[[Failed Login Attempt]]
+
[[Trigger: Screen Orientation|Screen Orientation]]
  
[[Fingerprint Gesture]]
+
[[Trigger: Screen Unlocked|Screen Unlocked]]
  
[[Flip Device]]
+
[[Trigger: Shake Device|Shake Device]]
  
[[Floating Buttn]]
+
[[Trigger: Shortcut Launched|Shortcut Launched]]
  
[[Geofence Trigger]]
+
[[Trigger: Silent Mode Enabled/Disabled|Silent Mode Enabled/Disabled]]
  
[[GPS Enabled/Disabled]]
+
[[Trigger: Sim Card Change|Sim Card Change]]
  
[[Headphones Insert/Removed]]
+
[[Trigger: Sleep|Sleep]]
  
[[Home Button Long Press]]
+
[[Trigger: SMS Received|SMS Received]]
  
[[Hotspot Enabled/Disabled]]
+
[[Trigger: SMS Sent|SMS Sent]]
  
[[Intent Received]]
+
[[Trigger: Spotify|Spotify]]
  
[[IP address Change]]
+
[[Trigger: Stopwatch|Stopwatch]]
  
[[Light Sensor]]
+
[[Trigger: Sunset/Sunrise|Sunset/Sunrise]]
  
[[Location Trigger]]
+
[[Trigger: Swipe Screen|Swipe Screen]]
  
[[Logcat Message]]
+
[[Trigger: System log|System Log Entry]]
  
[[MacroDroid Drawer Open/Close]]
+
[[Trigger: System Setting Change|System Setting Change]]
  
[[MacroDroid Initialised]]
+
[[Trigger: Tasker/Locale Plugin|Tasker/Locale Plugin]]
  
[[MacroDroid Mode Change]]
+
[[Trigger: Text Shared to MacroDroid|Text Shared to MacroDroid]]
  
[[MacroDroid Variable Change]]
+
[[Trigger: UI Click|UI Click]]
  
[[Media Button Pressed]]
+
[[Trigger: USB Device Connect/Disconnect|USB Device Connect/Disconnect]]
  
[[Media Button V2 Beta]]
+
[[Trigger: Volume Button Long Press|Volume Button Long Press]]
  
[[Mobile Service Status]]
+
[[Trigger: Volume Button Press|Volume Button Press]]
  
[[Music/Sound playing]]
+
[[Trigger: VPN State|VPN State]]
  
[[NFC Tag]]
+
[[Trigger: Weather|Weather]]
  
[[Notification]]
+
[[Trigger: Webhook (URL)|Webhook (URL)]]
  
[[Notification Bar Button]]
+
[[Trigger: Widget Button|Widget Button]]
  
[[Power Button Toggle]]
+
[[Trigger: Wifi SSID Transition|Wifi SSID Transition]]
  
[[
+
[[Trigger: Wifi State Change|Wifi State Change]]

Latest revision as of 17:29, 23 April 2024

About Triggers

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 available (i.e. ready to run, not disabled) at the exact time the event occurs. Otherwise, it is generally possible to check the state of a component or event (such as Battery level, Notification content, WiFi connection...) testing appropriate Magic Text value.

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