Tags: Mobile web edit Mobile edit
Tags: Mobile web edit Mobile edit
 
(26 intermediate revisions by 5 users not shown)
Line 1: Line 1:
An action is something your device can do when a macro runs. A macro must have at least one action to be valid.
+
<pre style="background-color: #FFFF99; color: #112A46; border-radius: 10px; padding: 10px;">
 +
An action is something your device can do when a macro runs.
 +
A macro must have at least one action to be valid.
 +
</pre>
 +
 
 +
=== Synchronous vs asynchronous ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
MacroDroid actions typically execute quickly, but certain actions like HTTP requests or shell scripts may take longer. To ensure that subsequent actions wait for these longer actions to complete before continuing, enable the 'Block next action until complete' option in the action's configuration GUI. Otherwise, the action will run asynchronously while other actions continue.
 +
 
 +
In traditional programming languages, you could pass a callback function to execute after the asynchronous action is complete. This allows you to perform additional actions or work with the data returned by the asynchronous action. However, MacroDroid's inner workings are arbitrary, so there is no systematic option for this. Instead, you must rely on different workarounds.
 +
</pre>
 +
 
 +
== Control flow ==
 +
 
 +
[[Control flow: If clause|If clause]]
 +
 
 +
[[Control flow: If confirmed then|If confirmed then]]
 +
 
 +
[[Control flow: Repeat actions|Repeat actions]]
 +
 
 +
[[Control flow:  Iterate Dictionary/Array| Iterate Dictionary/Array]]
 +
 
 +
[[Control flow: Break from loop|Break from loop]]
 +
 
 +
[[Control flow: Continue loop|Continue loop]]
  
 
== List of Actions ==
 
== List of Actions ==
 +
 +
[[Action: Accessibility Service|Accessibility Service]]
  
 
[[Action: Action Block|Action Block]]
 
[[Action: Action Block|Action Block]]
Line 10: Line 36:
  
 
[[Action: Ambient Display|Ambient Display]]
 
[[Action: Ambient Display|Ambient Display]]
 +
 +
[[Action: Animation Overlay|Animation Overlay]]
  
 
[[Action: Android Shortcut|Android Shortcut]]
 
[[Action: Android Shortcut|Android Shortcut]]
Line 16: Line 44:
  
 
[[Action: Answer Call|Answer Call]]
 
[[Action: Answer Call|Answer Call]]
 +
 +
[[Action: App Enable/Disable|App Enable/Disable]]
 +
 +
[[Action: Authenticate User|Authenticate User]]
 +
 +
[[Action: Array Manipulation|Array Manipulation]]
  
 
[[Action: Autosync On/Off|Autosync On/Off]]
 
[[Action: Autosync On/Off|Autosync On/Off]]
  
 
[[Action: Battery Saver|Battery Saver]]
 
[[Action: Battery Saver|Battery Saver]]
 +
 +
[[Action: Block Screen Touch|Screen Block Touch]]
  
 
[[Action: Bluetooth Configure|Bluetooth Configure]]
 
[[Action: Bluetooth Configure|Bluetooth Configure]]
 
[[Action: Bluetooth Tethering|Bluetooth Tethering]]
 
  
 
[[Action: Brightness|Brightness]]
 
[[Action: Brightness|Brightness]]
Line 36: Line 70:
  
 
[[Action: Car Mode|Car Mode]]
 
[[Action: Car Mode|Car Mode]]
 +
 +
[[Action: Check Pixel Colour|Check pixel colour]]
 +
 +
[[Action: Check Text In Screenshot|Check Text In Screenshot]]
 +
 +
[[Action: Check Text On Screen|Check Text On Screen]]
  
 
[[Action: Clear App Data|Clear App Data]]
 
[[Action: Clear App Data|Clear App Data]]
  
 
[[Action: Clear Call Log|Clear Call Log]]
 
[[Action: Clear Call Log|Clear Call Log]]
 +
 +
