Changes

Magic text (view source)

Revision as of 22:43, 3 January 2024

19,612 bytes added , 3 January

If for any reason you need backup of the previous page, you can request it at josue@macrodroid.com

Line 1: Line 1: −

+

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

Line 14: Line 15:

</pre>

−

~~{| class~~=~~"wikitable" style~~=~~"text-align: center; border-collapse:collapse; border-radius: 10px; overflow: hidden;"~~

+

==Requires a condition (loop)==

−

|-

−

~~! style="color:green" | Magic text that does NOT depend on triggers.~~

−

~~! style="color:red" | Magic text depends on triggers.~~

−

~~|+Updated to version 5.33.x (May 2023).~~

−

|-

−

~~|style="color:green;"|Stopwatches~~

−

~~| style="color:red;" |App installed/updated/removed trigger:~~

−

*Application name

−

*Application package

−

|-

−

~~|style="color:green;"|Variables users have created~~

−

~~| style="color:red;" |Application opened/closed trigger:~~

−

*Application name

−

|-

−

~~|style="color:green;"|String variable length~~

−

~~|style="color:red;" |Call triggers:~~

−

*Call name

−

*Call number

−

|-

−

~~|style="color:green;"|String variable value~~

−

~~|style="color:red;" |Bluethooth~~ (~~Device connected or device disconnected~~):

−

*Bluethooth device name

−

|-

−

~~|style="color:green;"|Dictionary~~/~~Array size~~

−

~~|style="color:red;" |SMS recived:~~

−

*Incoming SMS contact

−

*incoming SMS message

−

*incoming SMS number

−

|-

−

~~|style="color:green;"|New line~~

−

~~|style="color:red;" |Logcat:~~

−

*Logcat entry line

−

|-

−

~~|style="color:green;"|Foreground app name~~

−

~~|style="color:red;" |Spotify:~~

−

*Track ID

−

*Artist name

−

*Album name

−

*Track name

−

*Track length (s)

−

*Is playing

−

|-

−

~~|style="color:green;"|Foreground app package~~

−

~~|style="color:red;" |Notifications:~~

−

*Title

−

*Ticker text

−

*Sub text

−

*Text lines

−

*Big lines

−

*Action names

−

*App name

−

*App package

−

|-

−

~~|style="color:green;"|Current brightness~~

−

~~|style="color:red;" |Weather~~

−

*Temperature (Celsius)

−

*Temperature (Fahrenheit)

−

*Wind speed m/s

−

*Wind speed (mph)

−

*Wind speed (kmh)

−

*Wind direction (degrees)

−

*Humidity

−

*Weather conditions

−

|-

−

~~|style="color:green;"|Current brightness (Android 9+ alternative)~~

−

|-

−

|-

−

~~|style="color:green;"|Screen timeout (seconds)~~

−

|-

−

|-

−

~~|style="color:green;"|Current battery %~~

−

|-

−

|-

−

~~|style="color:green;"|Battery temp ºC~~

−

|-

−

|-

−

~~|style="color:green;|"Power (on/off)~~

−

|-

−

|-

−

~~|style="color:green;"|Clipboard text~~

−

|-

−

|-

−

~~|style="color:green;"|Current IP address~~

−

|-

−

|-

−

~~|style="color:green;"|Current IP address (V6)~~

−

|-

−

|-

−

~~|style="color:green;"|Wifi SSID~~

−

|-

−

|-

−

~~|style="color:green;"|Wifi signal strength~~

−

|-

−

|-

−

~~|style="color:green;"|Cell tower signal strength~~

−

|-

−

|-

−

~~|style="color:green;"|Day of the week~~

−

|-

−

|-

−

~~|style="color:green;"|Day of the month~~

−

|-

−

|-

−

~~|style="color:green;"|Week of year~~

−

|-

−

|-

−

~~|style="color:green;"|Month~~

−

|-

−

|-

−

~~|style="color:green;"|Month (as digit)~~

−

|-

−

|-

−

~~|style="color:green;"|Year~~

−

|-

−

|-

−

~~|style="color:green;"|Hour of day~~

−

|-

−

|-

−

~~|style="color:green;"|Hour of day (Leanding zero)~~

−

|-

−

|-

−

~~|style="color:green;"|Hour of day (12h)~~

−

|-

−

|-

−

~~|style="color:green;"|Minute~~

−

|-

−

|-

−

~~|style="color:green;"|Second~~

−

|-

−

|-

−

~~|style="color:green;"|am/pm~~

−

|-

−

|-

−

~~|style="color:green;"|System time~~

−

|-

−

|-

−

~~|style="color:green;"|System time (ms)~~

−

|-

−

|-

−

~~|style="color:green;"|Webhook Base Url~~

−

|-

−

|-

−

~~|style="color:green;"|System setting (System)~~

−

|-

−

|-

−

~~|style="color:green;"|System setting (Global)~~

−

|-

−

|-

−

~~|style="color:green;"|System setting (Secure)~~

−

|-

−

|-

−

~~|style="color:green;"|Cell connection type~~

−

|-

−

|-

−

~~|style="color:green;"|Mobile country code~~

−

|-

−

|-

−

~~|style="color:green;"|Mobile network code~~

−

|-

−

|-

−

~~|style="color:green;"|Location area code~~

−

|-

−

|-

−

~~|style="color:green;"|IMEI~~

−

|-

−

|-

−

~~|style="color:green;"|Cell id~~

−

|-

−

|-

−

~~|style="color:green;"|Last known location (lat,lon)~~

−

|-

−

|-

−

~~|style="color:green;"|Last known location (lat)~~

−

|-

−

|-

−

~~|style="color:green;"|Last known location (lon)~~

−

|-

−

|-

−

~~|style="color:green;"|Last known location (altitude)~~

−

|-

−

|-

−

~~|style="color:green;"|Last known location (accuracy meters)~~

−

|-

−

|-

−

~~|style="color:green;"|Last known location (link)~~

−

|-

−

|-

−

~~|style="color:green;"|Last known location (time)~~

−

|-

−

|-

−

~~|style="color:green;"|Last location speed (kmh)~~

−

|-

−

|-

−

~~|style="color:green;"|Last location speed (mph)~~

−

|-

−

|-

−

~~|style="color:green;"|Current volume (Alarm)~~

−

|-

−

|-

−

~~|style="color:green;"|Current volume (Media~~ / ~~Music)~~

−

|-

−

|-

−

~~|style="color:green;"|Current volume (Ringer)~~

−

|-

−

|-

−

~~|style~~=~~"color:green;"|Current volume (Notification)~~

−

|-

−

|-

−

~~|style~~=~~"color:green;"|Current volume (System sounds)~~

−

|-

−

|-

−

~~|style="color:green;"|Current volume (Voice call)~~

−

|-

−

|-

−

~~|style="color:green;"|Current volume (Bluetooth voice)~~

−

|-

−

|-

−

~~|style="color:green;"|Macro name~~

−

|-

−

|-

−

~~|style="color:green;"|Macro id~~

−

|-

−

|-

−

~~|style="color:green;"|Macro category~~

−

|-

−

|-

−

~~|style="color:green;"|Device serial~~

−

|-

−

|-

−

~~|style="color:green;"|Device name~~

−

|-

−

|-

−

~~|style="color:green;"|Device uptime~~

−

|-

−

|-

−

~~|style="color:green;"|Device uptime (s)~~

−

|-

−

|-

−

~~|style="color:green;"|Device manufacturer~~

−

|-

−

|-

−

~~|style="color:green;"|Device model~~

−

|-

−

|-

−

~~|style="color:green;"|Macrodroid version~~

−

|-

−

|-

−

~~|style="color:green;"|Macrodroid is pro~~

−

|-

−

|-

−

~~|style="color:green;"|Android version~~

−

|-

−

|-

−

~~|style="color:green;"|Android version (SDK level)~~

−

|-

−

~~|style="color:green;"|Sim operator name~~

−

|-

−

|-

−

~~|style="color:green;"|Screen resolution~~

−

|-

−

|-

−

~~|style="color:green;"|Screen resolution (X)~~

−

|-

−

|-

−

~~|style="color:green;"|Screen resolution (Y)~~

−

|-

−

|-

−

~~|style="color:green;"|RAM (Total)~~

−

|-

−

|-

−

~~|style="color:green;"|RAM (available)~~

−

|-

−

|-

−

~~|style="color:green;"|Storage total (external)~~

−

|-

−

|-

−

~~|style="color:green;"|Storage free (external)~~

−

|-

−

|-

−

~~|style="color:green;"|Storage total (internal)~~

−

|-

−

|-

−

~~|style="color:green;"|Storage free (external)~~

−

|-

−

|-

−

|}

