fa-tui 0.1.0__py3-none-any.whl

fa_tui/app.py

@@ -0,0 +1,129 @@
+import re
+from textual.app import App, ComposeResult
+from textual.widgets import ListView, ListItem, Label, Static
+from textual.containers import Vertical, Horizontal
+from textual import events
+import subprocess
+from pathlib import Path
+
+result_data = {}
+
+class FridaTUI(App):
+    CSS = """
+    Screen {
+        layout: vertical;
+        background: $background;
+    }
+    #mode-label {
+        padding: 1;
+        text-align: center;
+        background: $accent;
+        color: $text;
+    }
+    #js-files, #frida-output {
+        width: 100%;
+        height: 100%;
+        border: solid $primary;
+        padding: 1;
+    }
+    ListView {
+        height: 100%;
+    }
+    Label {
+        padding: 1;
+    }
+    """
+
+    def compose(self) -> ComposeResult:
+        # 使用 Horizontal 容器将两组列表并排显示
+        yield Horizontal(
+            Vertical(
+                Static("frida-ps -Uai 输出", classes="title"),
+                ListView(id="frida-output")
+            ),
+            Vertical(
+                Static("当前目录中的 JS 文件", classes="title"),
+                ListView(id="js-files")
+            )
+        )
+        # 添加一个显示当前模式的标签，提示可按 M 切换
+        yield Static("当前模式: spawn (按 M 切换)", id="mode-label")
+    def on_mount(self) -> None:
+        self.mode = "spawn"  # 默认模式为 spawn，对应 -f
+        self.js_files = []
+        self.frida_processes = []
+
+        # 加载当前目录下的 JS 文件
+        js_files = [f.name for f in Path.cwd().glob("*.js")]
+        self.js_files = js_files
+        js_list = self.query_one("#js-files", ListView)
+        for file in js_files:
+            js_list.append(ListItem(Label(file)))
+
+        # 加载 frida-ps -Uai 输出
+        try:
+            result = subprocess.run(
+                ["frida-ps", "-Uai"],
+                capture_output=True,
+                text=True,
+                check=True
+            )
+            output_lines = result.stdout.splitlines()[2:]  # 跳过前两行
+            self.frida_processes = output_lines
+            frida_list = self.query_one("#frida-output", ListView)
+            for line in output_lines:
+                frida_list.append(ListItem(Label(line)))
+        except Exception as e:
+            self.frida_processes = [f"Error: {e}"]
+            frida_list = self.query_one("#frida-output", ListView)
+            frida_list.append(ListItem(Label(str(e))))
+
+    async def on_key(self, event: events.Key) -> None:
+        # 按 M 键切换模式
+        if event.key.lower() == "m":
+            self.mode = "attach" if self.mode == "spawn" else "spawn"
+            mode_label = self.query_one("#mode-label", Static)
+            mode_label.update(f"当前模式: {self.mode} (按 M 切换)")
+        # 按 Enter 键选择当前项并退出 TUI
+        elif event.key == "enter":
+            js_index = self.query_one("#js-files", ListView).index
+            frida_index = self.query_one("#frida-output", ListView).index
+
+            js_file = self.js_files[js_index] if js_index is not None and js_index < len(self.js_files) else None
+            frida_proc = self.frida_processes[frida_index] if frida_index is not None and frida_index < len(self.frida_processes) else None
+
+            # 将选择结果和当前模式存入全局变量
+            result_data["js_file"] = js_file
+            result_data["frida_proc"] = frida_proc
+            result_data["mode"] = self.mode
+
+            await self.action_quit()
+
+def main():
+    FridaTUI().run()
+
+    if result_data:
+        js_file = result_data.get("js_file") or ""
+        frida_line = result_data.get("frida_proc") or ""
+        mode = result_data.get("mode", "spawn")
+
+        parts = frida_line.split()
+        pkg = parts[-1] if parts else ""
+
+        if js_file and pkg:
+            # 根据模式选择不同参数
+            option = "-f" if mode == "spawn" else "-n"
+            cmd = f"frida -U {option} {pkg} -l {js_file}"
+            print(f"执行命令：{cmd}")
+            try:
+                subprocess.run(["frida", "-U", option, pkg, "-l", js_file])
+            except FileNotFoundError:
+                print("找不到 frida 命令，请确认已正确安装并在 PATH 中。")
+            except Exception as e:
+                print(f"执行失败: {e}")
+        else:
+            print("无法生成 frida 命令，可能未正确选择 JS 或进程")
+
+
+if __name__ == "__main__":
+    main()

