Skip to main content

A command-line tool for in-depth APK signature and keystore analysis.

Project description

SigTool: APK Signature and Keystore Analyzer Pro


Overview

SigTool is a command-line tool designed to in-depth APK signature and keystore analysis and related information. It provides various functionalities such as extracting APK metadata, signature hashes, CRC32 and HashCode values, generating Base64 and PEM encoded certificates, and more.


Features

  • APK Information Extraction: Extract essential details like app name, package name, version name, and build code from an APK file.

  • Signature Extraction: Retrieve the certificate bytes in hex string format from APK file, RSA file and x509 certificate.

    • To extract an x509 certificate from your keystore, you can check out our second tool, KeySigner.
  • Hash Calculations: Generates and displays a wide range of cryptographic hash values such as SHA-1, SHA-224, SHA-256, SHA-356, SHA-512, MD5 from the extracted certificate.

  • CRC32 and HashCode Calculation: Compute CRC32 and Java-style HashCode from the extracted certificate.

  • Smali Bytecode Generation: Convert the extracted certificate into a smali byte array format.

  • Base64 Encoding: Encode signatures and hashes in Base64.

  • PEM Certificate Parsing: Create and display PEM formatted certificates from the extracted certificate.

  • Colon and Uppercase Formatting: Format hashes with colons and convert to uppercase.

  • File Handling Capabilities: Manages file outputs efficiently, allowing users to save analysis results directly to files.

  • Generate MT VIP Hook: SigTool can also generate an MT VIP hook to bypass APK signatures. How to Inject the hook?...


Requirements

Before using SigTool, ensure that the following system dependencies are installed:

  1. Python: Required to run the SigTool.
  2. Java: Required to run smali.jar for generating MT hook.
  3. aapt: Required to extract APK metadata.
  4. OpenSSL: Required for handling certificates.

Installation

Termux (Android)

To install SigTool on Termux, use the following command to install all necessary dependencies:

pkg install python openjdk-17 aapt openssl-tool

Installation via pip (Recommended)

You can easily install SigTool using pip:

pip install --force-reinstall sigtool

For the latest changes and features, install SigTool directly from the GitHub repository:

pip install --force-reinstall -U git+https://github.com/muhammadrizwan87/sigtool.git

Custom Build Installation

To build SigTool from source:

  1. Clone the repository:

    git clone https://github.com/muhammadrizwan87/sigtool.git
    
  2. Navigate to the SigTool directory:

    cd sigtool
    
  3. Install the build tools:

    pip install build
    
  4. Build and install the package:

    python -m build
    pip install --force-reinstall dist/sigtool-2.0-py3-none-any.whl
    

Usage:

usage: sigtool <apk_path> [-a] [-c] [-e] [-f] [-fc] [-fu] [-fuc] [-p] [-u] [-uc] [-hmt] [-o <output_path>]

positional arguments:
  apk_path       Path to the APK file

options:
  -h, --help     show this help message and exit
  -u             Convert output to uppercase
  -c             Add colons to certificate hashes
  -uc            Add colons to hashes and convert output to uppercase
  -e             Encode output in Base64
  -p             Parse PEM Certificate
  -a             Generate Smali Byte Array
  -f             Print All Information
  -fc            Add colons to hashes and print all information
  -fu            Convert output to uppercase and print all information
  -fuc           Add colons to hashes, convert output to uppercase and print all information
  -hmt           Generate and export hook of MT enhanced version
  -o O           Output results to a specified file path. If the path ends with '.json', results will be saved in JSON format.
  -v, --version  Show program's version number and exit

Examples:

  1. To print the default results:

    sigtool /path/to/apk
    
  2. To save the default results to a file:

    sigtool /path/to/apk -o /path/to/output.txt
    
  3. To print the Base64-encoded results:

    sigtool /path/to/apk -e
    
  4. To save all results to a file:

    sigtool /path/to/apk -f -o /path/to/output.bin
    
  5. To save results in JSON format:

    sigtool /path/to/apk -f -o /path/to/output.json
    
  6. To export hook of MT enhanced version:

    sigtool /path/to/apk -hmt -o /path/to/hook
    

Contributing

Feel free to submit issues or pull requests if you find any bugs or have suggestions for new features.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Author

MuhammadRizwan


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sigtool-3.0.tar.gz (912.4 kB view details)

Uploaded Source

Built Distribution

sigtool-3.0-py3-none-any.whl (911.3 kB view details)

Uploaded Python 3

File details

Details for the file sigtool-3.0.tar.gz.

File metadata

  • Download URL: sigtool-3.0.tar.gz
  • Upload date:
  • Size: 912.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.20

File hashes

Hashes for sigtool-3.0.tar.gz
Algorithm Hash digest
SHA256 4c89abc1c5477711094fd9d0c3ecdf0f5a5ae7ba0ce834b0a223d2ae847b2b29
MD5 0109a2510912b16d2941a6d7cb702e52
BLAKE2b-256 b291ac118ff4bd39f346cbe245103cbf078eaba0f33ab68399dc77103adc41b6

See more details on using hashes here.

File details

Details for the file sigtool-3.0-py3-none-any.whl.

File metadata

  • Download URL: sigtool-3.0-py3-none-any.whl
  • Upload date:
  • Size: 911.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.20

File hashes

Hashes for sigtool-3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2f65254b85cac343a4d9c16054dbe3ed1da2197985f4345160aec18698d5f276
MD5 60e26161aff6ec46a920f88f33f06143
BLAKE2b-256 099ae113ab884bc2a0f5cd7e20b59f198a3e1cfa38cccc692f7aaf6be05a43e3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page