Changes

Magic text (view source)

Revision as of 17:28, 23 April 2024

1,014 bytes added , 23 April

→‎About

Line 1: Line 1: −

(Updated to version 5.40, latest edition ~~January 3~~, 2024)

+

(Updated to version 5.44, latest edition 15 April, 2024)

+

== 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.

Line 14: Line 15:

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>~~

==Requires a condition (loop)==

Line 25: Line 25:

{iterator_value}

The current dictionary key can be obtained within the loop using the magic text.

−

</pre~~><br~~>

+

</pre>

* '''''Iterator dictionary key'''''

{iterator_dictionary_key}

The current dictionary key can be obtained within the loop using the magic text.

−

</pre>~~ ~~

+

</pre>

−

* '''''Iterator array index'''''

{iterator_array_index}

The current array index can be obtained within the loop using the magic text.

−

</pre>~~ ~~

+

</pre>

−

==Requires a trigger to operate==

Line 44: Line 42:

<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".

−

</pre>~~ ~~

+

</pre>

−

* '''''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".

−

</pre~~><br~~>

+

</pre>

=== Application Launched/Closed ===

Line 57: Line 54:

{app_name}

Returns the name of the application that was launched, for example "MacroDroid".

−

</pre~~><br~~>

+

</pre>

* '''''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".

−

</pre~~><br~~>

+

</pre>

=== Bluethooth (Device connected or device disconnected) ===

Line 72: Line 69:

For example, if headphones are connected, it will return the device name.

{bluetooth_device_name} = Headphones 1 Pro

−

</pre~~><br~~>

+

</pre>

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

+

* '''''Call group(s)'''''

+

+

{call_groups}

+

Returns the name of the group(s) where the contact is located.

+

If the contact is in more than one group, it will return all the groups it is in, separated by a comma.

+

e.g. If you receive a call from Work colleague

+

{call_groups} = Work colleagues, Friends

+

</pre>

* '''''Call name'''''

<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">{call_name}

Line 81: Line 87:

{call_name} = MacroDroid user

−

</pre~~><br~~>

+

</pre>

* '''''Call number'''''

Line 89: Line 95:

e.g. If you receive a call from 1234567890

{call_number} = 1234567890

−

</pre>~~ ~~

+

</pre>

−

=== SMS received ===

* '''''Incoming SMS contact'''''

Line 97: Line 102:

e.g. If you receive an SMS from Macrodroid user

{sms_name} = Macrodroid user

−

</pre~~><br~~>

+

</pre>

* '''''Incoming SMS message'''''

Line 103: Line 108:

e.g. If you receive an SMS with a message "Hello, have a nice day"

{sms_message} = Hello, have a nice day

−

</pre~~><br~~>

+

</pre>

* '''''Incoming SMS number'''''

Line 109: Line 114:

e.g. If you receive an SMS from +1 1234567890

{sms_number} = +1 1234567890

−

</pre>

+

</pre>

+

* '''''Incoming SMS sim id'''''

+

+

{sms_sim_id} - Return the ID of your SIM.

+

{sms_sim_id} = 4

+

</pre>

+

* '''''Incoming SMS sim name'''''

+

+

{sms_sim_name} - Return the company name of your SIM.

+

e.g. Vodafone

+

{sms_sim_name} = Vodafone

+

</pre>

=== Logcat ===

Line 115: Line 131:

{logcat_line} - Returns the reference logcat line configured in the trigger.

−

</pre>~~ ~~

+

</pre>

−

=== Notifications ===

* '''''Notification title'''''

{not_title} - is a prominent text element that concisely summarizes the key subject or purpose of a notification.

−

</pre~~><br~~>

+

</pre>

* '''''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.

−

</pre~~><br~~>

+

</pre>

* '''''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.

−

</pre~~><br~~>

+

</pre>

* '''''Notification sub text'''''

{not_sub_text} - is a secondary text element that provides additional context or detail to a notification.

−

</pre~~><br~~>

+

</pre>

* '''''Notification big text'''''

{not_text_lines} - is a feature that allows to display a more significant amount of text within a notification.

−

</pre~~><br~~>

+

</pre>