fa_tui-0.1.0.dist-info/METADATA

@@ -0,0 +1,62 @@
+Metadata-Version: 2.1
+Name: fa-tui
+Version: 0.1.0
+Summary: 一个文本TUI工具，用于选择frida进程和JS脚本。适用于Android系统
+Author-email: hongenge <hongen.me@gmail.com>
+Project-URL: Homepage, https://github.com/hongenge/fa-tui
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: textual>=3.5.0
+
+# fa-tui
+
+一个`frida`的终端 TUI 工具，用于选择 `frida-ps -Uai` 输出的进程和本地目录中的 JS 文件，并以 spawn 或 attach 模式执行 Frida 注入命令。
+
+> ⚠️ **注意**  
+> 本工具设计用于 Android 设备的 Frida Hook，依赖 `frida` 和 `frida-ps` 命令正确连接 Android 设备（如通过 USB 或 TCP 连接的设备）。
+
+## ✨ 功能特点
+
+- 实时列出 `frida-ps -Uai` 获取的 Android 设备进程列表
+- 自动扫描当前目录下的 JS 脚本文件
+- 支持切换 `spawn` / `attach` 模式（默认 `spawn`，按 `M` 切换）
+- 支持鼠标和键盘操作选择进程和脚本，回车自动执行注入命令
+
+## 📦 安装方式
+
+
+```bash
+pip install fa-tui
+````
+
+## 🚀 使用方法
+
+在终端中运行：
+
+```bash
+fa-tui
+```
+
+交互界面将展示：
+* 左侧：`frida-ps -Uai` 输出的 Android 进程列表
+* 右侧：当前目录中的 JS 文件列表
+* 底部：当前注入模式，按 `M` 键可切换 `spawn` 和 `attach` 模式
+* 按 Ctrl+Q 可随时退出程序
+
+选中 JS 文件和目标进程后，按下 `Enter` 键，将会自动执行：
+
+```bash
+frida -U -f 包名 -l 脚本.js   # spawn 模式
+# 或
+frida -U -n 包名 -l 脚本.js   # attach 模式
+```
+
+## 🔧 依赖项
+
+* Python 3.8+
+
+* 已安装并配置 `frida` 命令行工具（`frida` 与 `frida-ps`）
+
+* Android 设备连接且可用 `frida-ps -Uai` 正确列出进程
+
+* [Textual](https://github.com/Textualize/textual)

fa_tui-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+fa_tui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fa_tui/app.py,sha256=syu1bsEgiErgUZh3AmQA3P5joF2MEIu7PKcFEMjTrl0,4598
+fa_tui-0.1.0.dist-info/METADATA,sha256=q4KjsfhqPd4snvyxRrZLCPTj6t2dE3YYv2em5ibKY6o,1868
+fa_tui-0.1.0.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
+fa_tui-0.1.0.dist-info/entry_points.txt,sha256=DzfsvNL9TeRqgL7arD_d4CcvTGSNNwgIVTD40Q_t9Rg,43
+fa_tui-0.1.0.dist-info/top_level.txt,sha256=EMFC920Cb0vfmnnsEZYZUm2BHVLC5yfOVzo9lsZOxqU,7
+fa_tui-0.1.0.dist-info/RECORD,,

fa_tui-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.3.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

fa_tui-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fa-tui = fa_tui.app:main

fa_tui-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+fa_tui