Difference between revisions of "Trigger: Clipboard Change"
(Created page with "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. When new text...") |
|||
| (9 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | This trigger | + | <pre class="header-style"> |
| + | 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. | |
| − | [clipboard] - the | + | * '''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]] | ||
Latest revision as of 22:23, 5 January 2026
This trigger will fire when the value stored in the clipboard is updated.
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.
- 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
Triggers Clipboard Change [Any]
Actions Speak Text: [clipboard]
Example 2: Open URL when web address is copied
Triggers Clipboard Change [Text: http*]
Actions Open URL: [clipboard]
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:
adb shell pm grant com.arlosoft.macrodroid android.permission.READ_LOGS
Permissions Required
- READ_LOGS (only for logcat method on Android 10+)
- Draw Over Other Apps (for logcat method)
See Also