Difference between revisions of "Magic text2"
(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. | ||
− | = | + | 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> | ||
− | |||
− | |||
==<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 | ||
− | === | + | === am/pm === |
− | + | <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