−

~~== List~~ of ~~non trigger-specific magic texts (with explanations) [Updated~~ to v5.~~38] [Work in progress] ==~~

+

This action is a specialized type of loop that can be used to iterate over all elements within a dictionary/array.

−

~~[[Magic text:MacroDroid Mode|MacroDroid Mode]]~~

−

~~[[Magic~~ text:~~Stopwatches|Stopwatches]]~~

+

=== Iterate Dictionary/Array ===

+

* '''''Iterator value'''''

+

+

{iterator_value}

+

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

+

</pre>

+

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

+

+

{iterator_dictionary_key}

+

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

+

</pre>

−

~~[[Magic~~ text~~:Local variables|Local variables]]~~

+

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

+

+

{iterator_array_index}

+

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

+

</pre>

−

~~[[Magic text:Global variables|Global variables]]~~

+

==Requires a trigger to operate==

−

~~[[Magic text~~:~~String variable length|String variable length]]~~

+

=== App Install/Remove/Update ===

+

* '''''Application name'''''

+

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

−

~~[[Magic text~~:~~New Line|New Line]]~~

+

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

−

~~[[Magic text~~:~~Foreground app~~ name~~|Foreground app~~ name]]

+

=== Application Launched/Closed ===

+

* '''''Application name'''''

+

