# asLody/whale

Hook Framework for Android/IOS/Linux/MacOS

Repository: https://github.com/asLody/whale
Canonical: https://ross.abutalabs.com/products/whale
Language: C++
License: Apache-2.0
License Family: permissive
Topics: android, ios, hook-framework, jit, inline-hook
Last push: 2020-12-13T06:13:57+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2776, "days_push": 2089, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1665, forks 339 (observed 2026-08-28T04:05:18.979414+00:00)

## What it is
Whale is a cross-platform hook framework written in C++ that runs on Android, iOS, Linux, and macOS, supporting ARM/THUMB, ARM64, X86, and X86_64 architectures. It provides Xposed-style Java method hooking, native inline hooking, runtime class/object manipulation, and a built-in JIT engine for generating executable instructions in memory.

## Use cases
- hook java methods on android xposed-style
- inline hook native functions on linux or macos
- bypass android hidden api policy
- hotfix an app at runtime without repackaging
- monitor or tamper with app behavior for analysis
- inject into a system process as an xposed replacement
- modify class inheritance relationships at runtime

## When to choose
- you need native or java-level hooking across android, ios, linux, and macos from one c++ library
- you want xposed-style method hooks without the xposed framework
- you need multi-architecture support including arm64 and x86_64
- you want a built-in jit engine to generate custom hook instructions

## When to avoid
- you need a hook framework on non-jailbroken ios in release builds, since inline hooking only works in debug mode there
- you need a actively maintained project - the latest release dates to late 2020
- you only target windows, which is unsupported
- you prefer a pure-java or pure-swift solution over c++ integration

## Facets
- artifact type: library
- maturity: maintenance
- function: security, reverse-engineering, compiler
- domain: security, reverse-engineering, mobile-development, developer-tools
- platform: cpp
- tags: hook-framework, inline-hook, xposed-style, jit-engine, native-hook, method-hook, android, ios, linux, macos

## Member repositories
- asLody/whale (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:18.979414+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:43:01.204225+00:00, confidence not recorded.
  - readme: https://github.com/asLody/whale (fetched 2026-08-28T04:05:18.979414+00:00, sha 4dc020b39964)
- Data as of 2026-08-30T08:39:29.467469+00:00.