| Line 1: |
Line 1: |
| − | This trigger is not available on Android 10 and above. This limitation is due to Google blocking access to the clipboard from background apps since Android 10. | + | <pre class="header-style"> |
| | + | This trigger will fire when the value stored in the clipboard is updated. |
| | + | </pre> |
| | | | |
| − | When new text is copied, it is saved to clipboard. This trigger will fire when this event occurs.
| + | ''' 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 |
| | | | |
| − | The following magic text is available when this trigger fires.
| + | * '''Enable Regex''' - Enable regular expression matching for advanced pattern matching of clipboard content. |
| | | | |
| − | [clipboard] - the text in the clipboard. | + | * '''Case Insensitive''' - When checked, ignores the use of upper and lower case when matching. This option is disabled when regex mode is enabled. |
| | + | |
| | + | * '''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 ''' |
| | + | |
| | + | Example 1: Speak clipboard content when copied |
| | + | |
| | + | <pre class="trigger-style">Triggers |
| | + | |
| | + | 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> |
| | + | |
| | + | ''' Notes ''' |
| | + | |
| | + | * On Android 10 and later, Google restricted background clipboard access. To use this trigger on Android 10+, you need one of the following: |
| | + | ** Root access with appropriate Magisk modules |
| | + | ** Enable the "Use Logcat (ADB Hack)" option and grant READ_LOGS permission via ADB |
| | + | ** Enable the UI Interaction accessibility service (allows reading clipboard when MacroDroid is in the foreground) |
| | + | * 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> |
| | + | |
| | + | ''' Permissions Required ''' |
| | + | |
| | + | * READ_LOGS (only for logcat method on Android 10+) |
| | + | * Draw Over Other Apps (for logcat method) |
| | + | |
| | + | ''' See Also ''' |
| | + | |
| | + | * [[Action:_Fill_Clipboard|Fill Clipboard Action]] |