+

{app_name}

+

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

+

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

−

~~[[Magic text~~:~~Foreground app package|Foreground app package]]~~

+

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

−

~~[[Magic text:Current Brightness|Current Brightness]]~~

+

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

+

{bluetooth_device_name} = Headphones 1 Pro

+

</pre>

−

~~[[Magic text:Current Brightness~~ (~~Android 9+ alternative~~)~~|Current Brightness (Android 9+ alternative)]]~~

+

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

+

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

+

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

+

Returns the number from which the call was received.

+

e.g. If you receive a call from MacroDroid user

−

~~[[Magic text~~:~~Screen timeout (seconds)|Screen timeout (seconds)]]~~

+

{call_name} = MacroDroid user

+

</pre>

+

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

+

+

{call_number}

+

Returns the name from where the call was received if available.

−

~~[[Magic text:Current battery %|Current battery %]]~~

+

e.g. If you receive a call from 1234567890

+

{call_number} = 1234567890

+

</pre>

−

~~[[Magic~~ text:~~Battery temp °C|Battery temp °C]]~~

+

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

+

</pre>

+

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

+

</pre>

+

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

+

+

{sms_number} - SMS sender number.

+

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

+

{sms_number} = +1 1234567890

+

</pre>

−

~~[[Magic text~~:~~Battery current now (mA)|Battery current now (mA)]]~~

+

=== Logcat ===

+

* '''''Logcat entry line'''''

+

+

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

+

</pre>

−

~~[[Magic~~ text:~~Power (On~~/~~Off)|Power (On~~/~~Off)]]~~

+

=== Notifications ===

+

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

+

+

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

+

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

+

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

+

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

+

+

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

+

</pre>

+

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

+

+

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

+

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

+

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

