| Line 3: |
Line 3: |
| | </pre> | | </pre> |
| | | | |
| − | Requires additional configuration on Android 10 and above. This limitation is due to Google blocking clipboard access from background applications since Android 10.
| + | ''' Options ''' |
| | | | |
| − | '''Configuration 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 |
| | | | |
| − | * Regular expression matching | + | * '''Enable Regex''' - Enable regular expression matching for advanced pattern matching of clipboard content. |
| | | | |
| − | 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''' - When checked, ignores the use of upper and lower case when matching. This option is disabled when regex mode is enabled. |
| | | | |
| − | * Case insensitive | + | * '''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. |
| | | | |
| − | It will ignore the use of upper and lower case in title and detail.
| + | ''' Examples ''' |
| | | | |
| − | * Use logcat (ADB Hack)
| + | Example 1: Speak clipboard content when copied |
| | | | |
| − | Standard clipboard access is not possible on Android 10+ unless you have a rooted device with appropriate Magisk modules. As a workaround MacroDroid can monitor the device's logcat output to try and detect when new content appears in the clipboard.
| + | <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:_Set_Clipboard|Set Clipboard Action]] |
| | + | * [[Action:_Clear_Clipboard|Clear Clipboard Action]] |