Home

Hook Module

HookModule - Advanced User Guide

HookModule: Advanced User Guide

Welcome to HookModule, a powerful and flexible tool to dynamically bypass signature verification for Android applications. This guide covers its advanced features, including the user interface that allows for on-the-fly configuration without editing code.

Key Features

  • Dynamic UI Configuration: Set your target applications and import signatures directly from the app's user interface. No need to re-build the module for every change.
  • Multi-App Targeting: Target multiple applications simultaneously by providing a comma-separated list of their package names.
  • On-the-fly Signature Import: Use the built-in file picker to select any APK and use its signature for the bypass operation.
  • Status Indicator: The UI provides instant feedback on whether a signature has been successfully loaded and is ready to be used.

Prerequisites

  • A rooted Android device with Magisk installed.
  • The LSPosed Framework installed and activated via Magisk Manager.

Step 1: Install and Activate the Module

  1. Install the compiled HookModule.apk on your rooted device.
  2. Open the LSPosed Manager app.
  3. Navigate to the "Modules" tab.
  4. Find "HookModule" in the list and enable it using the toggle switch.
  5. Tap on "HookModule" to set its scope. In the list of applications, check the box for "Android System" (package name: android) only. This is crucial for the hook to work.
  6. Reboot your device. This step is mandatory for LSPosed to load the module into the system process.

Step 2: Configure the Module via the App Interface

After rebooting, your module is active but not yet targeting any app. You must configure it through the app's user interface.

  1. Open the "HookModule" app from your app launcher.
  2. Enter Target Package Names:
    • In the text field at the top, enter the package name(s) of the application(s) you want to target.
    • To target multiple apps, separate their package names with a comma.
      Example: com.app1.example,com.app2.test,com.game.fun
  3. Import a Signature:
    • Tap the "Import Signature from APK" button.
    • Your system's file picker will open. Navigate to and select an APK file whose signature you want to use.
    • After a successful import, the status text below the button will change to "Signature status: Loaded".
  4. Save Settings:
    • Once you have entered the package names and imported a signature, tap the "Save Settings" button.
    • A confirmation message ("Settings saved successfully!") will appear. Your configuration is now active.

Step 3: Usage and Verification

Your module is now fully configured and active.

  1. Take a modified version of one of your target applications (an APK signed with a different key than the original).
  2. Try to install this modified APK on your device.
  3. The installation should complete successfully without any "signature mismatch" errors.
  4. Verification (Optional): You can check the logs in the LSPosed Manager. When the signature check is bypassed for a target app, a message like HookModule: Successfully bypassed signature for -> com.app1.example will appear in the log.