Difference between revisions of "Triggers"
| (49 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. | ||
| − | + | 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> | ||
| − | + | 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]] |
| − | [[Battery | + | [[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]] |
| − | [[Call | + | [[Trigger: Call Active|Call Active]] |
| − | [[Call | + | [[Trigger: Call Ended|Call Ended]] |
| − | [[Call | + | [[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]] |
| − | [[MacroDroid Drawer Open/Close]] | + | [[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 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]] |
| − | [[Media Button | + | [[Trigger: Media Button V2 Beta|Media Button V2 Beta]] |
| − | [[ | + | [[Trigger: Mobile Service Status|Mobile Service Status]] |
| − | [[ | + | [[Trigger: Music/Sound playing|Music/Sound playing]] |
| − | [[ | + | [[Trigger: NFC Tag|NFC Tag]] |
| − | [[ | + | [[Trigger: Notification|Notification]] |
| − | [[Notification]] | + | [[Trigger: Notification Bar Button|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 137: | Line 155: | ||
[[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 174: | ||
[[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: UI Click|UI Click]] | ||
[[Trigger: USB Device Connect/Disconnect|USB Device Connect/Disconnect]] | [[Trigger: USB Device Connect/Disconnect|USB Device Connect/Disconnect]] | ||
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.