KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

EasyHook

★ 41 Open GitHub ↗

EasyHook 是一个运行在 Windows 桌面端的 Android Frida 脚本 IDE，支持脚本管理、代码编辑、Android 设备连接、进程选择、Attach/Spawn 注入、运行控制和日志输出，让 Frida 脚本无需手写 Python 启动器即可快速执行。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
  <h1>EasyHook</h1>
  <p>Android Frida IDE for Windows desktop users.</p>
  <p align="center">
  <img alt="EasyHook interface overview" src="docs/assets/cover.png" width="900">
  </p>
  <p>
    <a href="README.zh-CN.md">简体中文</a>
  </p>
  <p>
    <a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-green.svg"></a>
    <a href="https://github.com/RytterMohn/EasyHook/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/RytterMohn/EasyHook?style=flat&logo=github&label=Stars&color=181717"></a>
    <a href="https://github.com/RytterMohn/EasyHook/network/members"><img alt="GitHub forks" src="https://img.shields.io/github/forks/RytterMohn/EasyHook?style=flat&logo=github&label=Forks&color=181717"></a>
    <img alt="Platform" src="https://img.shields.io/badge/platform-Windows%20%2B%20Android-blue.svg">
    <img alt="Electron" src="https://img.shields.io/badge/Electron-38-47848F.svg">
    <img alt="Frida" src="https://img.shields.io/badge/Frida-17.3.0-orange.svg">
    <img alt="Node.js" src="https://img.shields.io/badge/Node.js-20%2B-339933.svg">
  </p>
</div>

EasyHook is an Electron IDE for Android Frida scripts. It runs on Windows and connects to Android phones or emulators through Frida USB/tether devices, putting script management, editing, Android device/process selection, attach/spawn, execution, and logs in one desktop app.

It removes the repeated work of writing a Python launcher every time you want to run a Frida script.

## Screenshot

- Left: script library and search
- Center: Frida script editor
- Right top: Android device, attach/spawn mode, process/app target, runtime, run/stop buttons
- Right bottom: Frida console output and message posting

## Interface Overview

EasyHook's main window is organized around the Android hook workflow:

| Area | Purpose |
| --- | --- |
| Script Library | Open a folder, search scripts, and switch between Frida scripts. |
| Script Editor | Edit the current JavaScript/TypeScript Frida script with line numbers and save controls. |
| Target Panel | Select the connected Android USB/tether device, choose attach or spawn, and select a process or package. |
| Runtime Controls | Choose Frida runtime and start or stop the current script. |
| Console | View `send()` output, script errors, detach events, and post messages to the running script. |

## What It Hooks

EasyHook does not hook one fixed program. It hooks the Android app/process you select in the Target panel.

- `Attach`: hook an already-running Android process
- `Spawn`: enter an Android package name, launch the app, and inject before it resumes

The Windows `local` Frida device is hidden by default to avoid accidentally listing or hooking Windows processes.

## Features

- Electron desktop IDE with no frontend build step
- Open one Frida script or scan a whole script folder
- Built-in script editor, line numbers, save, and save as
- Android USB/tether device discovery and process listing
- Attach to running Android processes
- Spawn Android packages and inject scripts
- Read installed Android apps when available and fill package names
- Realtime Frida `send()`, script error, and detach output
- Send `post()` messages to a running script
- Android and native hook examples included

## Quick Start

```bash
npm install
npm start
```

Before development, make sure your host has Node.js 20+ and npm 10+. The Android side needs a rooted device or rooted emulator running a matching `frida-server`.

## Usage

1. Click `Folder` to load a script folder, or click `Open` to open one script.
2. Select the Android USB/tether device on the right.
3. Choose `Attach` and pick an Android process, or choose `Spawn` and enter an Android package name.
4. Click `Run` to execute the current script.
5. Watch `send()` output and errors in `Console`.
6. Click `Stop` to unload the script and detach.

Android device setup: [docs/android-setup.md](docs/android-setup.md).

## Project Structure

```text
EasyHook/
  src/
    main/          Electron main process and Frida lifecycle
    preload/       Safe renderer bridge
    renderer/      IDE UI
  examples/        Frida script examples
  docs/            Setup and architecture notes
  scripts/         Project maintenance scripts
```

## Commands

```bash
npm start       # run the IDE
npm run check   # syntax-check JavaScript files
npm run pack    # create an unpacked desktop build
npm run dist    # create distributable builds
```

## Repository

https://github.com/RytterMohn/EasyHook

## Legal and Safety

Use EasyHook only on devices, apps, and processes that you own or have explicit permission to inspect. Frida can dynamically change target process behavior. Review unknown scripts before running them.

## License

MIT. See [LICENSE](LICENSE).

EasyHook

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README