Magic Text Overview
Many triggers, actions, and constraints allow you to configure some text fields. Often, you will find a button next to the text input field that contains the "..." label. This button displays a complete list of "magic text" fields available in the context you are using.
If you want to type them manually instead, if you know them, be aware that there may be spelling/typing errors.
How Magic Text Works
The magic text allows a different value to be substituted at the point of call, instead of the standard static text that never changes. For example, it's possible to add an action that references a variable via magic text, and that variable's value will be substituted at the point the action is executed.
Magic Text Formats
Magic text can be written in two ways:
- Curly braces: {value}
- Square braces: [value]
Curly brackets are not supported on very old versions like v5.20 and below, but it's recommended to use them when interacting with dictionaries/arrays, as square brackets can get confusing very quickly.
Magic Text Overview
Many triggers, actions, and constraints allow you to configure some text fields. Often, you will find a button next to the text input field that contains the "..." label. This button displays a complete list of "magic text" fields available in the context you are using.
If you want to type them manually instead, if you know them, be aware that there may be spelling/typing errors.
How Magic Text Works
The magic text allows a different value to be substituted at the point of call, instead of the standard static text that never changes. For example, it's possible to add an action that references a variable via magic text, and that variable's value will be substituted at the point the action is executed.
Magic Text Formats
Magic text can be written in two ways:
- Curly braces: {value}
- Square braces: [value]
Curly brackets are not supported on very old versions like v5.20 and below, but it's recommended to use them when interacting with dictionaries/arrays, as square brackets can get confusing very quickly.
Magic Text Syntax
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 like. Be aware that this can get complicated very quickly! Curly `{}` braces have been added so that users can easily see the beginning and end of a dictionary/array magic text.
| Name
|
am/pm
|
| Magic text |
{am_pm}
|
| Description |
am or pm depending on the time.
|
| Does it require a trigger? |
No
|
| Name
|
Android version
|
| Magic text |
{android_version}
|
| Description |
Returns the number of the android version.
|
| Does it require a trigger? |
No
|
| Name
|
Android version (SDK level)
|
| Magic text |
{android_version_sdk}
|
| Description |
Returns the SDK level of the Android version. e.g. Android 15 has an SDK level of 35.
|
| Does it require a trigger? |
No
|
| Name
|
Application name
|
| Magic text |
{app_name}
|
| Description |
Gets the name of the application that was opened or closed according to the context.
|
| Does it require a trigger? |
Yes, it requires an Application Launched/Closed trigger to be present.
|
| Name
|
Application package
|
| Magic text |
{app_package}
|
| Description |
Gets the name of the application that was opened or closed according to the context.
|
| Does it require a trigger? |
Yes, it requires an Application Launched/Closed trigger to be present.
|
| Name
|
Battery current now (mA)
|
| Magic text |
{battery_current_now}
|
| Description |
Amount of electrical current flowing from the battery at this moment, measured in milliamps (mA).
|
| Does it require a trigger? |
No
|
| Name
|
Battery temp ºC
|
| Magic text |
{battery_temp}
|
| Description |
Temperature in degrees Celsius, e.g. 34°.
|
| Does it require a trigger? |
No
|
| Name
|
Bluetooth device name
|
| Magic text |
{bluetooth_device_name}
|
| Description |
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
|
| Does it require a trigger? |
Requires a Bluetooth trigger (device connected or device disconnected) to be present.
|
| Name
|
Cell connection type
|
| Magic text |
{cell_connection}
|
| Description |
Cell connection type, e.g. 3G, 4G, 5G.
|
| Does it require a trigger? |
No
|
| Name
|
Cell id
|
| Magic text |
{cell_id}
|
| Description |
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)
|
| Does it require a trigger? |
No
|
| Name
|
Cell tower signal strength
|
| Magic text |
{cell_signal_strength}
|
| Description |
Returns the signal strength that your mobile device is receiving from the nearest cell tower. It is expressed in units called decibels-milliwatts (dBm), with -50 dBm being the strongest signal and -110 dBm being the weakest.
|
| Does it require a trigger? |
No
|
| Name
|
Clipboard text
|
| Magic text |
{clipboard}
|
| Description |
Retrieves the text from the clipboard.
If you are on Android 10+ you should have a look at the Refresh Cliboard action.
|
| Does it require a trigger? |
No
|
| Name
|
Current battery %
|
| Magic text |
{battery}
|
| Description |
Information on the current battery charge percentage, e.g. 80%.
|
| Does it require a trigger? |
No
|
| Name
|
Current Brightness
|
| Magic text |
{current_brightness}
|
| Description |
Information on the current brightness, e.g. 100.
|
| Does it require a trigger? |
No
|
| Name
|
Current Brightness (alternative Android 9)
|
| Magic text |
{current_brightness_alternative}
|
| Description |
Information on the current brightness, e.g. 100.
|
| Does it require a trigger? |
No
|
| Name
|
Current IP address
|
| Magic text |
{ip}
|
| Description |
Current IP in 172.217.12.141 format (randomly generated IP).
|
| Does it require a trigger? |
No
|
| Name
|
Foreground app
|
| Magic text |
{fg_app_name}
|
| Description |
Name of the application in the foreground, for example, Macrodroid.
|
| Does it require a trigger? |
No
|
| Name
|
Foreground package
|
| Magic text |
{fg_app_package}
|
| Description |
Package of the application in the foreground, for example, com.arlosoft.macrodroid.
|
| Does it require a trigger? |
No
|
| Name
|
New Line
|
| Magic text |
\n
|
| Description |
(Does not require { } or [ ]). It is a special character that marks the end of a line of text and the beginning of a new line. It is used to organize text into a readable and easy-to-read format.
For example, Hello world, the output would look like this:
Hello
world.
|
| Does it require a trigger? |
No
|
| Name
|
Application Launched/Closed
|
| Magic text |
{app_name}
|
| Gets the name of the application that was opened or closed according to the context.
|
| Does it require a trigger? |
Yes, it requires an Application Launched/Closed trigger to be present.
|