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 == | | == 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. | | 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. | | 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>
| |
| | | |
| ==<p><b>Requires a condition (loop)</b></p>== | | ==<p><b>Requires a condition (loop)</b></p>== |
Line 25: |
Line 25: |
| {iterator_value} | | {iterator_value} |
| The current dictionary key can be obtained within the loop using the magic text. | | The current dictionary key can be obtained within the loop using the magic text. |
− | </pre><br> | + | </pre> |
| * '''''Iterator dictionary key''''' | | * '''''Iterator dictionary key''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {iterator_dictionary_key} | | {iterator_dictionary_key} |
| The current dictionary key can be obtained within the loop using the magic text. | | The current dictionary key can be obtained within the loop using the magic text. |
− | </pre><br> | + | </pre> |
− | | |
| * '''''Iterator array index''''' | | * '''''Iterator array index''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {iterator_array_index} | | {iterator_array_index} |
| The current array index can be obtained within the loop using the magic text. | | The current array index can be obtained within the loop using the magic text. |
− | </pre><br> | + | </pre> |
− | | |
| ==<p><b>Requires a trigger to operate</b></p>== | | ==<p><b>Requires a trigger to operate</b></p>== |
| | | |
Line 44: |
Line 42: |
| <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". | | Returns the name of the application that was launched, for example "MacroDroid". |
− | </pre><br> | + | </pre> |
− | | |
| * '''''Application package''''' | | * '''''Application package''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {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". | | 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 === | | === Application Launched/Closed === |
Line 57: |
Line 54: |
| {app_name} | | {app_name} |
| Returns the name of the application that was launched, for example "MacroDroid". | | Returns the name of the application that was launched, for example "MacroDroid". |
− | </pre><br> | + | </pre> |
| * '''''Application package''''' | | * '''''Application package''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {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". | | 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) === | + | === Bluetooth (Device connected or device disconnected) === |
| * '''''Bluetooth device name''''' | | * '''''Bluetooth device name''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
Line 72: |
Line 69: |
| For example, if headphones are connected, it will return the device name. | | 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><br> | + | </pre> |
| | | |
| === Call (Active, Ended, Incoming, Missed, Outgoing) === | | === Call (Active, Ended, Incoming, Missed, Outgoing) === |
| + | * '''''Call group(s)''''' |
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| + | {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''''' | | * '''''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} |
Line 81: |
Line 87: |
| | | |
| {call_name} = MacroDroid user | | {call_name} = MacroDroid user |
− | </pre><br> | + | </pre> |
| * '''''Call number''''' | | * '''''Call 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;"> |
Line 89: |
Line 95: |
| e.g. If you receive a call from 1234567890 | | e.g. If you receive a call from 1234567890 |
| {call_number} = 1234567890 | | {call_number} = 1234567890 |
− | </pre><br> | + | </pre> |
− | | |
| === SMS received === | | === SMS received === |
| * '''''Incoming SMS contact''''' | | * '''''Incoming SMS contact''''' |
Line 97: |
Line 102: |
| e.g. If you receive an SMS from Macrodroid user | | e.g. If you receive an SMS from Macrodroid user |
| {sms_name} = Macrodroid user | | {sms_name} = Macrodroid user |
− | </pre><br> | + | </pre> |
| * '''''Incoming SMS message''''' | | * '''''Incoming SMS message''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
Line 103: |
Line 108: |
| e.g. If you receive an SMS with a message "Hello, have a nice day" | | 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><br> | + | </pre> |
| * '''''Incoming SMS number''''' | | * '''''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;"> |
Line 109: |
Line 114: |
| e.g. If you receive an SMS from +1 1234567890 | | e.g. If you receive an SMS from +1 1234567890 |
| {sms_number} = +1 1234567890 | | {sms_number} = +1 1234567890 |
− | </pre><br> | + | </pre> |
| + | * '''''Incoming SMS sim id''''' |
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| + | {sms_sim_id} - Return the ID of your SIM. |
| + | {sms_sim_id} = 4 |
| + | </pre> |
| + | * '''''Incoming SMS sim name''''' |
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| + | {sms_sim_name} - Return the company name of your SIM. |
| + | e.g. Vodafone |
| + | {sms_sim_name} = Vodafone |
| + | </pre> |
| | | |
| === Logcat === | | === Logcat === |
Line 115: |
Line 131: |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {logcat_line} - Returns the reference logcat line configured in the trigger. | | {logcat_line} - Returns the reference logcat line configured in the trigger. |
− | </pre><br> | + | </pre> |
− | | |
| === Notifications === | | === Notifications === |
| * '''''Notification title''''' | | * '''''Notification title''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <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. | | {not_title} - is a prominent text element that concisely summarizes the key subject or purpose of a notification. |
− | </pre><br> | + | </pre> |
| * '''''Notification ticker text''''' | | * '''''Notification ticker text''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <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. | | {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 text''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <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. | | {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''''' | | * '''''Notification sub text''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <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. | | {not_sub_text} - is a secondary text element that provides additional context or detail to a notification. |
− | </pre><br> | + | </pre> |
| * '''''Notification big text''''' | | * '''''Notification big text''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <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. | | {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''''' | | * '''''Notification actions names''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <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. | | {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''''' | | * '''''Notification app name''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <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. | | {not_app_name} - is the name of the app that generated the notification. |
− | </pre><br> | + | </pre> |
| * '''''Notification app package''''' | | * '''''Notification app package''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <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. | | {not_app_package} - is the package name of the application that created the notification. |
− | </pre><br> | + | </pre> |
| | | |
| === Spotify === | | === Spotify === |
Line 155: |
Line 170: |
| <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_track_id} - Returns the Track ID of the song. |
− | </pre><br> | + | </pre> |
| * '''''Spotify artist''''' | | * '''''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_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><br> | + | </pre> |
| * '''''Spotify album name''''' | | * '''''Spotify album name''''' |
| <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_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><br> | + | </pre> |
| * '''''Spotify track name''''' | | * '''''Spotify track name''''' |
| <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} - 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><br> | + | </pre> |
| * '''''Spotify length (s)''''' | | * '''''Spotify length (s)''''' |
| <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_length_s} - Returns the length of the song in seconds. | | {spotify_length_s} - Returns the length of the song in seconds. |
− | </pre><br> | + | </pre> |
| * '''''Spotify is playing''''' | | * '''''Spotify is playing''''' |
| <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_is_playing}- Returns a boolean state (true or false). | | {spotify_is_playing}- Returns a boolean state (true or false). |
− | </pre><br> | + | </pre> |
| | | |
| === System settings === | | === System settings === |
Line 181: |
Line 196: |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {system_setting_category} - Category of the requested key (Global, Secure, System). | | {system_setting_category} - Category of the requested key (Global, Secure, System). |
− | </pre><br> | + | </pre> |
− | | |
| * '''''System setting key''''' | | * '''''System setting key''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {system_setting_key} - Returns the name of the key. | | {system_setting_key} - Returns the name of the key. |
− | </pre><br> | + | </pre> |
− | | |
| * '''''System setting value''''' | | * '''''System setting value''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {system_setting_value} - Returns the value of the key. | | {system_setting_value} - Returns the value of the key. |
− | </pre><br> | + | </pre> |
| + | |
| + | === Text Shared to MacroDroid === |
| + | * '''''Shared Text''''' |
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| + | {shared_text} |
| + | |
| + | Gets the text that was sent from another application (Selected text > Share text > MacroDroid) |
| + | </pre> |
| + | |
| + | === UI click === |
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| + | {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> |
| + | |
| + | === USB device connected === |
| + | * '''''USB product name''''' |
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| + | {usb_product_name} - Gets the name of the device. |
| + | </pre> |
| + | * '''''USB manufacturer name''''' |
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| + | {usb_manufacturer_name} - Gets the name of the manufacturer. |
| + | </pre> |
| + | * '''''USB device hash code''''' |
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| + | {usb_device_hash} - It is a unique identifier that is generated for each USB device. |
| + | </pre> |
| | | |
| === Weather === | | === Weather === |
Line 197: |
Line 237: |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {weather_temperature_c} - Temperature (Celsius). | | {weather_temperature_c} - Temperature (Celsius). |
− | </pre><br> | + | </pre> |
| * '''''Temperature (Temperature (fahrenheit)''''' | | * '''''Temperature (Temperature (fahrenheit)''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {weather_temperature_farenheit} - Temperature (fahrenheit). | | {weather_temperature_farenheit} - Temperature (fahrenheit). |
− | </pre><br> | + | </pre> |
| * '''''Wind speed m\s''''' | | * '''''Wind speed m\s''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {weather_wind_speed} - Wind speed m\s. | | {weather_wind_speed} - Wind speed m\s. |
− | </pre><br> | + | </pre> |
| * '''''Wind speed (mph)''''' | | * '''''Wind speed (mph)''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {weather_wind_speed_mph} - Wind speed (mph). | | {weather_wind_speed_mph} - Wind speed (mph). |
− | </pre><br> | + | </pre> |
| * '''''Wind speed (kmh)''''' | | * '''''Wind speed (kmh)''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {weather_wind_speed_kmh} - Wind speed (kmh). | | {weather_wind_speed_kmh} - Wind speed (kmh). |
− | </pre><br> | + | </pre> |
| * '''''Temperature Wind direction''''' | | * '''''Temperature Wind direction''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {weather_wind_direction} - Wind direction (degrees). | | {weather_wind_direction} - Wind direction (degrees). |
− | </pre><br> | + | </pre> |
| * '''''Humidity''''' | | * '''''Humidity''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {weather_humidity} - Humidity. | | {weather_humidity} - Humidity. |
− | </pre><br> | + | </pre> |
| * '''''Weather conditions''''' | | * '''''Weather conditions''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {weather_conditions} - Weather conditions. | | {weather_conditions} - Weather conditions. |
− | </pre><br> | + | </pre> |
| | | |
| === Webhook URL === | | === Webhook URL === |
Line 235: |
Line 275: |
| Example: | | Example: |
| {webhook_caller_ip_address} = 189.172.30.212 | | {webhook_caller_ip_address} = 189.172.30.212 |
− | </pre><br> | + | </pre> |
| | | |
| ==<p><b>Does not require a trigger to operate</b></p>== | | ==<p><b>Does not require a trigger to operate</b></p>== |
Line 243: |
Line 283: |
| {am_pm} | | {am_pm} |
| am or pm depending on the time. | | am or pm depending on the time. |
− | </pre><br> | + | </pre> |
− | | |
| === Android version === | | === Android version === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {android_version} | | {android_version} |
| Returns the number of the android version. | | Returns the number of the android version. |
− | </pre><br> | + | </pre> |
− | | |
| === Android version (SDK level) === | | === Android version (SDK level) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
Line 256: |
Line 294: |
| Returns the SDK level of the Android version. | | Returns the SDK level of the Android version. |
| e.g. Android 14 has an SDK level of 34 | | e.g. Android 14 has an SDK level of 34 |
− | </pre><br> | + | </pre> |
− | | |
| === Battery current now (mA) === | | === Battery current now (mA) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {battery_current_now} | | {battery_current_now} |
| Amount of electrical current flowing from the battery at this moment, measured in milliamps (mA) | | Amount of electrical current flowing from the battery at this moment, measured in milliamps (mA) |
− | </pre><br> | + | </pre> |
− | | |
| === Battery temp ºC=== | | === Battery temp ºC=== |
| | | |
Line 269: |
Line 305: |
| {battery_temp} | | {battery_temp} |
| Temperature in degrees Celsius e.g. 34° | | Temperature in degrees Celsius e.g. 34° |
− | </pre><br> | + | </pre> |
− | | |
| === Cell connection type === | | === Cell connection type === |
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {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. | | cell connection type e.g. 3g, 4g, 5g. |
− | </pre><br> | + | </pre> |
− | | |
| === Cell id === | | === Cell id === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
Line 282: |
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 | | 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) | | e.g. The cell identifier for a cell in New York City could be 310-200-0000. The LAC (310-200) |
− | </pre><br> | + | </pre> |
− | | |
| === Cell tower signal strength === | | === Cell tower signal strength === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {cell_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. | | 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> | + | </pre> |
− | | |
| === Clipboard text === | | === Clipboard text === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {clipboard} | | {clipboard} |
| Gets the text from the clipboard. | | Gets the text from the clipboard. |
− | </pre><br> | + | </pre> |
− | | |
| === Current battery % === | | === Current battery % === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
− | {battery} | + | {battery} |
| + | ({battery_int} for integer variables) |
| Current battery level (numbers only) e.g. '80' | | Current battery level (numbers only) e.g. '80' |
− | </pre><br> | + | </pre> |
− | | |
| === Current brightness === | | === Current brightness === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {current_brightness} | | {current_brightness} |
| Current brightness level (numbers only) e.g. '50' | | Current brightness level (numbers only) e.g. '50' |
− | </pre><br> | + | </pre> |
− | | |
| === Current brightness (Android 9+ alternative) === | | === Current brightness (Android 9+ alternative) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
Line 313: |
Line 343: |
| Current brightness level (numbers only) e.g. '50' | | Current brightness level (numbers only) e.g. '50' |
| alternative method for devices with android 9+ | | alternative method for devices with android 9+ |
− | </pre><br> | + | </pre> |
− | | |
| === Current IP address === | | === Current IP address === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {ip} | | {ip} |
| Current IP in 172.217.12.141 format (randomly generated IP). | | Current IP in 172.217.12.141 format (randomly generated IP). |
− | </pre><br> | + | </pre> |
− | | |
| === Current IP address (V6) === | | === Current IP address (V6) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {ip6} | | {ip6} |
| Current IP in format in 2001:0db8:85a3:0000:0000:8a2e:0370:7334 format (randomly generated IP). | | Current IP in format in 2001:0db8:85a3:0000:0000:8a2e:0370:7334 format (randomly generated IP). |
− | </pre><br> | + | </pre> |
− | | |
| === Current volume (Alarm) === | | === Current volume (Alarm) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {vol_alarm} | | {vol_alarm} |
| Current volume level used for alarms. | | Current volume level used for alarms. |
− | </pre><br> | + | </pre> |
− | | |
| === Current volume (Bluetooth voice) === | | === Current volume (Bluetooth voice) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {vol_bt_voice} | | {vol_bt_voice} |
| Current volume level used for multimedia/calls via Bluetooth. | | Current volume level used for multimedia/calls via Bluetooth. |
− | </pre><br> | + | </pre> |
− | | |
| === Current volume (Media / Music) === | | === Current volume (Media / Music) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {vol_music} | | {vol_music} |
| Current volume level used for multimedia. | | Current volume level used for multimedia. |
− | </pre><br> | + | </pre> |
− | | |
| === Current volume (Notification) === | | === Current volume (Notification) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {vol_notif} | | {vol_notif} |
| Current volume level used for notification alerts. | | Current volume level used for notification alerts. |
− | </pre><br> | + | </pre> |
− | | |
| === Current volume (Ringer) === | | === Current volume (Ringer) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {vol_ring} | | {vol_ring} |
| Current volume level used for ringtone. | | Current volume level used for ringtone. |
− | </pre><br> | + | </pre> |
− | | |
| === Current volume (System sounds) === | | === Current volume (System sounds) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {vol_system} | | {vol_system} |
| Current volume level used for system sounds e.g. screen unlocking and locking, touch sounds among others. | | Current volume level used for system sounds e.g. screen unlocking and locking, touch sounds among others. |
− | </pre><br> | + | </pre> |
− | | |
| === Current volume (Voice call) === | | === Current volume (Voice call) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {vol_call} | | {vol_call} |
| Current volume level used when a call is in progress. | | Current volume level used when a call is in progress. |
− | </pre><br> | + | </pre> |
− | | |
| === Day of the month === | | === Day of the month === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {dayofmonth} | | {dayofmonth} |
| Day of the month, includes 0 at the beginning (days 1 to 9) e.g. 04 or 24. | | Day of the month, includes 0 at the beginning (days 1 to 9) e.g. 04 or 24. |
− | </pre><br> | + | </pre> |
− | | |
| === Day of the week === | | === Day of the week === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {dayofweek} | | {dayofweek} |
| Day of the week, e.g. Monday or Friday. | | Day of the week, e.g. Monday or Friday. |
− | </pre><br> | + | </pre> |
− | | |
| === Device manufacturer === | | === Device manufacturer === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {device_manufacturer} | | {device_manufacturer} |
| Brand name of your device. | | Brand name of your device. |
− | </pre><br> | + | </pre> |
− | | |
| === Device model === | | === Device model === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {device_model} | | {device_model} |
| Model name of your device. | | Model name of your device. |
− | </pre><br> | + | </pre> |
− | | |
| === Device uptime === | | === Device uptime === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {uptime} | | {uptime} |
| Time that the device has been on (this time is reset if the device is restarted) in hour : minute : second. | | Time that the device has been on (this time is reset if the device is restarted) in hour : minute : second. |
− | </pre><br> | + | </pre> |
− | | |
| === Device uptime (s) === | | === Device uptime (s) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {uptime_secs} | | {uptime_secs} |
| Time that the device has been on (this time is reset if the device is restarted) in seconds e.g. 3000s | | Time that the device has been on (this time is reset if the device is restarted) in seconds e.g. 3000s |
− | </pre><br> | + | </pre> |
− | | |
| === Device serial === | | === Device serial === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {} | | {} |
| Not available on android 10+. | | Not available on android 10+. |
− | </pre><br> | + | </pre> |
− | | |
| === Dictionary/Array size === | | === Dictionary/Array size === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
Line 416: |
Line 429: |
| Size of an array or dictionary. | | 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. | | 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> | + | </pre> |
− | | |
| === Foreground app name === | | === Foreground app name === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {fg_app_name} | | {fg_app_name} |
| Name of the application in the foreground, if you are in macrodroid, the output will be MacroDroid. | | Name of the application in the foreground, if you are in macrodroid, the output will be MacroDroid. |
− | </pre><br> | + | </pre> |
− | | |
| === Foreground app package === | | === Foreground app package === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {fg_app_package} | | {fg_app_package} |
| Package of the application in the foreground, if you are in macrodroid, the output will be MacroDroid. | | Package of the application in the foreground, if you are in macrodroid, the output will be MacroDroid. |
− | </pre><br> | + | </pre> |
− | | |
| === Hour of day === | | === Hour of day === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {hour} | | {hour} |
| Time of day in 24h format. | | Time of day in 24h format. |
− | </pre><br> | + | </pre> |
− | | |
| === Hour of day (12h) === | | === Hour of day (12h) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {hour12} | | {hour12} |
| Time of day in 12h format. | | Time of day in 12h format. |
− | </pre><br> | + | </pre> |
− | | |
| === Hour of day (Leanding zero) === | | === Hour of day (Leanding zero) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {hour_0} | | {hour_0} |
| Time of day in 24h format, includes leading zero. | | Time of day in 24h format, includes leading zero. |
− | </pre><br> | + | </pre> |
− | | |
| === IMEI === | | === IMEI === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {imei} | | {imei} |
| Obtains the IMEI number, since Android 10+ this information is no longer available. | | Obtains the IMEI number, since Android 10+ this information is no longer available. |
− | </pre><br> | + | </pre> |
− | | |
| === Language code === | | === Language code === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {language_code} | | {language_code} |
| Language code used e.g. English is 'en' | | Language code used e.g. English is 'en' |
− | </pre><br> | + | </pre> |
− | | |
| === Last known location (accuracy meters) === | | === Last known location (accuracy meters) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {last_loc_accuracy} | | {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. | | 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> | + | </pre> |
− | | |
| === Last known location (altitude) === | | === Last known location (altitude) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {last_loc_alt} | | {last_loc_alt} |
| Gets the altitude above sea level of the last known location. | | Gets the altitude above sea level of the last known location. |
− | </pre><br> | + | </pre> |
− | | |
| === Last known location (lat) === | | === Last known location (lat) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {last_loc_lat} | | {last_loc_lat} |
| Gets the latitude above sea level of the last known location. | | Gets the latitude above sea level of the last known location. |
− | </pre><br> | + | </pre> |
− | | |
| === Last known location (lat,lon) === | | === Last known location (lat,lon) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {last_loc_latlong} | | {last_loc_latlong} |
| Gets the latitude and longitude above sea level of the last known location separated by ',' e.g. 23.44325,-23.215252 | | Gets the latitude and longitude above sea level of the last known location separated by ',' e.g. 23.44325,-23.215252 |
− | </pre><br> | + | </pre> |
− | | |
| === Last known location (link) === | | === Last known location (link) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {last_loc_link} | | {last_loc_link} |
| Gets a Google Maps link with the last known location. | | Gets a Google Maps link with the last known location. |
− | </pre><br> | + | </pre> |
− | | |
| === Last known location (lon) === | | === Last known location (lon) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {last_loc_long} | | {last_loc_long} |
| Gets the longitude above sea level of the last known location. | | Gets the longitude above sea level of the last known location. |
− | </pre><br> | + | </pre> |
− | | |
| === Last known location (time) === | | === Last known location (time) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {last_loc_age_timestamp} | | {last_loc_age_timestamp} |
| Gets the last known time in format (year - month - day hour : minute : second). | | Gets the last known time in format (year - month - day hour : minute : second). |
− | </pre><br> | + | </pre> |
− | | |
| === Last location speed (kmh) === | | === Last location speed (kmh) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {last_loc_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. | | 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> | + | </pre> |
− | | |
| === Last location speed (mph) === | | === Last location speed (mph) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {last_loc_speed_kmh} | | {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. | | 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> | + | </pre> |
− | | |
| === Location area code === | | === Location area code === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {lac} | | {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. | | 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> | + | </pre> |
− | | |
| === Macro category === | | === Macro category === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <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. | | Name of the category of the macro that was invoked, e.g. utilities, maps & navigation, notifications, productivity or custom names, etc. |
− | </pre><br> | + | </pre> |
− | | |
| === Macro id === | | === Macro id === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {macro_id} | | {macro_id} |
| is a GUID number used to uniquely identify a macro file. | | is a GUID number used to uniquely identify a macro file. |
− | </pre><br> | + | </pre> |
− | | |
| === Macro name === | | === Macro name === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {macro_name} | | {macro_name} |
| Name of the macro that was invoked. | | Name of the macro that was invoked. |
− | </pre><br> | + | </pre> |
− | | |
| === Macrodroid is pro === | | === Macrodroid is pro === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {macrodroid_is_pro} | | {macrodroid_is_pro} |
| Boolean value (true or false) depending on whether macrodroid is pro or not. | | Boolean value (true or false) depending on whether macrodroid is pro or not. |
− | </pre><br> | + | </pre> |
− | | |
| === Macrodroid version === | | === Macrodroid version === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {macrodroid_version} | | {macrodroid_version} |
| Version of macrodroid installed for example 5.40.x. | | Version of macrodroid installed for example 5.40.x. |
− | </pre><br> | + | </pre> |
− | | |
| === Minute === | | === Minute === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {minute} | | {minute} |
| Current minute. | | Current minute. |
− | </pre><br> | + | </pre> |
− | | |
| === Mobile country code === | | === Mobile country code === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {mcc} | | {mcc} |
| (MCC) is a three-digit country code used to identify the country of origin of a mobile network. | | (MCC) is a three-digit country code used to identify the country of origin of a mobile network. |
− | </pre><br> | + | </pre> |
− | | |
| === Mobile network code === | | === Mobile network code === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {mnc} | | {mnc} |
| Mobile Network Code (MNC) is a two or three digit code that uniquely identifies a mobile network operator within a country. | | Mobile Network Code (MNC) is a two or three digit code that uniquely identifies a mobile network operator within a country. |
− | </pre><br> | + | </pre> |
− | | |
| === Month === | | === Month === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {month} | | {month} |
| Current month. | | Current month. |
− | </pre><br> | + | </pre> |
− | | |
| === Month (as digit) === | | === Month (as digit) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {month_digit} | | {month_digit} |
| Current month (in numerical format). | | Current month (in numerical format). |
− | </pre><br> | + | </pre> |
− | | |
| === New line === | | === New line === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
Line 587: |
Line 572: |
| Hello | | Hello |
| world | | world |
− | </pre><br> | + | </pre> |
− | | |
| === Power (on/off) === | | === Power (on/off) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
Line 594: |
Line 578: |
| Returns on or off depending on the current power state. | | Returns on or off depending on the current power state. |
| e.g. If the charger is connected the response will be on. | | e.g. If the charger is connected the response will be on. |
− | </pre><br> | + | </pre> |
− | | |
| === RAM (Total) === | | === RAM (Total) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
Line 601: |
Line 584: |
| Returns real value of total RAM (not theoretical) | | 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. | | On a device with 6 GB of RAM, macrodroid will return, for example, 5.79, which is the real value. |
− | </pre><br> | + | </pre> |
− | | |
| === RAM (available) === | | === RAM (available) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {ram_available} | | {ram_available} |
| Returns available RAM value. | | Returns available RAM value. |
− | </pre><br> | + | </pre> |
− | | |
| === Screen resolution === | | === Screen resolution === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {screen_res} | | {screen_res} |
| Device screen resolution (X and Y) separated by ',' e.g. 1080,2400. | | Device screen resolution (X and Y) separated by ',' e.g. 1080,2400. |
− | </pre><br> | + | </pre> |
− | | |
| === Screen resolution (X) === | | === Screen resolution (X) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {screen_res_x} | | {screen_res_x} |
| Device screen resolution (X) using a reference screen X 1080 Y 2400 the output will be 1080. | | Device screen resolution (X) using a reference screen X 1080 Y 2400 the output will be 1080. |
− | </pre><br> | + | </pre> |
− | | |
| === Screen resolution (Y) === | | === Screen resolution (Y) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {screen_res_y} | | {screen_res_y} |
| Device screen resolution (Y) using a reference screen X 1080 Y 2400 the output will be 2400. | | Device screen resolution (Y) using a reference screen X 1080 Y 2400 the output will be 2400. |
− | </pre><br> | + | </pre> |
− | | |
| === Screen timeout (seconds) === | | === Screen timeout (seconds) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| Time that must elapse before the screen turns off (in seconds). | | Time that must elapse before the screen turns off (in seconds). |
− | </pre><br> | + | </pre> |
| === Second === | | === Second === |
| | | |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| Current second. | | Current second. |
− | </pre><br> | + | </pre> |
− | | |
| === Sim operator name === | | === Sim operator name === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {sim_operator_name} | | {sim_operator_name} |
| Name of your telephone company. | | Name of your telephone company. |
− | </pre><br> | + | </pre> |
− | | |
| === Sim 2 operator name === | | === Sim 2 operator name === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {sim2_operator_name} | | {sim2_operator_name} |
| Name of your telephone company in the 2nd sim slot. | | Name of your telephone company in the 2nd sim slot. |
− | </pre><br> | + | </pre> |
− | | |
| === Stopwatches === | | === Stopwatches === |
| * '''''Seconds''''' | | * '''''Seconds''''' |
Line 656: |
Line 631: |
| | | |
| Gets the total stopwatch time in seconds format e.g. 0.0 | | Gets the total stopwatch time in seconds format e.g. 0.0 |
− | </pre><br> | + | </pre> |
| * '''''hh:mm:ss''''' | | * '''''hh:mm:ss''''' |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
Line 663: |
Line 638: |
| | | |
| Obtains the total time of the stopwatch in hour : minute : second format e.g. 00:00:00 | | Obtains the total time of the stopwatch in hour : minute : second format e.g. 00:00:00 |
− | </pre><br> | + | </pre> |
− | | |
| === Storage free (external) === | | === Storage free (external) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {storage_external_free} | | {storage_external_free} |
| Total amount of free space (external) e.g. 136GB. | | Total amount of free space (external) e.g. 136GB. |
− | </pre><br> | + | </pre> |
− | | |
| === Storage free (internal) === | | === Storage free (internal) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {storage_internal_free} | | {storage_internal_free} |
| Total amount of free space (internal) e.g. 136GB. | | Total amount of free space (internal) e.g. 136GB. |
− | </pre><br> | + | </pre> |
− | | |
| === Storage total (external) === | | === Storage total (external) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {storage_external_total} | | {storage_external_total} |
| Actual amount of space on external storage, e.g. On a theoretical 256 GB device the real value can be 221GB. | | Actual amount of space on external storage, e.g. On a theoretical 256 GB device the real value can be 221GB. |
− | </pre><br> | + | </pre> |
− | | |
| === Storage total (internal) === | | === Storage total (internal) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {storage_internal_total} | | {storage_internal_total} |
| Actual amount of space on internal storage, e.g. On a theoretical 256 GB device the real value can be 221GB. | | Actual amount of space on internal storage, e.g. On a theoretical 256 GB device the real value can be 221GB. |
− | </pre><br> | + | </pre> |
− | | |
| === String variable value === | | === String variable value === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {strlen=my_var} | | {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 | | 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> | + | </pre> |
− | | |
| === System setting (Global) === | | === System setting (Global) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
Line 700: |
Line 669: |
| | | |
| Caution: Particular care should be taken when modifying settings, as incorrect changes could affect the functionality or security of the device. | | Caution: Particular care should be taken when modifying settings, as incorrect changes could affect the functionality or security of the device. |
− |
| |
− | Note:
| |
− | Enable the 'Use Helper App' checkbox.
| |
− | Some system settings may be blocked when using the latest Android build tools. By using the helper app which is built against older tools some of these blocked settings may work.
| |
| | | |
| 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. | | 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> | + | </pre> |
− | | |
| === System setting (Secure) === | | === System setting (Secure) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
Line 717: |
Line 681: |
| | | |
| corresponds to the google assistant. | | corresponds to the google assistant. |
− | </pre><br> | + | </pre> |
− | | |
| === System setting (System) === | | === System setting (System) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
Line 726: |
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 | | 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> | + | </pre> |
− | | |
| === System time === | | === System time === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {system_time} | | {system_time} |
| The current time as maintained by your operating system. | | The current time as maintained by your operating system. |
− | </pre><br> | + | </pre> |
− | | |
| === System time (ms) === | | === System time (ms) === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {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). | | 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> | + | </pre> |
− | | |
| === Week of year === | | === Week of year === |
− | </pre><br> | + | </pre><pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
− | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | |
| {week_of_year} | | {week_of_year} |
| Returns the week number of the year, e.g. Wednesday, January 3, week is 1. | | Returns the week number of the year, e.g. Wednesday, January 3, week is 1. |
− | </pre><br> | + | </pre> |
− | | |
| === Webhook Base Url === | | === Webhook Base Url === |
− | </pre><br> | + | </pre><pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
− | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | |
| {webhook_url} | | {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><br> | + | https://trigger.macrodroid.com/6a10aa17-75cd-4856-9d71-84281205a320/mywebhook |
− | | + | </pre> |
| === Wifi SSID === | | === Wifi SSID === |
− | </pre><br> | + | </pre><pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
− | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | |
| {ssid} | | {ssid} |
| Name of the Wi-Fi network you are connected to. | | Name of the Wi-Fi network you are connected to. |
− | </pre><br> | + | </pre> |
− | | |
| === Wifi signal strength === | | === Wifi signal strength === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {wifi_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. | | 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> | + | </pre> |
− | | |
| === Year === | | === Year === |
| <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> |
| {year} | | {year} |
| Current year. | | Current year. |
− | </pre><br> | + | </pre> |