MCPcopy
hub / github.com/dqzg12300/fridaUiTools

github.com/dqzg12300/fridaUiTools @v2.0.3 sqlite

repository ↗ · DeepWiki ↗ · release v2.0.3 ↗
1,674 symbols 4,517 edges 151 files 43 documented · 3%
README

fridaUiTools

English | 中文

fridaUiTools is a PyQt5-based desktop Frida workbench. It brings common connection flows, attach actions, script template management, log viewing, AI-assisted analysis, GumTrace, and memory search into one interface, so you can build a reusable local repository of your own Frida workflows.

fridaUiTools

Project Positioning

  • Reduce the daily operating cost of Frida through a desktop UI
  • Gradually reshape built-in features into a maintainable template library
  • Save commonly used scripts as custom templates and enable them quickly
  • Connect to AI-compatible endpoints for AI script generation and AI log analysis

Feature Overview

  • Multiple attach modes: attach current foreground process, attach a specified process, and spawn attach
  • Multiple connection modes: USB, WiFi, custom port, and multi-device switching
  • Custom script management: template maintenance, quick enable, import and export of hook lists
  • Common reversing features: JNI Trace, Stalker, Dump So, Dump Dex, Patch, and Wallbreaker
  • AI assistance: log analysis and script generation
  • GumTrace workbench: visual trace script generation and log download
  • Memory workbench: experimental string/value search, breakpoints, and disassembly support

Environment Requirements

  • Python 3
  • ADB must be available, and USB debugging must be enabled on the device
  • The target device must already have the matching frida-server binary
  • Linux, macOS, and Windows are supported

Install and Run

Using a virtual environment is recommended:

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 kmainForm.py

If you already have your own Python environment, you can also run:

pip install -r requirements.txt
python3 kmainForm.py

5-Minute Quick Start

  1. Connect the phone and make sure adb devices can see the target device.
  2. Start the application with python3 kmainForm.py.
  3. Select the current device in the main window.
  4. Upload and start the matching frida-server version from the menu.
  5. Switch USB / WiFi connection mode and port when needed.
  6. Select the templates or custom scripts you want to enable.
  7. Start working with attach current process, attach specified process, or spawn attach.
  8. View the output in the log panel.

AI Configuration

[ai]
host = https://api.openai.com/v1
apikey = your_api_key
model = gpt-5.4

Thanks

Extension points exported contracts — how you extend this code

ObjectWrapper (Interface)
(no doc) [3 implementers]
js/index.d.ts
MemoryAccessCallbacks (Interface)
* Callbacks to be notified synchronously on memory access.
js/index.d.ts
StalkerOptions (Interface)
* Options to customize Stalker's instrumentation. * * Note that the callbacks provided have a significant impact on pe
js/index.d.ts
ProxyConstructor (Interface)
* Constructor for instantiating a proxy object. * * @param target Target object to proxy to. * @param dat
js/index.d.ts
InstanceData (Interface)
* User-defined data that can be accessed from method implementations.
js/index.d.ts

Core symbols most depended-on inside this repo

get
called by 416
js/index.d.ts
trText
called by 365
kmainForm.py
log
called by 231
kmainForm.py
overload
called by 183
js/index.d.ts
appentOutRes
called by 167
utils/FartUtil.py
call
called by 108
js/index.d.ts
get_uleb128
called by 102
utils/FartUtil.py
_safeStr
called by 81
custom/getprop.js

Shape

Method 897
Function 467
Class 172
Interface 136
Enum 2

Languages

Python60%
TypeScript40%

Modules by API surface

kmainForm.py346 symbols
js/index.d.ts248 symbols
utils/FartUtil.py108 symbols
forms/SearchMemory.py72 symbols
js/default.js59 symbols
forms/AiScriptTuner.py53 symbols
forms/Custom.py48 symbols
utils/AiUtil.py45 symbols
forms/Wallbreaker.py30 symbols
forms/ZenTracer.py23 symbols
TraceThread.py23 symbols
js/FCAnd_Jnitrace.js19 symbols

Dependencies from manifests, versioned

capstone4.0.2 · 1×
frida16.7.19 · 1×
hexdump3.3 · 1×

For agents

$ claude mcp add fridaUiTools \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact