Difference between revisions of "Triggers"

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