Difference between revisions of "Trigger: Screen content"

(Added example)
 
(One intermediate revision by the same user 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>==
  
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).
+
=== 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>
 
</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.''
Screen Content (On Screen) : https://* : WhatsApp
 
  
</pre><br>
+
=== Match Option ===
<pre style="background-color: #1665B0; color: white; border-radius: 10px; padding: 10px;">
 
Actions
 
Speak Text : 'Link detected'
 
  
</pre><br>
+
* ''''' Text content:'''''
<pre style="background-color: green; color: white; border-radius: 10px; padding: 10px;">
+
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
Constraints
+
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: teal; color: white; border-radius: 10px; padding: 10px;">
 
Local variables
 
  
 +
<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 ===
 +
 
 +
* '''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>

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.