Line 20: Line 20:
  
 
=== App Install/Remove/Update ===
 
=== App Install/Remove/Update ===
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">Application name: [app_name]
+
* '''''Application name'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> [app_name]
 
Returns the name of the application that was launched, for example "MacroDroid".
 
Returns the name of the application that was launched, for example "MacroDroid".
 +
</pre><br>
  
Application package: [app_package]
+
* '''''Application package'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
[app_package]
 
Returns the package name of the application that was launched, for example, if it were MacroDroid the response would be "com.arlosoft.macrodroid".
 
Returns the package name of the application that was launched, for example, if it were MacroDroid the response would be "com.arlosoft.macrodroid".
 
</pre><br>
 
</pre><br>
Line 33: Line 37:
 
Returns the name of the application that was launched, for example "MacroDroid".
 
Returns the name of the application that was launched, for example "MacroDroid".
 
</pre><br>
 
</pre><br>
*Application package
+
* '''''Application package'''''
 
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 
[app_package]
 
[app_package]
Line 40: Line 44:
  
 
=== Bluethooth (Device connected or device disconnected) ===
 
=== Bluethooth (Device connected or device disconnected) ===
*Bluetooth device name
+
* '''''Bluetooth device name'''''
 
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 
[bluetooth_device_name]
 
[bluetooth_device_name]
Line 67: Line 71:
  
 
=== SMS received ===
 
=== SMS received ===
 +
* '''''Incoming SMS contact'''''
 +
'''''This magic text appears when using any variation of "SMS received"'''''.
 
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
This magic text appears when using any variation of "SMS received".
 
  
[sms_name] - Sender name.
+
[sms_name] Name of the person sending the SMS (the sender must be in your contact list).
 
+
</pre><br>
[sms_message] - SMS content.
+
* '''''Incoming SMS message'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
[sms_message] - Contains the text of the sms.
 +
</pre><br>
  
 
[sms_number] - SMS sender number.
 
[sms_number] - SMS sender number.

Revision as of 20:52, 2 January 2024

About

In many triggers, actions and constraints you will have the option to configure some textual fields. Often you will find a button next to the text entry field that contains the "..." label. This button will display a complete list of "magic text" fields that are available in the context that is being used.

If you wish to manually type them instead if you know them, be aware that there can be spelling/typing mistakes.

Magic text for dictionaries/arrays is written like this :
[lv=dictionary/array name[entry][sub-entry]]
There can be as many [sub-entry] as you want. Be aware that it can get complicated pretty fast! Curly {} brackets were added so users would see the beginning and end of a dictionary/array magic text 
with ease.

The magic text allows some other value to be substituted at the point of invocation, rather than standard static text that will never changed. For example it's possible to add and action that reference a variable via magic text and that variable's value will be substituted at the point that action is run.

Magic text can be written in 2 ways : Curly brackets {value} and square brackets [value]. Curly brackets aren't supported on very old versions like v5.20 and below but it's recommended to use it when interacting with dictionaries/arrays as with square brackets it can get confusing where you are very quickly.

Requires a trigger to operate

App Install/Remove/Update

  • Application name
 [app_name]
Returns the name of the application that was launched, for example "MacroDroid".


  • Application package
[app_package]
Returns the package name of the application that was launched, for example, if it were MacroDroid the response would be "com.arlosoft.macrodroid".


Application Launched/Closed

  • Application name
[app_name]
Returns the name of the application that was launched, for example "MacroDroid".


  • Application package
[app_package]
Returns the package name of the application that was launched, for example, if it were MacroDroid the response would be "com.arlosoft.macrodroid".


Bluethooth (Device connected or device disconnected)

  • Bluetooth device name
[bluetooth_device_name]
Returns the name of the bluetooth device, may be more useful when using the "Any device" option.

For example, if headphones are connected, it will return the device name.
[bluetooth_device_name] = Headphones 1 Pro


Call (Active, Ended, Incoming, Missed, Outgoing)

  • Call number
[call_number]
Returns the number from which the call was received.
e.g. If you receive a call from MacroDroid user

[call_name] = MacroDroid user


  • Call name
[call_name]
Returns the name from where the call was received if available.

For example, if you receive a call from 1234567890
[call_number] = 1234567890


SMS received

  • Incoming SMS contact

This magic text appears when using any variation of "SMS received".


[sms_name] Name of the person sending the SMS (the sender must be in your contact list).


  • Incoming SMS message
[sms_message] - Contains the text of the sms.


[sms_number] - SMS sender number.

For example, if you receive an SMS from "Macrodroid user" the message "Hello, have a nice day" comes from the phone number +1 12345678

the magic text would return this:

[sms_name] = Macrodroid user

[sms_message] = Hello, have a nice day

[sms_number] =+1 12345678


Logcat

[logcat_line] - Returns the reference logcat line configured in the trigger.


Notifications

[not_title] - Notification title.

[not_ticker] - Notification ticker text, is a brief text that scrolls temporarily across the status bar of an Android device when a new notification arrives. This feature was removed in Android 5.0 Lollipop, but it can still be found on some devices or restored using third-party apps.

[notification] - Notification text.

[not_sub_text] - Notification sub text,  is a secondary text element that provides additional context or detail to a notification.

[not_text_lines] - Notification big text, is a feature that allows to display a more significant amount of text within a notification.

[not_action_names] - Notification actions names, are clickable buttons or links embedded within notifications that allow users to perform specific tasks directly without opening the associated app.

[not_app_name] - Notification app name,  is the name of the app that generated the notification.

[not_app_package] - Notification app package, It is the package name of the application that created the notification.


Spotify

[spotify_track_id] - Returns the Track ID of the song.

[spotify_artist] - Returns the artist of the song, "Started music" is not supported

[spotify_album] - Returns the album of the song, "Started music" is not supported

[spotify_track] - Returns the name of the song, "Started music" is not supported

[spotify_length_s] - Returns the length of the song in seconds.

[spotify_is_playing]- Returns a boolean state (true or false).


Weather

{weather_temperature_c} - Temperature (Celsius).

{weather_temperature_farenheit} - Temperature (fahrenheit).

{weather_wind_speed} - Wind speed m\s.

{weather_wind_speed_mph} - Wind speed (mph).

{weather_wind_speed_kmh} - Wind speed (kmh).

{weather_wind_direction} - Wind direction (degrees).

{weather_humidity} - Humidity.

{weather_conditions} - Weather conditions.



Does not require a trigger to operate

Does not depend on a trigger

MacroDroid Mode

Texto de la subsección 2.1