+

+

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

+

</pre>

+

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

+

+

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

+

</pre>

−

~~[[Magic text~~:~~Clipboard text|Clipboard text]]~~

+

=== Spotify ===

+

* '''''Spotify track id'''''

+

+

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

+

</pre>

+

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

+

+

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

+

</pre>

+

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

+

+

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

+

</pre>

+

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

+

+

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

+

</pre>

+

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

+

+

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

+

</pre>

+

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

+

+

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

+

</pre>

−

~~[[Magic text~~:~~Current IP address|Current IP address]]~~

+

=== Weather ===

+

* '''''Temperature (Celsius)'''''

+

+

{weather_temperature_c} - Temperature (Celsius).

+

</pre>

+

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

+

+

{weather_temperature_farenheit} - Temperature (fahrenheit).

+

</pre>

+

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

+

+

{weather_wind_speed} - Wind speed m\s.

+

</pre>

+

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

+

+

{weather_wind_speed_mph} - Wind speed (mph).

+

</pre>

+

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

+

+

{weather_wind_speed_kmh} - Wind speed (kmh).

+

</pre>

+

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

+

+

{weather_wind_direction} - Wind direction (degrees).

+

</pre>

+

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

+

+

{weather_humidity} - Humidity.

+

</pre>

+

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

+

+

{weather_conditions} - Weather conditions.

+

</pre>

−

~~[[Magic~~ text:~~Current IP address (V6)|Current IP address (V6)]]~~

+

==Does not require a trigger to operate==

+

This magic text list does not need a specific trigger to appear.

+

=== am/pm ===

+

+

{am_pm}

+

am or pm depending on the time.

+

</pre>

−

~~[[Magic text~~:~~Wifi SSID|Wifi SSID]]~~

+

=== Android version ===

+

+

{android_version}

+

Returns the number of the android version.

+

</pre>

−

~~[[Magic text~~:~~Wifi/cell signal strength|Wifi~~/~~cell signal strength]]~~

+

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

+

+

{android_version_sdk}

+

Returns the SDK level of the Android version.

+

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

+

</pre>

−

~~[[Magic text~~:~~Day of the week|Day~~ of the ~~week]]~~

+

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

+

+

{battery_current_now}

+

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

+

</pre>

−

~~[[Magic text:Day of the month|Day of the month]]~~

+

=== Battery temp ºC===

−

~~[[Magic text~~:~~Week of year|Week of year]]~~

+

+

{battery_temp}

+

Temperature in degrees Celsius e.g. 34°

+

</pre>

−

~~[[Magic text~~:~~Month|Month]]~~

+

=== Cell connection type ===

+

{cell_connection:type}

+

+

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

+

</pre>

−

~~[[Magic text~~:~~Month (as digit)|Month~~ (~~as digit~~)]]

+

=== Cell id ===

+

+

{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)

+

</pre>

−

~~[[Magic text~~:~~Year|Year]]~~

+

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

−

~~[[Magic~~ text:~~Hour of day|Hour of day]]~~

+

=== Clipboard text ===

+

+

{clipboard}

+

Gets the text from the clipboard.

+

</pre>

−

~~[[Magic text~~:~~Hour of day (Leading zero)|Hour of day~~ (~~Leading zero~~)]]

+

=== Current battery % ===

+

+

{battery}

+

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

+

</pre>

−

~~[[Magic text~~:~~Hour of day (12h)|Hour of day~~ (~~12h~~)]]

+

=== Current brightness ===

+

+

{current_brightness}

+

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

+

</pre>

−

~~[[Magic text~~:~~Minute|Minute]]~~

+

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

+

+

{current_brightness_alternative}

+

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

+

alternative method for devices with android 9+

+

</pre>

−

~~[[Magic text~~:~~Second|Second]]~~

+

=== Current IP address ===

+

+

{ip}

+

Current IP in 172.217.12.141 format (randomly generated IP).

+

</pre>

−

