(Complete summary)
Line 1: Line 1:
 +
== About ==
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
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.
  
== About ==
+
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.
 +
</pre>
  
 
==<p><b>Requires a trigger to operate</b></p>==
 
==<p><b>Requires a trigger to operate</b></p>==
Line 173: Line 184:
 
{weather_conditions} - Weather conditions.
 
{weather_conditions} - Weather conditions.
 
</pre><br>
 
</pre><br>
 
__TOC__
 
  
 
==<p><b>Does not require a trigger to operate</b></p>==
 
==<p><b>Does not require a trigger to operate</b></p>==
 
Does not depend on a trigger
 
Does not depend on a trigger
=== MacroDroid Mode ===
+
=== am/pm ===
Texto de la subsección 2.1
+
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Battery temp ºC===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Cell connection type ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Cell id ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Clipboard text ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Current battery % ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Current brightness ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Current brightness (Android 9+ alternative) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Current IP address ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Current IP address (V6) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Current volume (Alarm) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Current volume (Bluetooth voice) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Current volume (Media / Music) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Current volume (Notification) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Current volume (Ringer) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Current volume (System sounds) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Current volume (Voice call) ===
 +
</pre><br>
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Day of the month ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Day of the week ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Device serial ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Dictionary/Array size ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Foreground app name ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Foreground app package ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Hour of day ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Hour of day (12h) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Hour of day (Leanding zero) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== IMEI ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Last known location (accuracy meters) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Last known location (altitude) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Last known location (lat) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Last known location (lat,lon) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Last known location (link) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Last known location (lon) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Last known location (time) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Last location speed (kmh) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Last location speed (mph) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Location area code ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Macro category ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Macro id ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Macro name ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Macrodroid is pro ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Macrodroid version ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Minute ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Mobile country code ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Mobile network code ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Month ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Month (as digit) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== New line ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Power (on/off) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== RAM (Total) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== RAM (available) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Screen resolution ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Screen resolution (X) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Screen resolution (Y) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Screen timeout (seconds) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Second ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Sim operator name ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Stopwatches ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Storage free (external) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Storage total (external) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Storage total (internal) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== String variable length ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== String variable value ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== System setting (Global) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== System setting (Secure) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== System setting (System) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== System time ===
 +
</pre><br>
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== System time (ms) ===
 +
</pre><br>
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Week of year ===
 +
</pre><br>
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Webhook Base Url ===
 +
</pre><br>
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Wifi SSID ===
 +
</pre><br>
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Wifi signal strength ===
 +
</pre><br>
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>
 +
=== Year ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
</pre><br>

Revision as of 22:29, 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 name
[call_name]
Returns the number from which the call was received.
e.g. If you receive a call from MacroDroid user

[call_name] = MacroDroid user


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

e.g. If you receive a call from 1234567890
[call_number] = 1234567890


SMS received

  • Incoming SMS contact
[sms_name] - Name of the person sending the SMS (the sender must be in your contact list).
e.g. If you receive an SMS from Macrodroid user
[sms_name] = Macrodroid user


  • Incoming SMS message
[sms_message] - Contains the text of the sms.
e.g. If you receive an SMS with a message "Hello, have a nice day"
[sms_message] = Hello, have a nice day


  • Incoming SMS number
[sms_number] - SMS sender number.
e.g. If you receive an SMS from +1 1234567890
[sms_number] = +1 1234567890


Logcat

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


Notifications

  • Notification title
[not_title] - is a prominent text element that concisely summarizes the key subject or purpose of a notification.


  • Notification ticker text
[not_ticker] - 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 text
[notification] - is the text displayed in a notification. It is the main part of the notification and usually contains information about the content of the notification.


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


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


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


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


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


Spotify

  • Spotify track id
[spotify_track_id] - Returns the Track ID of the song.


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


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


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


  • Spotify length (s)
[spotify_length_s] - Returns the length of the song in seconds.


  • Spotify is playing
[spotify_is_playing]- Returns a boolean state (true or false).


Weather

  • Temperature (Celsius)
{weather_temperature_c} - Temperature (Celsius).


  • Temperature (Temperature (fahrenheit)
{weather_temperature_farenheit} - Temperature (fahrenheit).


  • Wind speed m\s
{weather_wind_speed} - Wind speed m\s.


  • Wind speed (mph)
{weather_wind_speed_mph} - Wind speed (mph).


  • Wind speed (kmh)
{weather_wind_speed_kmh} - Wind speed (kmh).


  • Temperature Wind direction
{weather_wind_direction} - Wind direction (degrees).


  • Humidity
{weather_humidity} - Humidity.


  • Weather conditions
{weather_conditions} - Weather conditions.


Does not require a trigger to operate

Does not depend on a trigger

am/pm


Battery temp ºC


Cell connection type


Cell id


Clipboard text


Current battery %


Current brightness


Current brightness (Android 9+ alternative)


Current IP address


Current IP address (V6)


Current volume (Alarm)


Current volume (Bluetooth voice)


Current volume (Media / Music)


Current volume (Notification)


Current volume (Ringer)


Current volume (System sounds)


Current volume (Voice call)



Day of the month


Day of the week


Device serial


Dictionary/Array size


Foreground app name


Foreground app package


Hour of day


Hour of day (12h)


Hour of day (Leanding zero)


IMEI


Last known location (accuracy meters)


Last known location (altitude)


Last known location (lat)


Last known location (lat,lon)


Last known location (link)


Last known location (lon)


Last known location (time)


Last location speed (kmh)


Last location speed (mph)


Location area code


Macro category


Macro id


Macro name


Macrodroid is pro


Macrodroid version


Minute


Mobile country code


Mobile network code


Month


Month (as digit)


New line


Power (on/off)


RAM (Total)


RAM (available)


Screen resolution


Screen resolution (X)


Screen resolution (Y)


Screen timeout (seconds)


Second


Sim operator name


Stopwatches


Storage free (external)


Storage total (external)


Storage total (internal)


String variable length


String variable value


System setting (Global)


System setting (Secure)


System setting (System)


System time



System time (ms)



Week of year



Webhook Base Url



Wifi SSID



Wifi signal strength



Year