Difference between revisions of "Trigger: Screen content"

m
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<pre style="background-color: #EEEEEE; color: Black; border-radius: 10px; padding: 10px;">
+
===<p><b>About</b></p>===
 +
 
 +
<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.'''''
  
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).
+
<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>
 
</pre>
<br>
 
'''Example Usage'''<br/>
 
  
<pre style="background-color: #AC2424; color: white; border-radius: 10px; padding: 10px;">
+
* ''''' On Screen:''''' ''Only IF Text/ID is present on the display.''
Triggers
+
* ''''' Off Screen:''''' ''Only NO Text/ID is present on the screen.''
  
 +
=== Match Option ===
  
</pre><br>
+
* ''''' Text content:'''''
<pre style="background-color: #1665B0; color: white; border-radius: 10px; padding: 10px;">
+
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
Actions
+
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]].''
  
</pre><br>
+
=== Text to match ===
<pre style="background-color: green; color: white; border-radius: 10px; padding: 10px;">
 
Constraints
 
  
 +
<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]].''
  
</pre><br>
+
=== Checkbox ===
<pre style="background-color: teal; color: white; border-radius: 10px; padding: 10px;">
 
Local variables
 
  
 +
* '''Enable regular expression matching'''
  
</pre><br>
+
<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>

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.