~~[[Magic text~~:~~am/pm|am~~/~~pm]]~~

+

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

+

+

{ip6}

+

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

+

</pre>

−

~~[[Magic text~~:~~System time|System time]]~~

+

=== Current volume (Alarm) ===

+

+

{vol_alarm}

+

Current volume level used for alarms.

+

</pre>

−

~~[[Magic text:System time~~ (ms)~~|System time (ms)]]~~

+

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

+

+

{vol_bt_voice}

+

Current volume level used for multimedia/calls via Bluetooth.

+

</pre>

−

~~[[Magic text~~:~~WebHook Base Url|WebHook Base Url]]~~

+

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

+

+

{vol_music}

+

Current volume level used for multimedia.

+

</pre>

−

~~[[Magic text:System Setting~~ (~~System~~)~~|System Setting (System)]]~~

+

=== Current volume (Notification) ===

+

+

{vol_notif}

+

Current volume level used for notification alerts.

+

</pre>

−

~~[[Magic text:System Setting~~ (~~Global~~)~~|System Setting (Global)]]~~

+

=== Current volume (Ringer) ===

+

+

{vol_ring}

+

Current volume level used for ringtone.

+

</pre>

−

~~[[Magic text:System Setting~~ (~~Secure)|~~System ~~Setting (Secure~~)]]

+

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

+

+

{vol_system}

+

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

+

</pre>

−

~~[[Magic text~~:~~Cell Connection Type|Cell Connection Type]]~~

+

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

+

+

{vol_call}

+

Current volume level used when a call is in progress.

+

</pre>

−

~~[[Magic text~~:~~Mobile Country Code|Mobile Country Code]]~~

+

=== Day of the month ===

+

+

{dayofmonth}

+

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

+

</pre>

−

~~[[Magic text~~:~~Mobile Network Code|Mobile Network Code]]~~

+

=== Day of the week ===

+

+

{dayofweek}

+

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

+

</pre>

−

~~[[Magic text~~:~~Location Area Code|Location Area Code]]~~

+

=== Device manufacturer ===

+

+

{device_manufacturer}

+

Brand name of your device.

+

</pre>

−

~~[[Magic text~~:~~Cell Id|Cell Id]]~~

+

=== Device model ===

+

+

{device_model}

+

Model name of your device.

+

</pre>

−

~~[[Magic text~~:~~Last known location~~ (~~lat,lon~~)~~|Last known location (lat,lon)]]~~

+

=== Device uptime ===

+

+

{uptime}

+

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

+

</pre>

−

~~[[Magic text:Last known location~~ (~~lat~~)~~|Last known location~~ (~~lat~~)]]

+

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

−

~~[[Magic text~~:~~Last known location (lon)|Last known location (lon)]]~~

+

=== Device serial ===

+

+

{}

+

Not available on android 10+.

+

</pre>

−

[[~~Magic text:Last known location (altitude)|Last known location (altitude)]~~]

+

=== Dictionary/Array size ===

+

+

{size=my_array}

+

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>

−

~~[[Magic text~~:~~Last known location (accuracy meters)|Last known location (accuracy meters)]]~~

+

=== Foreground app name ===

+

+

{fg_app_name}

+

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

+

</pre>

−

~~[[Magic text~~:~~Last known location (link)|Last known location (link)]]~~

+

=== Foreground app package ===

+

+

{fg_app_package}

+

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

+

</pre>

−

~~[[Magic text~~:~~Last known location (time)|Last known location (time)]]~~

+

=== Hour of day ===

+

+

{hour}

+

Time of day in 24h format.

+

</pre>

−

~~[[Magic text:Last location speed~~ (~~kmh~~)~~|Last location speed (kmh)]]~~

+

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

+

+

{hour12}

+

Time of day in 12h format.

+

</pre>

−

~~[[Magic text:Last location speed~~ (~~mph~~)~~|Last location speed (mph)]]~~

+

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

+

+

{hour_0}

+

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

+

</pre>

−

