LogoOctoclip Docs
    ▾

    Background Monitoring with Root

    Not sure which method to use? Compare Shizuku / Accessibility / Root in the quick enable guide.

    This guide will help Rooted users enable clipboard background monitoring by installing LSPosed and the Clipboard Whitelist module.

    Prerequisites

    Required conditions

    • Device must be Rooted and have Magisk v24.0 or higher installed
    • Zygisk must be enabled in Magisk settings
    • This app must be installed

    Install the “LSPosed” Framework

    Download the framework

    Download only from the official Releases page and verify the source

    Only download LSPosed from its official GitHub Releases page. Do not use mirrored or cached copies from unknown sites. Verify file integrity before installing.

    Download from the LSPosed GitHub Releases page (always use the latest release).

    Install the framework

    1. Open the Magisk app
    2. Switch to the Modules tab
    3. Tap Install from storage, then select the downloaded LSPosed .zip file
    4. Wait for the installation to complete, then tap Reboot

    Install the “Clipboard Whitelist” Module

    Download the module

    The Clipboard Whitelist module must match your LSPosed API version — LSPosed introduced a new libxposed API 101, and the two builds are not interchangeable. Pick the matching one:

    Your LSPosedModule to download
    API 101+ — the latest, which this guide installsMaintained fork (hxreborn)
    An older LSPosed you kept on purposeOriginal module

    Because this guide installs the latest LSPosed, use the fork. Always grab the latest release from the chosen page.

    Download only from the official Releases page and verify the source

    Do not install APKs from unofficial mirrors or cached links, and verify file integrity before installing.

    Enable the module

    Once installed, go to the Modules page in the LSPosed manager and enable the module.

    Configure the App Whitelist

    1. Open the Clipboard Whitelist app
    2. Find and check 章鱼速贴（Octoclip）

    App list permission notice

    If the app list is not displayed in Clipboard Whitelist, you need to:

    • Go to System Settings → App Management → Clipboard Whitelist → Permissions
    • Enable Get app list or Read app info permission

    Reboot and Verify

    1. Reboot your device to apply the configuration
    2. Open this app
    3. Switch to any other app and copy some text
    4. Return to the app and check if it automatically captured the clipboard content

    FAQ

    Q: The module is installed but not working?

    A: Please check the following:

    1. Confirm Zygisk is enabled and the device has been restarted
    2. Ensure the Clipboard Whitelist module is enabled in LSPosed Manager
    3. Verify 章鱼速贴（Octoclip） is selected in two places:
      • LSPosed module scope
      • Clipboard Whitelist app
    4. Try clearing the app’s data and reconfiguring it
    5. Ensure the app has clipboard access permission

    Q: LSPosed installation failed?

    Possible causes:

    • Magisk version too low (requires v24.0+)
    • Zygisk not properly enabled

    Solution:

    1. Update Magisk to the latest version
    2. Re-enable Zygisk and fully reboot the device

    Q: LSPosed icon not showing?

    Steps to fix:

    1. After installing the Clipboard Whitelist APK, tap the prompt to open the LSPosed module
    2. Inside LSPosed, switch to the Settings tab
    3. Tap Create shortcut to add the LSPosed icon to your home screen

    Q: Clipboard Whitelist not showing app list?

    Solution:

    1. Open System Settings → App Management → Clipboard Whitelist
    2. Tap Permission Management
    3. Enable Get app list or Read app info permission
    4. Relaunch the Clipboard Whitelist app
    Was this page helpful?