[[Action: Clear Dictionary/Array Entry|Clear Dictionary/Array Entry]]
 +
 +
[[Action: Clear MacroDroid Dialog|Clear MacroDroid Dialog]]
  
 
[[Action: Clear Log|Clear Log]]
 
[[Action: Clear Log|Clear Log]]
Line 50: Line 94:
  
 
[[Action: Configure App Notifications|Configure App Notifications]]
 
[[Action: Configure App Notifications|Configure App Notifications]]
 +
 +
[[Action: Configure Quick Tile|Configure Quick Tile]]
  
 
[[Action: Confirm Next|Confirm Next]]
 
[[Action: Confirm Next|Confirm Next]]
Line 64: Line 110:
  
 
[[Action: Delete Macro|Delete Macro]]
 
[[Action: Delete Macro|Delete Macro]]
 +
 +
[[Action: Delete Variable|Delete Variable]]
  
 
[[Action: Demo Mode|Demo Mode]]
 
[[Action: Demo Mode|Demo Mode]]
Line 70: Line 118:
  
 
[[Action: Disable MacroDroid|Disable MacroDroid]]
 
[[Action: Disable MacroDroid|Disable MacroDroid]]
 +
 +
[[Action: Display Bubble Notification|Display Bubble Notification]]
  
 
[[Action: Display Dialog|Display Dialog]]
 
[[Action: Display Dialog|Display Dialog]]
Line 80: Line 130:
  
 
[[Action: Enable/Disable Macro|Enable/Disable Macro]]
 
[[Action: Enable/Disable Macro|Enable/Disable Macro]]
 +
 +
[[Action: Enable/Disable Trigger|Enable/Disable Trigger]]
  
 
[[Action: Exit Action Block|Exit Action Block]]
 
[[Action: Exit Action Block|Exit Action Block]]
  
 
[[Action: Expand/Collapse Status Bar|Expand/Collapse Status Bar]]
 
[[Action: Expand/Collapse Status Bar|Expand/Collapse Status Bar]]
 +
 +
[[Action: Export Log|Export Log]]
  
 
[[Action: Export Macros|Export Macros]]
 
[[Action: Export Macros|Export Macros]]
  
[[Action: File Operations V2|File Operations V2]]
+
[[Action: File Operation| File Operation]]
  
 
[[Action: Fill Clipboard|Fill Clipboard]]
 
[[Action: Fill Clipboard|Fill Clipboard]]
 +
 +
[[Action: Floating Button Configure|Floating Button Configure]]
  
 
[[Action: Floating text|Floating text]]
 
[[Action: Floating text|Floating text]]
Line 98: Line 154:
  
 
[[Action: Force Screen Rotation|Force Screen Rotation]]
 
[[Action: Force Screen Rotation|Force Screen Rotation]]
 +
 +
[[Action: Get Light Level|Get Light Level]]
 +
 +
[[Action: Get Text From View Id|Get Text From View Id]]
  
 
[[Action: GPS Enable/Disable|GPS Enable/Disable]]
 
[[Action: GPS Enable/Disable|GPS Enable/Disable]]
Line 107: Line 167:
 
[[Action: HTTP Request|HTTP Request]]
 
[[Action: HTTP Request|HTTP Request]]
  
[[Action: If clause|If clause]]
+
[[Action: HTTP Server|HTTP Server]]
  
 
[[Action: Immersive Mode|Immersive Mode]]
 
[[Action: Immersive Mode|Immersive Mode]]
 +
 +
[[Action: JavaScript Code|JavaScript Code]]
  
 
[[Action: Invert Colours|Invert Colours]]
 
[[Action: Invert Colours|Invert Colours]]
Line 154: Line 216:
  
 
[[Action: Notification LED Enable/Disable|Notification LED Enable/Disable]]
 
[[Action: Notification LED Enable/Disable|Notification LED Enable/Disable]]
 +
 +