~~[[Magic text~~:~~Current Volume (Alarm)|Current Volume (Alarm)]]~~

+

=== IMEI ===

+

+

{imei}

+

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

+

</pre>

−

~~[[Magic text~~:~~Current Volume (Media / Music)|Current Volume (Media~~ / ~~Music)]]~~

+

=== Language code ===

+

+

{language_code}

+

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

+

</pre>

−

~~[[Magic text:Current Volume~~ (~~Ringer~~)~~|Current Volume (Ringer)]]~~

+

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

−

~~[[Magic text:Current Volume~~ (~~Notification~~)~~|Current Volume (Notification)]]~~

+

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

+

+

{last_loc_alt}

+

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

+

</pre>

−

~~[[Magic text:Current Volume~~ (~~System Sounds~~)~~|Current Volume (System Sounds)]]~~

+

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

+

+

{last_loc_lat}

+

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

+

</pre>

−

~~[[Magic text:Current Volume~~ (~~Voice Call~~)~~|Current Volume (Voice Call)]]~~

+

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

−

~~[[Magic text:Current Volume~~ (~~Bluetooth Voice~~)~~|Current Volume (Bluetooth Voice)]]~~

+

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

+

+

{last_loc_link}

+

Gets a Google Maps link with the last known location.

+

</pre>

−

~~[[Magic text~~:~~Macro name|Macro name]]~~

+

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

+

+

{last_loc_long}

+

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

+

</pre>

−

~~[[Magic text~~:~~Macro id|Macro id]]~~

+

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

+

+

{last_loc_age_timestamp}

+

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

+

</pre>

−

~~[[Magic text~~:~~Macro category|Macro category]]~~

+

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

−

~~[[Magic text~~:~~Device name|Device name]]~~

+

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

−

~~[[Magic text~~:~~Device uptime|Device uptime]]~~

+

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

−

~~[[Magic text~~:~~Device uptime (s)|Device uptime (s)]]~~

+

=== Macro category ===

+

+

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

+

</pre>

−

~~[[Magic text~~:~~Device manufacturer|Device manufacturer]]~~

+

=== Macro id ===

+

+

{macro_id}

+

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

+

</pre>

−

~~[[Magic text~~:~~Device model|Device model]]~~

+

=== Macro name ===

+

+

{macro_name}

+

Name of the macro that was invoked.

+

</pre>

−

~~[[Magic text~~:~~MacroDroid version|MacroDroid version]]~~

+

=== Macrodroid is pro ===

+

+

{macrodroid_is_pro}

+

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

+

</pre>

−

~~[[Magic text~~:~~MacroDroid is pro|MacroDroid is pro]]~~

+

=== Macrodroid version ===

+

+

{macrodroid_version}

+

Version of macrodroid installed for example 5.40.x.

+

</pre>

−

~~[[Magic text~~:~~Android version|Android version]]~~

+

=== Minute ===

+

+

{minute}

+

Current minute.

+

</pre>

−

~~[[Magic text~~:~~Android version (SDK Level)|Android version~~ (~~SDK Level~~)]]

+

=== Mobile country code ===

+

+

{mcc}

+

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

+

</pre>

−

~~[[Magic text~~:~~SIM operator name|SIM~~ operator ~~name]]~~

+

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

−

~~[[Magic text~~:~~SIM 2 operator name|SIM 2 operator name]]~~

+

=== Month ===

+

+

{month}

+

Current month.

+

</pre>

−

~~[[Magic text~~:~~Screen resolution|Screen resolution]]~~

+

=== Month (as digit) ===

+

+

{month_digit}

+

Current month (in numerical format).

+

</pre>

−

~~[[Magic text~~:~~Screen Resolution~~ (X)~~|Screen Resolution (X)]]~~

+

=== New line ===

+

+

\n

+

(Does not require { } )

+

is a special character that indicates the end of a line of text and the beginning of a new line. It is used to organize text in a readable and easy-to-read format.

+

