Changes

27,346 bytes added ,  22:31, 3 January 2024
added Requires a condition (loop) and minor fixes
Line 15: Line 15:  
</pre>
 
</pre>
   −
__TOC__
+
==<p><b>Requires a condition (loop)</b></p>==
 +
 
 +
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'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{iterator_value}
 +
The current dictionary key can be obtained within the loop using the magic text.
 +
</pre><br>
 +
* '''''Iterator dictionary key'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{iterator_dictionary_key}
 +
The current dictionary key can be obtained within the loop using the magic text.
 +
</pre><br>
 +
 
 +
* '''''Iterator array index'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{iterator_array_index}
 +
The current array index can be obtained within the loop using the magic text.
 +
</pre><br>
    
==<p><b>Requires a trigger to operate</b></p>==
 
==<p><b>Requires a trigger to operate</b></p>==
    
=== App Install/Remove/Update ===
 
=== App Install/Remove/Update ===
<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".
+
* '''''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><br>
   −
[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 package'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
   −
=== Apllication Launched/Closed ===
+
=== Application Launched/Closed ===
<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".
+
* '''''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><br>
 +
* '''''Application package'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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>
 +
 
 +
=== Bluethooth (Device connected or device disconnected) ===
 +
* '''''Bluetooth device name'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{bluetooth_device_name}
 +
Returns the name of the bluetooth device, may be more useful when using the "Any device" option.
   −