* '''''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.

−

</pre~~><br~~>

+

</pre>

* '''''Notification app name'''''

{not_app_name} - is the name of the app that generated the notification.

−

</pre~~><br~~>

+

</pre>

* '''''Notification app package'''''

{not_app_package} - is the package name of the application that created the notification.

−

</pre~~><br~~>

+

</pre>

=== Spotify ===

Line 155: Line 170:

{spotify_track_id} - Returns the Track ID of the song.

−

</pre~~><br~~>

+

</pre>

* '''''Spotify artist'''''

{spotify_artist} - Returns the artist of the song, "Started music" is not supported

−

</pre~~><br~~>

+

</pre>

* '''''Spotify album name'''''

{spotify_album} - Returns the album of the song, "Started music" is not supported

−

</pre~~><br~~>

+

</pre>

* '''''Spotify track name'''''

{spotify_track} - Returns the name of the song, "Started music" is not supported

−

</pre~~><br~~>

+

</pre>

* '''''Spotify length (s)'''''

{spotify_length_s} - Returns the length of the song in seconds.

−

</pre~~><br~~>

+

</pre>

* '''''Spotify is playing'''''

{spotify_is_playing}- Returns a boolean state (true or false).

−

</pre~~><br~~>

+

</pre>

=== System settings ===

Line 181: Line 196:

{system_setting_category} - Category of the requested key (Global, Secure, System).

−

</pre>~~ ~~

+

</pre>

−

* '''''System setting key'''''

{system_setting_key} - Returns the name of the key.

−

</pre>~~ ~~

+

</pre>

−

* '''''System setting value'''''

{system_setting_value} - Returns the value of the key.

−

</pre>

+

</pre>

+

=== Text Shared to MacroDroid ===

+

* '''''Shared Text'''''

+

+

{shared_text}

+

Gets the text that was sent from another application (Selected text > Share text > MacroDroid)

+

</pre>

=== UI click ===

{ui_click_text} - Gets the text it matches, most useful when the text it needs to match is a regular expression or text that changes constantly using some variable.

−

</pre>

+

</pre>

+

=== USB device connected ===

+

* '''''USB product name'''''

+

+

{usb_product_name} - Gets the name of the device.

+

</pre>

+

* '''''USB manufacturer name'''''

+

+

{usb_manufacturer_name} - Gets the name of the manufacturer.

+

</pre>

+

* '''''USB device hash code'''''

+

+

{usb_device_hash} - It is a unique identifier that is generated for each USB device.

+

</pre>

=== Weather ===

Line 202: Line 237:

{weather_temperature_c} - Temperature (Celsius).

−

</pre~~><br~~>

+

</pre>

* '''''Temperature (Temperature (fahrenheit)'''''

{weather_temperature_farenheit} - Temperature (fahrenheit).

−

</pre~~><br~~>

+

</pre>

* '''''Wind speed m\s'''''

{weather_wind_speed} - Wind speed m\s.

−

</pre~~><br~~>

+

</pre>

* '''''Wind speed (mph)'''''

{weather_wind_speed_mph} - Wind speed (mph).

−

</pre~~><br~~>

+

</pre>

* '''''Wind speed (kmh)'''''

{weather_wind_speed_kmh} - Wind speed (kmh).

−

</pre~~><br~~>

+

</pre>

* '''''Temperature Wind direction'''''

{weather_wind_direction} - Wind direction (degrees).

−

</pre~~><br~~>

+

</pre>

* '''''Humidity'''''

{weather_humidity} - Humidity.

−

</pre~~><br~~>

+

</pre>

* '''''Weather conditions'''''

{weather_conditions} - Weather conditions.

−

</pre~~><br~~>

+

</pre>

=== Webhook URL ===

Line 240: Line 275:

Example:

{webhook_caller_ip_address} = 189.172.30.212

−

</pre~~><br~~>

+

</pre>

==Does not require a trigger to operate==

Line 248: Line 283:

{am_pm}

am or pm depending on the time.

−

</pre>~~ ~~

+

</pre>

−

=== Android version ===

{android_version}

Returns the number of the android version.

−

</pre>~~ ~~

+

</pre>

−

=== Android version (SDK level) ===

Line 261: Line 294:

Returns the SDK level of the Android version.

e.g. Android 14 has an SDK level of 34

−

</pre>~~ ~~

+

</pre>

−

=== Battery current now (mA) ===

{battery_current_now}

Amount of electrical current flowing from the battery at this moment, measured in milliamps (mA)

−

</pre>~~ ~~

+

</pre>

−

=== Battery temp ºC===

Line 274: Line 305:

{battery_temp}

Temperature in degrees Celsius e.g. 34°

−

</pre>~~ ~~

+

</pre>

−

=== Cell connection type ===

+

{cell_connection:type}

−

~~<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">~~

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

−

</pre>~~ ~~

+

</pre>

−

=== Cell id ===

Line 287: Line 316:

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)

−

</pre>~~ ~~

+

</pre>

−

=== Cell tower signal strength ===

{cell_signal_strength}

Returns the signal strength received by your mobile device from the nearest cell tower. It is expressed in units called decibels-milliwatts (dBm), with -50 dBm being the strongest signal and -110 dBm the weakest.

−

</pre>~~ ~~

+

</pre>

−

=== Clipboard text ===

{clipboard}

Gets the text from the clipboard.

−

</pre>~~ ~~

+

</pre>

−

=== Current battery % ===

Line 306: Line 332:

({battery_int} for integer variables)

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

−

</pre>~~ ~~

+

</pre>

−

=== Current brightness ===

{current_brightness}

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

−

</pre>~~ ~~

+

</pre>

−

=== Current brightness (Android 9+ alternative) ===

Line 319: Line 343:

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

alternative method for devices with android 9+

−

</pre>~~ ~~

+

</pre>

−

=== Current IP address ===

{ip}

Current IP in 172.217.12.141 format (randomly generated IP).

−

</pre>~~ ~~

+

</pre>

−

=== Current IP address (V6) ===

{ip6}

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

−

</pre>~~ ~~

+

</pre>

−

=== Current volume (Alarm) ===

{vol_alarm}

Current volume level used for alarms.

−

</pre>~~ ~~

+

</pre>

−

=== Current volume (Bluetooth voice) ===

{vol_bt_voice}

Current volume level used for multimedia/calls via Bluetooth.

−

</pre>~~ ~~

+

</pre>

−

=== Current volume (Media / Music) ===

{vol_music}

Current volume level used for multimedia.

−

</pre>~~ ~~

+

</pre>

−

=== Current volume (Notification) ===

{vol_notif}

Current volume level used for notification alerts.

−

</pre>~~ ~~

+

</pre>

−

=== Current volume (Ringer) ===

{vol_ring}

Current volume level used for ringtone.

−

</pre>~~ ~~

+

</pre>

−

=== Current volume (System sounds) ===

{vol_system}

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

−

</pre>~~ ~~

+

</pre>

−

=== Current volume (Voice call) ===

{vol_call}

Current volume level used when a call is in progress.

−

</pre>~~ ~~

+

</pre>

−

=== Day of the month ===

{dayofmonth}

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

−

</pre>~~ ~~

+

</pre>

−

=== Day of the week ===

{dayofweek}

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

−

</pre>~~ ~~

+

</pre>

−

=== Device manufacturer ===

{device_manufacturer}

Brand name of your device.

−

</pre>~~ ~~

+

</pre>

−

=== Device model ===

{device_model}

Model name of your device.

−

</pre>~~ ~~

+

</pre>

−

=== Device uptime ===

{uptime}

Time that the device has been on (this time is reset if the device is restarted) in hour : minute : second.

−

</pre>~~ ~~

+

</pre>

−

=== Device uptime (s) ===

{uptime_secs}

Time that the device has been on (this time is reset if the device is restarted) in seconds e.g. 3000s

−

</pre>~~ ~~

+

</pre>

−

=== Device serial ===

{}

Not available on android 10+.

−

</pre>~~ ~~

+

</pre>

−

=== Dictionary/Array size ===

Line 422: Line 429:

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.

−

</pre>~~ ~~

+

</pre>

−

=== Foreground app name ===

{fg_app_name}

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

−

</pre>~~ ~~

+

</pre>

−

=== Foreground app package ===

{fg_app_package}

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

−

</pre>~~ ~~

+

</pre>

−

=== Hour of day ===

{hour}

Time of day in 24h format.

−

</pre>~~ ~~

+

</pre>

−

=== Hour of day (12h) ===

{hour12}

Time of day in 12h format.

−

</pre>~~ ~~

+

</pre>

−

=== Hour of day (Leanding zero) ===

{hour_0}

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

−

</pre>~~ ~~

+

</pre>

−

=== IMEI ===

{imei}

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

−

</pre>~~ ~~

+

</pre>

−

=== Language code ===

{language_code}

Language code used e.g. English is 'en'

−

</pre>~~ ~~

+

</pre>

−

=== Last known location (accuracy meters) ===

{last_loc_accuracy}

Obtains the precision of the most recent known location, for example 10 meters, due to different causes the GPS may have a greater or lesser margin of positioning error, useful to know how precise the last known location is.

−

</pre>~~ ~~

+

</pre>

−

=== Last known location (altitude) ===

{last_loc_alt}

Gets the altitude above sea level of the last known location.

−

</pre>~~ ~~

+

</pre>

−

=== Last known location (lat) ===

{last_loc_lat}

Gets the latitude above sea level of the last known location.

−

</pre>~~ ~~

+

</pre>

−

=== Last known location (lat,lon) ===

{last_loc_latlong}

Gets the latitude and longitude above sea level of the last known location separated by ',' e.g. 23.44325,-23.215252

−

</pre>~~ ~~

+

</pre>

−

=== Last known location (link) ===

{last_loc_link}

Gets a Google Maps link with the last known location.

−

</pre>~~ ~~

+

</pre>

−

=== Last known location (lon) ===

{last_loc_long}

Gets the longitude above sea level of the last known location.

−

</pre>~~ ~~

+

</pre>

−

=== Last known location (time) ===

{last_loc_age_timestamp}

Gets the last known time in format (year - month - day hour : minute : second).

−

</pre>~~ ~~

+

</pre>

−

=== Last location speed (kmh) ===

{last_loc_speed_kmh}

Obtains the current speed in km h (You need something to be monitoring your route, for example Waze or Google Maps), otherwise the value will be equal to 0.

−

</pre>~~ ~~

+

</pre>

−

=== Last location speed (mph) ===

{last_loc_speed_kmh}

Obtains the current speed in mph (You need something to be monitoring your route, for example Waze or Google Maps), otherwise the value will be equal to 0.

−

</pre>~~ ~~

+

</pre>

−

=== Location area code ===

{lac}

The LAC is a 16-bit number that identifies a location area on a cellular network. Each location zone consists of 1 to 65534 radio transmission cells.

−

</pre>~~ ~~

+

</pre>

−

=== Macro category ===

Name of the category of the macro that was invoked, e.g. utilities, maps & navigation, notifications, productivity or custom names, etc.

−

</pre>~~ ~~

+

</pre>

−

=== Macro id ===

{macro_id}

is a GUID number used to uniquely identify a macro file.

−

</pre>~~ ~~

+

</pre>

−

=== Macro name ===

{macro_name}

Name of the macro that was invoked.

−

</pre>~~ ~~

+

</pre>

−

=== Macrodroid is pro ===

{macrodroid_is_pro}

Boolean value (true or false) depending on whether macrodroid is pro or not.

−

</pre>~~ ~~

+

</pre>

−

=== Macrodroid version ===

{macrodroid_version}

Version of macrodroid installed for example 5.40.x.

−

</pre>~~ ~~

+

</pre>

−

=== Minute ===

{minute}

Current minute.

−

</pre>~~ ~~

+

</pre>

−

=== Mobile country code ===

{mcc}

(MCC) is a three-digit country code used to identify the country of origin of a mobile network.

−

</pre>~~ ~~

+

</pre>

−

=== Mobile network code ===

{mnc}

Mobile Network Code (MNC) is a two or three digit code that uniquely identifies a mobile network operator within a country.

−

</pre>~~ ~~

+

</pre>

−

=== Month ===

{month}

Current month.

−

</pre>~~ ~~

+

</pre>

−

=== Month (as digit) ===

{month_digit}

Current month (in numerical format).

−

</pre>~~ ~~

+

</pre>

−

=== New line ===

Line 593: Line 572:

Hello

world

−

</pre>~~ ~~

+

</pre>

−

=== Power (on/off) ===

Line 600: Line 578:

Returns on or off depending on the current power state.

e.g. If the charger is connected the response will be on.

−

</pre>~~ ~~

+

</pre>

−

=== RAM (Total) ===

Line 607: Line 584:

Returns real value of total RAM (not theoretical)

On a device with 6 GB of RAM, macrodroid will return, for example, 5.79, which is the real value.

−

</pre>~~ ~~

+

</pre>

−

=== RAM (available) ===

{ram_available}

Returns available RAM value.

−

</pre>~~ ~~

+

</pre>

−

=== Screen resolution ===

{screen_res}

Device screen resolution (X and Y) separated by ',' e.g. 1080,2400.

−

</pre>~~ ~~

+

</pre>

−

=== Screen resolution (X) ===

{screen_res_x}

Device screen resolution (X) using a reference screen X 1080 Y 2400 the output will be 1080.

−

</pre>~~ ~~

+

</pre>

−

=== Screen resolution (Y) ===

{screen_res_y}

Device screen resolution (Y) using a reference screen X 1080 Y 2400 the output will be 2400.

−

</pre>~~ ~~

+

</pre>

−

=== Screen timeout (seconds) ===

Time that must elapse before the screen turns off (in seconds).

−

</pre~~><br~~>

+

</pre>

=== Second ===

Current second.

−

</pre>~~ ~~

+

</pre>

−

=== Sim operator name ===

{sim_operator_name}

Name of your telephone company.

−

</pre>~~ ~~

+

</pre>

−

=== Sim 2 operator name ===

{sim2_operator_name}

Name of your telephone company in the 2nd sim slot.

−

</pre>~~ ~~

+

</pre>

−

=== Stopwatches ===

* '''''Seconds'''''

Line 662: Line 631:

Gets the total stopwatch time in seconds format e.g. 0.0

−

</pre~~><br~~>

+

</pre>

* '''''hh:mm:ss'''''

Line 669: Line 638:

Obtains the total time of the stopwatch in hour : minute : second format e.g. 00:00:00

−

</pre>~~ ~~

+

</pre>

−

=== Storage free (external) ===

{storage_external_free}

Total amount of free space (external) e.g. 136GB.

−

</pre>~~ ~~

+

</pre>

−

=== Storage free (internal) ===

{storage_internal_free}

Total amount of free space (internal) e.g. 136GB.

−

</pre>~~ ~~

+

</pre>

−

=== Storage total (external) ===

{storage_external_total}

Actual amount of space on external storage, e.g. On a theoretical 256 GB device the real value can be 221GB.

−

</pre>~~ ~~

+

</pre>

−

=== Storage total (internal) ===

{storage_internal_total}

Actual amount of space on internal storage, e.g. On a theoretical 256 GB device the real value can be 221GB.

−

</pre>~~ ~~

+

</pre>

−

=== String variable value ===

{strlen=my_var}

Length of a string variable, for the example we have a variable called my_var with the value 'hello world' the output would be 11

−

</pre>~~ ~~

+

</pre>

−

=== System setting (Global) ===

Line 708: Line 671:

For this example we will use the 'development_settings_enabled' key as a reference, which stores an int value (1 or 0) depending on whether the developer options are active or not.

−

</pre>~~ ~~

+

</pre>

−

=== System setting (Secure) ===

Line 719: Line 681:

corresponds to the google assistant.

−

</pre>~~ ~~

+

</pre>

−

=== System setting (System) ===

Line 728: Line 689:

For this example we will use the key 'time_12_24' as a reference, which stores a value of the time format used, the associated value is 12

−

</pre>~~ ~~

+

</pre>

−

=== System time ===

{system_time}

The current time as maintained by your operating system.

−

</pre>~~ ~~

+

</pre>

−

=== System time (ms) ===

{system_time_ms}

The current time according to your device's internal clock, measured in milliseconds since the Unix epoch. The Unix epoch is a reference point in time, set as January 1, 1970, at 00:00:00 Coordinated Universal Time (UTC).

−

</pre>~~ ~~

+

</pre>

−

=== Week of year ===

−

</pre>~~ ~~

+

</pre><pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">

−

{week_of_year}

Returns the week number of the year, e.g. Wednesday, January 3, week is 1.

−

</pre>~~ ~~

+

</pre>

−

=== Webhook Base Url ===

−

</pre>~~ ~~

+

</pre><pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">

−

{webhook_url}

−

Returns the base url of your webhook e.g. https://trigger.macrodroid.com/~~0d5c~~-~~49e12~~-6/ but it does not include the identifier only the base url, a complete url should look like this ~~Returns the base url of your webhook e.g.~~ https://trigger.macrodroid.com/~~0d5c~~-~~49e12~~-6/mywebhook

+

Returns the base url of your webhook e.g. https://trigger.macrodroid.com/6a10aa17-75cd-4856-9d71-84281205a320/ but it does not include the identifier only the base url, a complete url should look like this:

−

</pre>~~ ~~

+

https://trigger.macrodroid.com/6a10aa17-75cd-4856-9d71-84281205a320/mywebhook

−

+

</pre>

=== Wifi SSID ===

−

</pre>~~ ~~

+

</pre><pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">

−

{ssid}

Name of the Wi-Fi network you are connected to.

−

</pre>~~ ~~

+

</pre>

−

=== Wifi signal strength ===

{wifi_strength}

It represents the signal power in decibels per kilowatt. The higher the number (a negative number), the stronger the signal. For example, -60 dBm is louder than -70 dBm.

−

</pre>~~ ~~

+

</pre>

−

=== Year ===

{year}

Current year.

−

</pre~~><br~~>

+

</pre>

JosueGd

editors

1,590

edits