DemoAPK

DemoAPk is a tool for modifying and editing the APK package name that has been decoded by APKEditor and includes a patcher for editing binary files.

Overview

DemodAPK is a Python-based tool designed to modify decompiled APK files. It enables developers to:

• Update Facebook App credentials (App ID, Client Token, Login Protocol Scheme).
• Rename package names in the APK manifest and associated files.
• Apply binary patches and remove metadata.

Features

• Package Renaming: Easily rename package names in APK files.
• Resource Modification: Modify resources in APK files as needed.
• Facebook API Updates: Automatically replaces Facebook App details in the appropriate XML files.
• Metadata Adjustment: Update application metadata in the AndroidManifest.xml file.
• Configurable Settings: Store and manage settings in a JSON configuration file.
• For educational purposes: You're learning how APK files work or exploring reverse engineering ethically.

Requirements

• Python 3.x
• Necessary libraries specified in requirements.txt

Installation

1. Clone the repository:

   git clone https://github.com/Veha0001/DemodAPK.git
   cd DemodAPK

2. Install the required libraries:

   pip install -r requirements.txt

Usage

Run the script with the following command:

python autogen.py --config <path_to_config.json> <apk_directory/apk_file>

Patcher

Performance Notice

The patcher.py file may work slowly when performing wildcard scans. If you want to run it faster, consider using the C++ version.

You may want to checkout BinaryPatch built with Rust. For patcher.cpp will be discontinue for now..

Building the C++ Version

To build the C++ version, you will need to have g++ or gcc installed, along with the nlohmann-json library. You can build it using the following command:

g++ -o patcher patcher.cpp -O2

Note

Edit by method_name may work on some dump.cs file. The dump.cs file is get from Il2CppDumper.

Example

This is a config.json example file:

{
  "DemodAPK": {
    "com.overpower.game": {
      "log": true,
      "dex": true,
      "command": {
        "editor_jar": "~/.local/bin/APKEditor*.jar",
        "begin": [
          "./Patcher"
        ],
        "end": [
          "apksigner sign --key ~/.Keys/mine.pk8 --cert ~/.Keys/mine.x509.pem src/Game/*.apk"
        ]
      },
      "level": 0,
      "package": "com.yes.game",
      "facebook": {
        "app_id": "0000000000000",
        "client_token": "dj2025id828018ahzl11",
        "login_protocol_scheme": "fb0000000000000"
      },
      "files": [
        {
          "replace": {
            "keep": false,
            "from": "./src/libil2cpp_patched.so",
            "to": "root/lib/arm64-v8a/libil2cpp.so"
          }
        }
      ],
      "manifest": {
        "remove_metadata": [
          "com.google.android.gms.games.APP_ID"
        ]
      }
    }
  },
  "Patcher": {
    "input_file": "apkdir/root/lib/arm64-v8a/libil2cpp.so",
    "dump_file": "dump.cs",
    "output_file": "libil2cpp_patched.so",
    "patches": [
      {
        "method_name": "UnlockAll",
        "hex_code": "20 00 80 D2 C0 03 5F D6"
      },
      {
        "offset": "0x111111",
        "hex_code": "1F 20 03 D5"
      },
      {
        "wildcard": "AA DD F5 ?? ?? ?? 00 01",
        "hex_code": "00 E0 AF D2 C0 03 5F D6"
      }
    ]
  }
}

Follow the prompts to select the APK file and modify its contents according to your preferences.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or features.