Difference between revisions of "Trigger: Screen content"
| Line 1: | Line 1: | ||
| + | ===<p><b>About</b></p>=== | ||
| + | |||
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | ||
This trigger will fire when certain textual content appears on screen or is removed (as configured). | This trigger will fire when certain textual content appears on screen or is removed (as configured). | ||
| + | </pre> | ||
| + | '''''Note''''' | ||
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | ||
| + | That this trigger may not work for all apps/screen content as often text will be non-readable (for example if rendered within a game). | ||
| + | </pre> | ||
| + | |||
| + | ==<p><b>Supported configurations</b></p>== | ||
| + | |||
| + | === Applications === | ||
| + | |||
| + | * ''''' For optimal performance please select specific applications and do not use the 'All Applications' option.''''' | ||
| + | |||
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | ||
| + | Select one or more applications to search for content on the screen. | ||
| + | </pre> | ||
| + | |||
| + | * ''''' On Screen:''''' ''Only IF Text/ID is present on the display.'' | ||
| + | * ''''' Off Screen:''''' ''Only NO Text/ID is present on the screen.'' | ||
| + | |||
| + | === Match Option === | ||
| + | |||
| + | * ''''' Text content:''''' | ||
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | ||
| + | It will search for the match by text. | ||
| + | </pre> | ||
| + | |||
| + | * ''''' View id:''''' | ||
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | ||
| + | Find the match by identifier, you can find the ids with actions e.g. Read Screen Content, Check Text To Screen. | ||
| + | </pre> | ||
| + | '' See also: '' [[Action: Read Screen Contents|Read Screen Contents]], [[Action: Check Text On Screen|Check Text To Screen]].'' | ||
| + | |||
| + | === Text to match === | ||
| + | |||
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | ||
| + | Text to match, supports the use of wildcards and magic text. | ||
| + | </pre> | ||
| + | '' See also: '' [[magic text|Magic Text]].'' | ||
| + | |||
| + | === Checkbox === | ||
| + | |||
| + | * '''Enable regular expression matching''' | ||
| + | |||
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | ||
| + | Regular expression matching (or regex matching) is a technique for finding patterns within text using a specialized syntax known as regular expressions. | ||
| + | It's a powerful tool for text processing and pattern recognition. | ||
| + | </pre> | ||
| + | |||
| + | * '''''Case insensitive''''' | ||
| + | |||
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | ||
| + | It will ignore the use of upper and lower case in title and detail. | ||
| + | </pre> | ||
| + | |||
| + | * '''''Include overlays (Pro Only)''''' | ||
| − | + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | |
| + | An overlay is like an additional layer that is placed on top of other applications on your device. | ||
| + | It can be a pop-up window, a banner or even a small icon. | ||
| + | </pre> | ||
| + | |||
| + | === Read Screen Update Rate === | ||
| + | ''The frequency that the device will query the screen contents.<br> | ||
| + | With intervals of 0.1 sec up to a maximum of 5 sec.''<br> | ||
| + | '''''More frequent updates may cause higher battery drain.''''' | ||
| + | |||
| + | * '''''Don't read when MacroDroid is open''''' | ||
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | ||
| + | Enabling this option will prevent reading the screen contents when MacroDroid is the foreground app. | ||
| + | This can prevent laggy behaviour when using the app. | ||
</pre> | </pre> | ||
Latest revision as of 22:32, 25 January 2024
About
This trigger will fire when certain textual content appears on screen or is removed (as configured).
Note
That this trigger may not work for all apps/screen content as often text will be non-readable (for example if rendered within a game).
Supported configurations
Applications
- For optimal performance please select specific applications and do not use the 'All Applications' option.
Select one or more applications to search for content on the screen.
- On Screen: Only IF Text/ID is present on the display.
- Off Screen: Only NO Text/ID is present on the screen.
Match Option
- Text content:
It will search for the match by text.
- View id:
Find the match by identifier, you can find the ids with actions e.g. Read Screen Content, Check Text To Screen.
See also: Read Screen Contents, Check Text To Screen.
Text to match
Text to match, supports the use of wildcards and magic text.
See also: Magic Text.
Checkbox
- Enable regular expression matching
Regular expression matching (or regex matching) is a technique for finding patterns within text using a specialized syntax known as regular expressions. It's a powerful tool for text processing and pattern recognition.
- Case insensitive
It will ignore the use of upper and lower case in title and detail.
- Include overlays (Pro Only)
An overlay is like an additional layer that is placed on top of other applications on your device. It can be a pop-up window, a banner or even a small icon.
Read Screen Update Rate
The frequency that the device will query the screen contents.
With intervals of 0.1 sec up to a maximum of 5 sec.
More frequent updates may cause higher battery drain.
- Don't read when MacroDroid is open
Enabling this option will prevent reading the screen contents when MacroDroid is the foreground app. This can prevent laggy behaviour when using the app.