[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".
+
For example, if headphones are connected, it will return the device name.
 +
{bluetooth_device_name} = Headphones 1 Pro
 
</pre><br>
 
</pre><br>
    
=== Call (Active, Ended, Incoming, Missed, Outgoing) ===
 
=== Call (Active, Ended, Incoming, Missed, Outgoing) ===
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">[call_number] - Returns the number from which the call was received.
+
* '''''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] - Returns the name from where the call was received if available.
+
{call_name} = MacroDroid user
 +
</pre><br>
 +
* '''''Call number'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{call_number}
 +
Returns the name from where the call was received if available.
   −
For example, if you receive a call from 1234567890 registered as MacroDroid user
+
e.g. If you receive a call from 1234567890
[call_number] = 1234567890
+
{call_number} = 1234567890
[call_name] = MacroDroid user
   
</pre><br>
 
</pre><br>
   −
=== Bluethooth (Device connected or device disconnected) ===
+
=== SMS received ===
 +
* '''''Incoming SMS contact'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
* '''''Incoming SMS message'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
* '''''Incoming SMS number'''''
 
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
[bluetooth_device_name] - Returns the name of the bluetooth device, may be more useful when using the "Any device" option.
+
{sms_number} - SMS sender number.
 +
e.g. If you receive an SMS from +1 1234567890
 +
{sms_number} = +1 1234567890
 +
</pre><br>
   −
For example, if headphones are connected, it will return the device name.
+
=== Logcat ===
[bluetooth_device_name] = Headphones 1 Pro
+
* '''''Logcat entry line'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{logcat_line} - Returns the reference logcat line configured in the trigger.
 +
</pre><br>
    +
=== Notifications ===
 +
* '''''Notification title'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{not_title} - is a prominent text element that concisely summarizes the key subject or purpose of a notification.
 +
</pre><br>
 +
* '''''Notification ticker text'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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>
 +
* '''''Notification text'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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>
 +
* '''''Notification sub text'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{not_sub_text} - is a secondary text element that provides additional context or detail to a notification.
 +
</pre><br>
 +
* '''''Notification big text'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{not_text_lines} - is a feature that allows to display a more significant amount of text within a notification.
 +
</pre><br>
 +
* '''''Notification actions names'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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>
 +
* '''''Notification app name'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{not_app_name} - is the name of the app that generated the notification.
 +
</pre><br>
 +
* '''''Notification app package'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{not_app_package} - is the package name of the application that created the notification.
 
</pre><br>
 
</pre><br>
    
=== Spotify ===
 
=== Spotify ===
 +
* '''''Spotify track id'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{spotify_track_id} - Returns the Track ID of the song.
 +
</pre><br>
 +
* '''''Spotify artist'''''
 
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
[spotify_track_id] - Returns the Track ID of the song.
+
{spotify_artist} - Returns the artist of the song, "Started music" is not supported
[spotify_artist] - Returns the artist of the song.
+
</pre><br>
[spotify_album] - Returns the album of the song.
+
* '''''Spotify album name'''''
[spotify_track] - Returns the name of the song.
+
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
[spotify_length_s] - Returns the length of the song in seconds.
+
{spotify_album} - Returns the album of the song, "Started music" is not supported
[spotify_is_playing]- Returns a boolean state (true or false).
+
</pre><br>
 +
* '''''Spotify track name'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{spotify_track} - Returns the name of the song, "Started music" is not supported
 +
</pre><br>
 +
* '''''Spotify length (s)'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{spotify_length_s} - Returns the length of the song in seconds.
 +
</pre><br>
 +
* '''''Spotify is playing'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{spotify_is_playing}- Returns a boolean state (true or false).
 
</pre><br>
 
</pre><br>
   −
__TOC__
+
=== Weather ===
 +
* '''''Temperature (Celsius)'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{weather_temperature_c} - Temperature (Celsius).
 +
</pre><br>
 +
* '''''Temperature (Temperature (fahrenheit)'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{weather_temperature_farenheit} - Temperature (fahrenheit).
 +
</pre><br>
 +
* '''''Wind speed m\s'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{weather_wind_speed} - Wind speed m\s.
 +
</pre><br>
 +
* '''''Wind speed (mph)'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{weather_wind_speed_mph} - Wind speed (mph).
 +
</pre><br>
 +
* '''''Wind speed (kmh)'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{weather_wind_speed_kmh} - Wind speed (kmh).
 +
</pre><br>
 +
* '''''Temperature Wind direction'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{weather_wind_direction} - Wind direction (degrees).
 +
</pre><br>
 +
* '''''Humidity'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{weather_humidity} - Humidity.
 +
</pre><br>
 +
* '''''Weather conditions'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{weather_conditions} - Weather conditions.
 +
</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
+
This magic text list does not need a specific trigger to appear.
=== MacroDroid Mode ===
+
=== am/pm ===
Texto de la subsección 2.1
+
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{am_pm}
 +
am or pm depending on the time.
 +
</pre><br>
 +
 
 +
=== Android version ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{android_version}
 +
Returns the number of the android version.
 +
</pre><br>
 +
 
 +
=== Android version (SDK level) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{android_version_sdk}
 +
Returns the SDK level of the Android version.
 +
e.g. Android 14 has an SDK level of 34
 +
</pre><br>
 +
 
 +
=== Battery current now (mA) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{battery_current_now}
 +
Amount of electrical current flowing from the battery at this moment, measured in milliamps (mA)
 +
</pre><br>
 +
 
 +
=== Battery temp ºC===
 +
 
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{battery_temp}
 +
Temperature in degrees Celsius e.g. 34°
 +
</pre><br>
 +
 
 +
=== 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><br>
 +
 
 +
=== Cell id ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== Cell tower signal strength ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== Clipboard text ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{clipboard}
 +
Gets the text from the clipboard.
 +
</pre><br>
 +
 
 +
=== Current battery % ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{battery}
 +
Current battery level (numbers only) e.g. '80'
 +
</pre><br>
 +
 
 +
=== Current brightness ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{current_brightness}
 +
Current brightness level (numbers only) e.g. '50'
 +
</pre><br>
 +
 
 +
=== Current brightness (Android 9+ alternative) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{current_brightness_alternative}
 +
Current brightness level (numbers only) e.g. '50'
 +
alternative method for devices with android 9+
 +
</pre><br>
 +
 
 +
=== Current IP address ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{ip}
 +
Current IP in 172.217.12.141 format (randomly generated IP).
 +
</pre><br>
 +
 
 +
=== Current IP address (V6) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{ip6}
 +
Current IP in format in 2001:0db8:85a3:0000:0000:8a2e:0370:7334 format (randomly generated IP).
 +
</pre><br>
 +
 
 +
=== Current volume (Alarm) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{vol_alarm}
 +
Current volume level used for alarms.
 +
</pre><br>
 +
 
 +
=== Current volume (Bluetooth voice) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{vol_bt_voice}
 +
Current volume level used for multimedia/calls via Bluetooth.
 +
</pre><br>
 +
 
 +
=== Current volume (Media / Music) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{vol_music}
 +
Current volume level used for multimedia.
 +
</pre><br>
 +
 
 +
=== Current volume (Notification) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{vol_notif}
 +
Current volume level used for notification alerts.
 +
</pre><br>
 +
 
 +
=== Current volume (Ringer) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{vol_ring}
 +
Current volume level used for ringtone.
 +
</pre><br>
 +
 
 +
=== Current volume (System sounds) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{vol_system}
 +
Current volume level used for system sounds e.g. screen unlocking and locking, touch sounds among others.
 +
</pre><br>
 +
 
 +
=== Current volume (Voice call) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{vol_call}
 +
Current volume level used when a call is in progress.
 +
</pre><br>
 +
 
 +
=== Day of the month ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{dayofmonth}
 +
Day of the month, includes 0 at the beginning (days 1 to 9) e.g. 04 or 24.
 +
</pre><br>
 +
 
 +
=== Day of the week ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{dayofweek}
 +
Day of the week, e.g. Monday or Friday.
 +
</pre><br>
 +
 
 +
=== Device manufacturer ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{device_manufacturer}
 +
Brand name of your device.
 +
</pre><br>
 +
 
 +
=== Device model ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{device_model}
 +
Model name of your device.
 +
</pre><br>
 +
 
 +
=== Device uptime ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{uptime}
 +
Time that the device has been on (this time is reset if the device is restarted) in hour : minute : second.
 +
</pre><br>
 +
 
 +
=== Device uptime (s) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{uptime_secs}
 +
Time that the device has been on (this time is reset if the device is restarted) in seconds e.g. 3000s
 +
</pre><br>
 +
 
 +
=== Device serial ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{}
 +
Not available on android 10+.
 +
</pre><br>
 +
 
 +
=== Dictionary/Array size ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== Foreground app name ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{fg_app_name}
 +
Name of the application in the foreground, if you are in macrodroid, the output will be MacroDroid.
 +
</pre><br>
 +
 
 +
=== Foreground app package ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{fg_app_package}
 +
Package of the application in the foreground, if you are in macrodroid, the output will be MacroDroid.
 +
</pre><br>
 +
 
 +
=== Hour of day ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{hour}
 +
Time of day in 24h format.
 +
</pre><br>
 +
 
 +
=== Hour of day (12h) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{hour12}
 +
Time of day in 12h format.
 +
</pre><br>
 +
 
 +
=== Hour of day (Leanding zero) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{hour_0}
 +
Time of day in 24h format, includes leading zero.
 +
</pre><br>
 +
 
 +
=== IMEI ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{imei}
 +
Obtains the IMEI number, since Android 10+ this information is no longer available.
 +
</pre><br>
 +
 
 +
=== Language code ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{language_code}
 +
Language code used e.g. English is 'en'
 +
</pre><br>
 +
 
 +
=== Last known location (accuracy meters) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== Last known location (altitude) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{last_loc_alt}
 +
Gets the altitude above sea level of the last known location.
 +
</pre><br>
 +
 
 +
=== Last known location (lat) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{last_loc_lat}
 +
Gets the latitude above sea level of the last known location.
 +
</pre><br>
 +
 
 +
=== Last known location (lat,lon) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== Last known location (link) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{last_loc_link}
 +
Gets a Google Maps link with the last known location.
 +
</pre><br>
 +
 
 +
=== Last known location (lon) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{last_loc_long}
 +
Gets the longitude above sea level of the last known location.
 +
</pre><br>
 +
 
 +
=== Last known location (time) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{last_loc_age_timestamp}
 +
Gets the last known time in format (year - month - day hour : minute : second).
 +
</pre><br>
 +
 
 +
=== Last location speed (kmh) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== Last location speed (mph) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== Location area code ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== Macro category ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
Name of the category of the macro that was invoked, e.g. utilities, maps & navigation, notifications, productivity or custom names, etc.
 +
</pre><br>
 +
 
 +
=== Macro id ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{macro_id}
 +
is a GUID number used to uniquely identify a macro file.
 +
</pre><br>
 +
 
 +
=== Macro name ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{macro_name}
 +
Name of the macro that was invoked.
 +
</pre><br>
 +
 
 +
=== Macrodroid is pro ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{macrodroid_is_pro}
 +
Boolean value (true or false) depending on whether macrodroid is pro or not.
 +
</pre><br>
 +
 
 +
=== Macrodroid version ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{macrodroid_version}
 +
Version of macrodroid installed for example 5.40.x.
 +
</pre><br>
 +
 
 +
=== Minute ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{minute}
 +
Current minute.
 +
</pre><br>
 +
 
 +
=== Mobile country code ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{mcc}
 +
(MCC) is a three-digit country code used to identify the country of origin of a mobile network.
 +
</pre><br>
 +
 
 +
=== Mobile network code ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{mnc}
 +
Mobile Network Code (MNC) is a two or three digit code that uniquely identifies a mobile network operator within a country.
 +
</pre><br>
 +
 
 +
=== Month ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{month}
 +
Current month.
 +
</pre><br>
 +
 
 +
=== Month (as digit) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{month_digit}
 +
Current month (in numerical format).
 +
</pre><br>
 +
 
 +
=== New line ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
\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><br>
 +
 
 +
=== Power (on/off) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{power}
 +
Returns on or off depending on the current power state.
 +
e.g. If the charger is connected the response will be on.
 +
</pre><br>
 +
 
 +
=== RAM (Total) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== RAM (available) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{ram_available}
 +
Returns available RAM value.
 +
</pre><br>
 +
 
 +
=== Screen resolution ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{screen_res}
 +
Device screen resolution (X and Y) separated by ',' e.g. 1080,2400.
 +
</pre><br>
 +
 
 +
=== Screen resolution (X) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{screen_res_x}
 +
Device screen resolution (X) using a reference screen X 1080 Y 2400 the output will be 1080.
 +
</pre><br>
 +
 
 +
=== Screen resolution (Y) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{screen_res_y}
 +
Device screen resolution (Y) using a reference screen X 1080 Y 2400 the output will be 2400.
 +
</pre><br>
 +
 
 +
=== Screen timeout (seconds) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
Time that must elapse before the screen turns off (in seconds).
 +
</pre><br>
 +
=== Second ===
 +
 
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
Current second.
 +
</pre><br>
 +
 
 +
=== Sim operator name ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{sim_operator_name}
 +
Name of your telephone company.
 +
</pre><br>
 +
 
 +
=== Sim 2 operator name ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{sim2_operator_name}
 +
Name of your telephone company in the 2nd sim slot.
 +
</pre><br>
 +
 
 +
=== Stopwatches ===
 +
* '''''Seconds'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
* '''''hh:mm:ss'''''
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== Storage free (external) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{storage_external_free}
 +
Total amount of free space (external) e.g. 136GB.
 +
</pre><br>
 +
 
 +
=== Storage free (internal) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{storage_internal_free}
 +
Total amount of free space (internal) e.g. 136GB.
 +
</pre><br>
 +
 
 +
=== Storage total (external) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== Storage total (internal) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== String variable value ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== System setting (Global) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== System setting (Secure) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== System setting (System) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== System time ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{system_time}
 +
The current time as maintained by your operating system.
 +
</pre><br>
 +
 
 +
=== System time (ms) ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== Week of year ===
 +
</pre><br>
 +
<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><br>
 +
 
 +
=== Webhook Base Url ===
 +
</pre><br>
 +
<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
 +
</pre><br>
 +
 
 +
=== Wifi SSID ===
 +
</pre><br>
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{ssid}
 +
Name of the Wi-Fi network you are connected to.
 +
</pre><br>
 +
 
 +
=== Wifi signal strength ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{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><br>
 +
 
 +
=== Year ===
 +
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 +
{year}
 +
Current year.
 +
</pre><br>
editors
1,599

edits