|
|
| Line 2: |
Line 2: |
| | </pre> | | </pre> |
| | <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);"> |
| − |
| |
| − | == 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.
| |
| − |
| |
| − | === Magic Text Syntax ===
| |
| − |
| |
| − | Magic text for dictionaries/arrays is written like this:
| |
| − |
| |
| − | <pre style="background-color: #e9e9e9; border-radius: 5px; padding: 10px;">
| |
| − | {lv=dictionary/array name[entry][sub-entry]}
| |
| − | </pre>
| |
| − |
| |
| − | There can be as many [sub-entry] as you like. Be aware that this can get complicated very quickly! Curly `{}` braces have been added so that users can easily see the beginning and end of a dictionary/array magic text.
| |
| − |
| |
| − |
| |
| − | </div>
| |
| − |
| |
| − |
| |
| − |
| |
| − | {| 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%;" | am/pm
| |
| − | |-
| |
| − | | Magic text || {am_pm}
| |
| − | |-
| |
| − | | Description || am or pm depending on the time.
| |
| − | |-
| |
| − | | 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%;" | Android version
| |
| − | |-
| |
| − | | Magic text || {android_version}
| |
| − | |-
| |
| − | | Description || Returns the number of the android version.
| |
| − | |-
| |
| − | | 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%;" | Android version (SDK level)
| |
| − | |-
| |
| − | | Magic text || {android_version_sdk}
| |
| − | |-
| |
| − | | Description || Returns the SDK level of the Android version. e.g. Android 15 has an SDK level of 35.
| |
| − | |-
| |
| − | | 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%;" | Battery current now (mA)
| |
| − | |-
| |
| − | | Magic text || {battery_current_now}
| |
| − | |-
| |
| − | | Description || Amount of electrical current flowing from the battery at this moment, measured in milliamps (mA).
| |
| − | |-
| |
| − | | 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%;" | Battery temp ºC
| |
| − | |-
| |
| − | | Magic text || {battery_temp}
| |
| − | |-
| |
| − | | Description || Temperature in degrees Celsius, e.g. 34°.
| |
| − | |}
| |
| − |
| |
| − | {| 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%;" | Cell connection type
| |
| − | |-
| |
| − | | Magic text || {cell_connection}
| |
| − | |-
| |
| − | | Description || Cell connection type, e.g. 3G, 4G, 5G.
| |
| − | |}
| |
| − |
| |
| − | {| 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%;" | Cell id
| |
| − | |-
| |
| − | | Magic text || {cell_id}
| |
| − | |-
| |
| − | | 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)
| |
| − | |}
| |
| − |
| |
| − | {| 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%;" | Cell tower signal strength
| |
| − | |-
| |
| − | | Magic text || {cell_signal_strength}
| |
| − | |-
| |
| − | | 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.
| |
| − | |}
| |
| − |
| |
| − | {| 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%;" | Clipboard text
| |
| − | |-
| |
| − | | Magic text || {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].
| |
| − | |}
| |
| − |
| |
| − | {| 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%;" | Current battery %
| |
| − | |-
| |
| − | | Magic text || {battery}
| |
| − | |-
| |
| − | | Description || Information on the current battery charge percentage, e.g. 80%.
| |
| − | |-
| |
| − | | 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%;" | Current Brightness
| |
| − | |-
| |
| − | | Magic text || {current_brightness}
| |
| − | |-
| |
| − | | Description || Information on the current brightness, e.g. 100.
| |
| − | |-
| |
| − | | 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%;" | Current Brightness (alternative Android 9)
| |
| − | |-
| |
| − | | Magic text || {current_brightness_alternative}
| |
| − | |-
| |
| − | | Description || Information on the current brightness, e.g. 100.
| |
| − | |-
| |
| − | | 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%;" | Current IP address
| |
| − | |-
| |
| − | | Magic text || {ip}
| |
| − | |-
| |
| − | | Description || Current IP in 172.217.12.141 format (randomly generated IP).
| |
| − | |-
| |
| − | | 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%;" | Foreground app
| |
| − | |-
| |
| − | | Magic text || {fg_app_name}
| |
| − | |-
| |
| − | | Description || Name of the application in the foreground, for example, Macrodroid.
| |
| − | |-
| |
| − | | 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%;" | Foreground package
| |
| − | |-
| |
| − | | Magic text || {fg_app_package}
| |
| − | |-
| |
| − | | Description || Package of the application in the foreground, for example, com.arlosoft.macrodroid.
| |
| − | |-
| |
| − | | 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%;" | New Line
| |
| − | |-
| |
| − | | Magic text || \n
| |
| − | |-
| |
| − | | Description || (Does not require { } or [ ]). It is a special character that marks the end of a line of text and the beginning of a new line. It is used to organize text into a readable and easy-to-read format.
| |
| − | For example, Hello world, the output would look like this:
| |
| − | Hello
| |
| − | world.
| |
| − | |-
| |
| − | | Does it require a trigger? || No
| |
| − | |}
| |