Changes

3,429 bytes added , 22:31, 3 January 2024

added Requires a condition (loop) and minor fixes

Line 14: Line 14:

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

+

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

+

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

+

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

+

+

{iterator_array_index}

+

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

+

</pre>

==Requires a trigger to operate==

Line 19: Line 41:

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

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

−

<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> [app_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>

Line 25: Line 47:

* '''''Application package'''''

−

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

Line 32: Line 54:

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

−

[app_name]

+

{app_name}

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

</pre>

* '''''Application package'''''

−

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

Line 44: Line 66:

* '''''Bluetooth device name'''''

−

[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

+

{bluetooth_device_name} = Headphones 1 Pro

</pre>

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

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

−

<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">[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

−

[call_name] = MacroDroid user

+

{call_name} = MacroDroid user

</pre>

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

−

[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

+

{call_number} = 1234567890

</pre>

Line 71: Line 93:

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

−

[sms_name] - Name of the person sending the SMS (the sender must be in your contact list).

+

{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

+

{sms_name} = Macrodroid user

</pre>

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

−

[sms_message] - Contains the text of the sms.

+

{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

+

{sms_message} = Hello, have a nice day

</pre>

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

−

[sms_number] - SMS sender number.

+

{sms_number} - SMS sender number.

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

−

[sms_number] = +1 1234567890

+

{sms_number} = +1 1234567890

</pre>

+

=== Logcat ===

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

−

[logcat_line] - Returns the reference logcat line configured in the trigger.

+

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

</pre>

Line 96: Line 119:

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

−

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

+

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

+

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

+

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

+

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

+

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

+

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

+

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

+

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

</pre>

+

=== Spotify ===

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

−

[spotify_track_id] - Returns the Track ID of the song.

+

{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

+

{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

+

{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

+

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

+

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

+

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

</pre>

+

=== Weather ===

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

Line 186: Line 211:

==Does not require a trigger to operate==

−

~~Does~~ not ~~depend on~~ a trigger

+

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

=== am/pm ===

Line 192: Line 217:

am or pm depending on the time.

</pre>

+

=== Android version ===

+

+

{android_version}

+

Returns the number of the android version.

+

</pre>

+

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

+

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

+

+

{battery_current_now}

+

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

+

</pre>

+

=== Battery temp ºC===

+

{battery_temp}

Temperature in degrees Celsius e.g. 34°

</pre>

+

=== Cell connection type ===

{cell_connection:type}

Line 202: Line 249:

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

</pre>

+

=== Cell id ===

Line 208: Line 256:

e.g. The cell identifier for a cell in New York City could be 310-200-0000. The LAC (310-200)

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

+

=== Clipboard text ===

Line 213: Line 268:

Gets the text from the clipboard.

</pre>

+

=== Current battery % ===

Line 218: Line 274:

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

</pre>

+

=== Current brightness ===

Line 223: Line 280:

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

</pre>

+

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

Line 229: Line 287:

alternative method for devices with android 9+

</pre>

+

=== Current IP address ===

Line 234: Line 293:

Current IP in 172.217.12.141 format (randomly generated IP).

</pre>

+

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

Line 239: Line 299:

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

</pre>

+

=== Current volume (Alarm) ===

Line 244: Line 305:

Current volume level used for alarms.

</pre>

+

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

Line 249: Line 311:

Current volume level used for multimedia/calls via Bluetooth.

</pre>

+

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

Line 254: Line 317:

Current volume level used for multimedia.

</pre>

+

=== Current volume (Notification) ===

Line 259: Line 323:

Current volume level used for notification alerts.

</pre>

+

=== Current volume (Ringer) ===

Line 264: Line 329:

Current volume level used for ringtone.

</pre>

+

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

Line 269: Line 335:

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

</pre>

+

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

Line 274: Line 341:

Current volume level used when a call is in progress.

</pre>

+

=== Day of the month ===

Line 279: Line 347:

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

</pre>

+

=== Day of the week ===

−

{}

+

{dayofweek}

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

</pre>

+

=== Device manufacturer ===

+

+

{device_manufacturer}

+

Brand name of your device.

+

</pre>

+

=== Device model ===

+

+

{device_model}

+

Model name of your device.

+

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

+

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

+

=== Device serial ===

+

{}

−

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

Not available on android 10+.

</pre>

+

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

+

=== Foreground app name ===

−

{}

+

{fg_app_name}

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

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

+

=== Hour of day ===

−

{}

+

{hour}

Time of day in 24h format.

</pre>

+

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

−

{}

+

{hour12}

Time of day in 12h format.

</pre>

+

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

−

{}

+

{hour_0}

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

</pre>

+

=== IMEI ===

−

{}

+

{imei}

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

</pre>

+

=== Language code ===

+

+

{language_code}

+

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

+

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

+

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

+

{last_loc_alt}

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

</pre>

+

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

−

{}

+

{last_loc_lat}

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

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

+

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

−

{}

+

{last_loc_link}

Gets a Google Maps link with the last known location.

</pre>

+

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

−

{}

+

{last_loc_long}

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

</pre>

+

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

−

{}

+

{last_loc_age_timestamp}

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

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

+

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

+

=== Location area code ===

Line 374: Line 492:

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>

+

=== Macro category ===

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

</pre>

+

=== Macro id ===

Line 383: Line 503:

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

</pre>

+

=== Macro name ===

+

{macro_name}

Name of the macro that was invoked.

</pre>

+

=== Macrodroid is pro ===

+

{macrodroid_is_pro}

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

</pre>

+

=== Macrodroid version ===

+

{macrodroid_version}

Version of macrodroid installed for example 5.40.x.

</pre>

+

=== Minute ===

+

{minute}

Current minute.

</pre>

+

=== Mobile country code ===

+

{mcc}

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

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

+

=== Month ===

+

{month}

Current month.

</pre>

+

=== Month (as digit) ===

+

{month_digit}

Current month (in numerical format).

</pre>

+

=== New line ===

Line 424: Line 561:

world

</pre>

+

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

Line 430: Line 568:

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

</pre>

+

=== RAM (Total) ===

Line 436: Line 575:

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

</pre>

+

=== RAM (available) ===

Line 441: Line 581:

Returns available RAM value.

</pre>

+

=== Screen resolution ===

Line 446: Line 587:

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

</pre>

+

=== Screen resolution (X) ===

Line 451: Line 593:

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

</pre>

+

=== Screen resolution (Y) ===

Line 456: Line 599:

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

</pre>

+

=== Screen timeout (seconds) ===

Line 461: Line 605:

</pre>

=== Second ===

+

Current second.

</pre>

+

=== Sim operator name ===

Line 469: Line 615:

Name of your telephone company.

</pre>

+

=== Sim 2 operator name ===

Line 474: Line 621:

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

</pre>

+

=== Stopwatches ===

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

Line 489: Line 637:

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

</pre>

+

=== Storage free (external) ===

Line 494: Line 643:

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

</pre>

+

=== Storage free (internal) ===

Line 499: Line 649:

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

</pre>

+

=== Storage total (external) ===

Line 504: Line 655:

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

Line 509: Line 661:

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

Line 514: Line 667:

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

Line 522: Line 676:

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

Line 532: Line 687:

corresponds to the google assistant.

</pre>

+

=== System setting (System) ===

Line 540: Line 696:

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

Line 545: Line 702:

The current time as maintained by your operating system.

</pre>

+

=== System time (ms) ===

Line 550: Line 708:

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>

Line 556: Line 715:

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

</pre>

+

=== Webhook Base Url ===

</pre>

Line 562: Line 722:

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>

Line 568: Line 729:

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

</pre>

+

=== Wifi signal strength ===

Line 573: Line 735:

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

JosueGd

editors

1,599

edits

Changes

Magic text2 (view source)

Revision as of 22:31, 3 January 2024