Changes

no edit summary
Line 1: Line 1: −
<pre style="background-color: #EEEEEE; color: Black; border-radius: 10px; padding: 10px;">
+
<pre class="header-style">
This trigger requires additional configuration on Android 10 and above. This limitation is due to Google blocking clipboard access from background applications since Android 10.
+
This trigger will fire when the value stored in the clipboard is updated.
 +
</pre>
 +
 
 +
''' Options '''
 +
 
 +
* '''Text to Match''' - Enter text to match against the clipboard content. Leave blank to trigger on any clipboard change.
 +
** Supports wildcards (e.g., * for any characters)
 +
** Supports Magic Text variables
 +
 
 +
* '''Enable Regex''' - Enable regular expression matching for advanced pattern matching of clipboard content.
   −
Warning: It stopped working completely for android 13 and higher.
+
* '''Case Insensitive''' - When checked, ignores the use of upper and lower case when matching. This option is disabled when regex mode is enabled.
   −
When new text is copied, it is saved to the clipboard. This trigger will be activated when this event occurs.
+
* '''Use Logcat (ADB Hack)''' - On Android 10+, standard clipboard access is not possible in the background unless you have a rooted device with appropriate Magisk modules. MacroDroid can monitor logcat output to help detect new clipboard content as a workaround for unrooted devices. This option requires granting the READ_LOGS permission via ADB.
    +
''' Examples '''
   −
The following magic text is available when this trigger fires.
+
Example 1: Speak clipboard content when copied
   −
[Clipboard] - the text in the clipboard.
+
  <pre class="trigger-style">Triggers
</pre>
+
 
 +
Clipboard Change [Any]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Speak Text: [clipboard]</pre>
 +
 
 +
Example 2: Open URL when web address is copied
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Clipboard Change [Text: http*]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Open URL: [clipboard]</pre>
   −
'''Example Usage'''<br/>
+
''' Notes '''
If the clipboard receives the value containing code it will try to get the code from 4 to 10 digits and fill the clipboard only with the code.
  −
<pre style="background-color: red; color: white; border-radius: 10px; padding: 10px;">
  −
Triggers
     −
Clipboard change (code)
+
* On Android 10 and later, Google restricted background clipboard access. To use this trigger on Android 10+, you need one of the following:
*Enable regular expression matching
+
** Root access with appropriate Magisk modules
</pre><br>
+
** Enable the "Use Logcat (ADB Hack)" option and grant READ_LOGS permission via ADB
<pre style="background-color: #1665B0; color: white; border-radius: 10px; padding: 10px;">
+
** Enable the UI Interaction accessibility service (allows reading clipboard when MacroDroid is in the foreground)
Actions
+
* The logcat method requires the "Draw Over Other Apps" permission for proper operation.
 +
* When using the logcat method, you must grant permission via ADB with the command: <code>adb shell pm grant com.arlosoft.macrodroid android.permission.READ_LOGS</code>
   −
Clipboard refresh
+
''' Permissions Required '''
Text manipulation [Extract text ([Clipboard] \d{4,10}
  −
Fill clipboard [lv-code]
  −
</pre><br>
  −
<pre style="background-color: green; color: white; border-radius: 10px; padding: 10px;">
  −
Constrains
      +
* READ_LOGS (only for logcat method on Android 10+)
 +
* Draw Over Other Apps (for logcat method)
   −
</pre><br>
+
''' See Also '''
<pre style="background-color: teal; color: white; border-radius: 10px; padding: 10px;">
  −
Local variables
     −
SMS CODE [String]
+
* [[Action:_Fill_Clipboard|Fill Clipboard Action]]
</pre><br>