Line 1: |
Line 1: |
| + | <div style="border-radius: 10px; background-color: #f4f4f4; padding: 20px; box-shadow: 0px 4px 6px rgba(0, 0, 0, 0.1);"> |
| + | |
| + | == Magic Text Overview == |
| + | |
| + | Many triggers, actions, and constraints allow you to configure some text fields. Often, you will find a button next to the text input field that contains the "..." label. This button displays a complete list of "magic text" fields available in the context you are using. |
| + | |
| + | If you want to type them manually instead, if you know them, be aware that there may be spelling/typing errors. |
| + | |
| + | === How Magic Text Works === |
| + | |
| + | The magic text allows a different value to be substituted at the point of call, instead of the standard static text that never changes. For example, it's possible to add an action that references a variable via magic text, and that variable's value will be substituted at the point the action is executed. |
| + | |
| + | === Magic Text Formats === |
| + | |
| + | Magic text can be written in two ways: |
| + | * Curly braces: {value} |
| + | * Square braces: [value] |
| + | |
| + | Curly brackets are not supported on very old versions like v5.20 and below, but it's recommended to use them when interacting with dictionaries/arrays, as square brackets can get confusing very quickly. |
| + | |
| <div style="border-radius: 10px; background-color: #f4f4f4; padding: 20px; box-shadow: 0px 4px 6px rgba(0, 0, 0, 0.1);"> | | <div style="border-radius: 10px; background-color: #f4f4f4; padding: 20px; box-shadow: 0px 4px 6px rgba(0, 0, 0, 0.1);"> |
| | | |
Line 68: |
Line 88: |
| |- | | |- |
| | Does it require a trigger? || No | | | Does it require a trigger? || No |
| + | |} |
| + | |
| + | {| class="wikitable" style="width:100%; text-align:left; border:none; background-color:#f2f2f2; border-radius: 10px; border: 1px solid #ddd;" |
| + | |- |
| + | ! style="background-color:#1665B0; color:white; width:50%;" | Name |
| + | ! style="background-color:#1665B0; color:white; width:50%;" | Application name |
| + | |- |
| + | | Magic text || {app_name} |
| + | |- |
| + | | Description || Gets the name of the application that was opened or closed according to the context. |
| + | |- |
| + | | Does it require a trigger? || Yes, it requires an Application Launched/Closed trigger to be present. |
| + | |} |
| + | |
| + | {| class="wikitable" style="width:100%; text-align:left; border:none; background-color:#f2f2f2; border-radius: 10px; border: 1px solid #ddd;" |
| + | |- |
| + | ! style="background-color:#1665B0; color:white; width:50%;" | Name |
| + | ! style="background-color:#1665B0; color:white; width:50%;" | Application package |
| + | |- |
| + | | Magic text || {app_package} |
| + | |- |
| + | | Description || Gets the name of the application that was opened or closed according to the context. |
| + | |- |
| + | | Does it require a trigger? || Yes, it requires an Application Launched/Closed trigger to be present. |
| |} | | |} |
| | | |
Line 90: |
Line 134: |
| |- | | |- |
| | Description || Temperature in degrees Celsius, e.g. 34°. | | | Description || Temperature in degrees Celsius, e.g. 34°. |
| + | |- |
| + | | Does it require a trigger? || No |
| + | |} |
| + | |
| + | {| class="wikitable" style="width:100%; text-align:left; border:none; background-color:#f2f2f2; border-radius: 10px; border: 1px solid #ddd;" |
| + | |- |
| + | ! style="background-color:#1665B0; color:white; width:50%;" | Name |
| + | ! style="background-color:#1665B0; color:white; width:50%;" | Bluetooth device name |
| + | |- |
| + | | Magic text || {bluetooth_device_name} |
| + | |- |
| + | | Description || Returns the name of the bluetooth device, may be more useful when using the "Any device" option. |
| + | |
| + | For example, if headphones are connected, it will return the device name. |
| + | {bluetooth_device_name} = Headphones 1 Pro |
| + | |- |
| + | | Does it require a trigger? || Requires a Bluetooth trigger (device connected or device disconnected) to be present. |
| |} | | |} |
| | | |
Line 100: |
Line 161: |
| |- | | |- |
| | Description || Cell connection type, e.g. 3G, 4G, 5G. | | | Description || Cell connection type, e.g. 3G, 4G, 5G. |
| + | |- |
| + | | Does it require a trigger? || No |
| |} | | |} |
| | | |
Line 111: |
Line 174: |
| | Description || 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 | | | Description || 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) |
| + | |- |
| + | | Does it require a trigger? || No |
| |} | | |} |
| | | |
Line 121: |
Line 186: |
| |- | | |- |
| | Description || Returns the signal strength that your mobile device is receiving from the nearest cell tower. It is expressed in units called decibels-milliwatts (dBm), with -50 dBm being the strongest signal and -110 dBm being the weakest. | | | Description || Returns the signal strength that your mobile device is receiving from the nearest cell tower. It is expressed in units called decibels-milliwatts (dBm), with -50 dBm being the strongest signal and -110 dBm being the weakest. |
| + | |- |
| + | | Does it require a trigger? || No |
| |} | | |} |
| | | |
Line 132: |
Line 199: |
| | Description || Retrieves the text from the clipboard. | | | Description || Retrieves the text from the clipboard. |
| If you are on Android 10+ you should have a look at the [https://macrodroidforum.com/wiki/index.php/Action:_Clipboard_Refresh Refresh Cliboard action]. | | If you are on Android 10+ you should have a look at the [https://macrodroidforum.com/wiki/index.php/Action:_Clipboard_Refresh Refresh Cliboard action]. |
| + | |- |
| + | | Does it require a trigger? || No |
| |} | | |} |
| | | |
Line 219: |
Line 288: |
| |- | | |- |
| | Does it require a trigger? || No | | | Does it require a trigger? || No |
| + | |} |
| + | |
| + | {| class="wikitable" style="width:100%; text-align:left; border:none; background-color:#f2f2f2; border-radius: 10px; border: 1px solid #ddd;" |
| + | |- |
| + | ! style="background-color:#1665B0; color:white; width:50%;" | Name |
| + | ! style="background-color:#1665B0; color:white; width:50%;" | Application Launched/Closed |
| + | |- |
| + | | Magic text || {app_name} |
| + | |- |
| + | | Gets the name of the application that was opened or closed according to the context. |
| + | |- |
| + | | Does it require a trigger? || Yes, it requires an Application Launched/Closed trigger to be present. |
| |} | | |} |