Magic text2

Revision as of 23:28, 2 January 2024 by JosueGd (talk | contribs) (Magic text is being updated without trigger dependency.)

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

am or pm depending on the time.


Battery temp ºC

Temperature in degrees Celsius e.g. 34°


Cell connection type

cell connection type e.g. 3g, 4g, 5g.


Cell id

number that identifies an individual cell within a cellular network. Used for mobile phones to connect to the network and for the network to send data to mobile phones
e.g. The cell identifier for a cell in New York City could be 310-200-0000. The LAC (310-200)


Clipboard text

Gets the text from the clipboard.


Current battery %

Current battery level (numbers only) e.g. '80'


Current brightness

Current brightness level (numbers only) e.g. '50'


Current brightness (Android 9+ alternative)

Current brightness level (numbers only) e.g. '50'
alternative method for devices with android 9+


Current IP address

Current IP in 172.217.12.141 format (randomly generated IP).


Current IP address (V6)

Current IP in format in 2001:0db8:85a3:0000:0000:8a2e:0370:7334 format (randomly generated IP).


Current volume (Alarm)

Current volume level used for alarms.


Current volume (Bluetooth voice)

Current volume level used for multimedia/calls via Bluetooth.


Current volume (Media / Music)

Current volume level used for multimedia.


Current volume (Notification)

Current volume level used for notification alerts.


Current volume (Ringer)

Current volume level used for ringtone.


Current volume (System sounds)

Current volume level used for system sounds e.g. screen unlocking and locking, touch sounds among others.


Current volume (Voice call)

Current volume level used when a call is in progress.


Day of the month

Day of the month, includes 0 at the beginning (days 1 to 9) e.g. 04 or 24.


Day of the week

Day of the week, e.g. Monday or Friday.


Device serial

Not available on android 10+.


Dictionary/Array size

Size of an array or dictionary.
  e.g. to query the size of an array called "my_array" [0,1,2] it would look like this [size=my_array] the result would be 3.


Foreground app name

Name of the application in the foreground, if you are in macrodroid, the output will be MacroDroid.


Foreground app package

Package of the application in the foreground, if you are in macrodroid, the output will be MacroDroid.


Hour of day

Time of day in 24h format.


Hour of day (12h)

Time of day in 12h format.


Hour of day (Leanding zero)

Time of day in 24h format, includes leading zero.


IMEI

Obtains the IMEI number, since Android 10+ this information is no longer available.


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