e.g. Hello\nworld, the output would look like this:

+

Hello

+

world

+

</pre>

−

~~[[Magic text:Screen Resolution~~ (Y)~~|Screen Resolution (Y)]]~~

+

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

+

+

{power}

+

Returns on or off depending on the current power state.

+

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

+

</pre>

−

~~[[Magic text:~~RAM (total)|RAM (~~total~~)]]

+

=== RAM (Total) ===

+

+

{ram_total}

+

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>

−

~~[[Magic text:~~RAM (available)|RAM ~~(available)]]~~

+

=== RAM (available) ===

+

+

{ram_available}

+

Returns available RAM value.

+

</pre>

−

~~[[Magic text~~:~~Storage total (external)|Storage total~~ (~~external~~)]]

+

=== Screen resolution ===

+

+

{screen_res}

+

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

+

</pre>

−

~~[[Magic text:Storage free~~ (~~external~~)~~|Storage free~~ (~~external~~)]]

+

=== Screen resolution (X) ===

+

+

{screen_res_x}

+

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

+

</pre>

−

~~[[Magic text:Storage total~~ (~~internal~~)~~|Storage total~~ (~~internal~~)]]

+

=== Screen resolution (Y) ===

+

+

{screen_res_y}

+

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

+

</pre>

−

~~[[Magic text:Storage free~~ (~~internal~~)~~|Storage free~~ (~~internal~~)]]

+

=== Screen timeout (seconds) ===

+

+

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

+

</pre>

+

=== Second ===

−

=~~= List of known Hidden magic texts [Updated to v5~~.~~38] ==~~

+

−

~~'''Note : These magic texts might not work properly.'''~~

+

Current second.

+

</pre>

−

~~The~~ developer ~~confirmed that~~ this is the ~~only hidden magic text~~.

+

=== Sim operator name ===

−

~~[[Hidden Magic text~~:~~Battery~~ current ~~average|Battery~~ current ~~average]]~~

+

+

{sim_operator_name}

+

Name of your telephone company.

+

</pre>

+

=== Sim 2 operator name ===

+

+

{sim2_operator_name}

+

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

+

</pre>

+

=== Stopwatches ===

+

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

+

+

{stopwatch=f}

+

It will not be visible if you do not have stopwatch created

+

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

+

</pre>

+

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

+

+

{stopwatchtime=f}

+

It will not be visible if you do not have stopwatch created

+

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

+

</pre>

+

=== Storage free (external) ===

+

+

{storage_external_free}

+

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

+

</pre>

+

=== Storage free (internal) ===

+

+

{storage_internal_free}

+

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

+

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

+

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

+

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

+

=== System setting (Global) ===

+

+

{setting_global=development_settings_enabled}

+

Caution: Particular care should be taken when modifying settings, as incorrect changes could affect the functionality or security of the device.

+

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>

+

=== System setting (Secure) ===

+

+

{setting_secure=assistant}

+

Caution: Particular care should be taken when modifying settings, as incorrect changes could affect the functionality or security of the device.

+

For this example we will use the 'assistant' key as a reference, which stores a value of the assistant used, the associated value is com.google.android.googlequicksearchbox/com.google.android.voiceinteraction.GsaVoiceInteractionService

+

corresponds to the google assistant.

+

</pre>

+

=== System setting (System) ===

+

+

{setting_system=time_12_24}

+

Caution: Particular care should be taken when modifying settings, as incorrect changes could affect the functionality or security of the device.

+

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>

+

=== System time ===

+

+

{system_time}

+

The current time as maintained by your operating system.

+

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

+

=== Week of year ===

+

</pre>

+

+

{week_of_year}

+

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

+

</pre>

+

=== Webhook Base Url ===

+

</pre>

+

+

{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

+

</pre>

+

=== Wifi SSID ===

+

</pre>

+

+

{ssid}

+

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

+

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

+

=== Year ===

+

+

{year}

+

Current year.

+

</pre>

JosueGd

editors

1,599

edits