[[Action: Notification Reply|Notification Reply]]
  
 
[[Action: Open Call Log|Open Call Log]]
 
[[Action: Open Call Log|Open Call Log]]
Line 174: Line 238:
  
 
[[Action: Priority Mode / Do Not Disturb|Priority Mode / Do Not Disturb]]
 
[[Action: Priority Mode / Do Not Disturb|Priority Mode / Do Not Disturb]]
 +
 +
[[Action: Read Screen Contents|Read Screen Contents]]
 +
 +
[[Action: Read Screenshot Contents|Read Screenshot Contents]]
  
 
[[Action: Reboot/Power Off|Reboot/Power Off]]
 
[[Action: Reboot/Power Off|Reboot/Power Off]]
Line 188: Line 256:
  
 
[[Action: Secure Settings|Secure Settings]]
 
[[Action: Secure Settings|Secure Settings]]
 +
 +
[[Action: Selecttion Dialog|Selection Dialog]]
  
 
[[Action: Send Email|Send Email]]
 
[[Action: Send Email|Send Email]]
Line 198: Line 268:
  
 
[[Action: Set Location Update Rate|Set Location Update Rate]]
 
[[Action: Set Location Update Rate|Set Location Update Rate]]
 +
 +
[[Action: Set Digital Assistant|Set Digital Assistant]]
  
 
[[Action: Set MacroDroid Icon|Set MacroDroid Icon]]
 
[[Action: Set MacroDroid Icon|Set MacroDroid Icon]]
Line 206: Line 278:
  
 
[[Action: Set Notification Sound|Set Notification Sound]]
 
[[Action: Set Notification Sound|Set Notification Sound]]
 
[[Action: Set Quick Settings Tile State|Set Quick Settings Tile State]]
 
  
 
[[Action: Set Screen Lock|Set Screen Lock]]
 
[[Action: Set Screen Lock|Set Screen Lock]]
Line 218: Line 288:
  
 
[[Action: Share Last Photo|Share Last Photo]]
 
[[Action: Share Last Photo|Share Last Photo]]
 +
 +
[[Action: Share Text|Share Text]]
  
 
[[Action: Share Location|Share Location]]
 
[[Action: Share Location|Share Location]]
Line 224: Line 296:
  
 
[[Action: Silent - Vibrate Off|Silent - Vibrate Off]]
 
[[Action: Silent - Vibrate Off|Silent - Vibrate Off]]
 +
 +
[[Action: Silent - Show Volume Popup|Show Volume Popup]]
  
 
[[Action: Speak Text|Speak Text]]
 
[[Action: Speak Text|Speak Text]]
Line 238: Line 312:
  
 
[[Action: Take Screenshot|Take Screenshot]]
 
[[Action: Take Screenshot|Take Screenshot]]
 +
 +
[[Action: Text_from_Image_(OCR)|Text from Image (OCR)]]
  
 
[[Action: Text Manipulation|Text Manipulation]]
 
[[Action: Text Manipulation|Text Manipulation]]
  
 
[[Action: Torch On/Off|Torch On/Off]]
 
[[Action: Torch On/Off|Torch On/Off]]
 +
 +
[[Action: Translate Text|Translate Text]]
  
 
[[Action: Touch Screen|Touch Screen]]
 
[[Action: Touch Screen|Touch Screen]]
 
[[Action: Tweet|Tweet]]
 
  
 
[[Action: UDP Command|UDP Command]]
 
[[Action: UDP Command|UDP Command]]

Latest revision as of 12:26, 15 August 2024

An action is something your device can do when a macro runs.
A macro must have at least one action to be valid.

Synchronous vs asynchronous

MacroDroid actions typically execute quickly, but certain actions like HTTP requests or shell scripts may take longer. To ensure that subsequent actions wait for these longer actions to complete before continuing, enable the 'Block next action until complete' option in the action's configuration GUI. Otherwise, the action will run asynchronously while other actions continue.

In traditional programming languages, you could pass a callback function to execute after the asynchronous action is complete. This allows you to perform additional actions or work with the data returned by the asynchronous action. However, MacroDroid's inner workings are arbitrary, so there is no systematic option for this. Instead, you must rely on different workarounds.

Control flow

If clause

If confirmed then

Repeat actions

Iterate Dictionary/Array

Break from loop

Continue loop

List of Actions

Accessibility Service

Action Block

Airplane Mode On/Off

Alarm Clock

Ambient Display

Animation Overlay

Android Shortcut

Android Wear

Answer Call

App Enable/Disable

Authenticate User

Array Manipulation

Autosync On/Off

Battery Saver

Screen Block Touch

Bluetooth Configure

Brightness

Calendar - Add Event

Call Reject

Camera Enable/Disable

Cancel Macro Actions

Car Mode

Check pixel colour

Check Text In Screenshot

Check Text On Screen

Clear App Data

Clear Call Log

Clear Dictionary/Array Entry

Clear MacroDroid Dialog

Clear Log

Clear Notifications

Clear Variables

Clipboard Refresh

Configure App Notifications

Configure Quick Tile

Confirm Next

Connectivity Check

Contact Via App

Control Media

Dark Theme

Daydream/Screensaver On

Delete Macro

Delete Variable

Demo Mode

Dim Screen

Disable MacroDroid

Display Bubble Notification

Display Dialog

Display Notification

Empty Action

Enable/Disable Category

Enable/Disable Macro

Enable/Disable Trigger

Exit Action Block

Expand/Collapse Status Bar

Export Log

Export Macros

File Operation

Fill Clipboard

Floating Button Configure

Floating text

Font Scale

Force Location Update

Force Screen Rotation

Get Light Level

Get Text From View Id

GPS Enable/Disable

Heads-up Enable/Disable

HotSpot On/Off

HTTP Request

HTTP Server

Immersive Mode

JavaScript Code

Invert Colours

JSON Parse

Keep Device Awake

Keyboard - Set Default

Keyboard Prompt

Kill Application

Kill Background Processes

Launch and Press

Launch Application

Launch Home Screen

Launch Shortcut

Locale/Tasker Plugin

Location Mode

Log Event

MacroDroid Drawer

MacroDroid Settings

Macro run

Make Call

Mobile Data On/Off

NFC Enable/Disable

Notification Interaction

Notification LED Enable/Disable

Notification Reply

Open Call Log

Open File

Open Last Photo

Open MacroDroid Log

Open Website / HTTP GET

Option Dialog

Play/Stop Sound

Popup Message

Press Back Button

Priority Mode / Do Not Disturb

Read Screen Contents

Read Screenshot Contents

Reboot/Power Off

Record Microphone

Restore Hidden Notifications

Ringtone Configure

Say Current Time

Screen On/Off

Secure Settings

Selection Dialog

Send Email

Send Intent

Send SMS

Set Button Bar Image

Set Location Update Rate

Set Digital Assistant

Set MacroDroid Icon

Set MacroDroid Mode

Set MacroDroid Notification Text

Set Notification Sound

Set Screen Lock

Set Screen Timeout

Set Variable

Set Wallpaper

Share Last Photo

Share Text

Share Location

Shell Script

Silent - Vibrate Off

Show Volume Popup

Speak Text

Speakerphone On/Off

Stopwatch

Sync Account

System Setting

Take Picture

Take Screenshot

Text from Image (OCR)

Text Manipulation

Torch On/Off

Translate Text

Touch Screen

UDP Command

UI Interaction

USB Tethering

Vibrate

Vibrate Enable/Disable

Voice Input

Voice Search

Volume Change

Volume Up/Down

Wait Before Next Action

Wait Until Trigger

WhatsApp Send

Widget Button Modify

Wifi Configure

Write to File