frida-server-manager 0.5

A tool to manage frida-server on Android devices

fsm (frida-server-manager)

A command-line tool to manage frida-server on Android devices.

Features

• Install frida-server on Android devices
• Run frida-server with custom options
• List frida-server files on the device with enhanced version detection
• Filter frida-server files by name
• Check frida versions and compatibility
• Easy-to-use command-line interface

Installation

pip install fsm

Usage

Basic Commands

Check ADB connection

fsm

Install frida-server

# Install the latest version
fsm install

# Install a specific version
fsm install 16.1.4

# Install with custom repository (owner/repo format)
fsm install -r frida/frida

# Install with custom name
fsm install -n my-frida-server

# Install keeping original name
fsm install -k

# Install from custom URL
  fsm install --url https://example.com/frida-server.xz

# Install with proxy
fsm install -p http://127.0.0.1:7890

Run frida-server

# Run with default settings
fsm run

# Run with custom directory and parameters
fsm run -d /custom/path -p "-D"

# Run specific version
fsm run -V 16.1.4

# Run with custom name
fsm run -n my-frida-server

# Force run the specified version (stop any existing processes first)
fsm run -V 16.1.4 -f

List frida-server files

# List frida-server files in default directory
fsm list

# List frida-server files in custom directory
fsm list -d /custom/path

# List specific frida-server file by name
fsm list -n frida-server-16.1.4

Process Management

# List running frida-server processes
fsm ps

# List specific processes
fsm ps -n com.example.app

# Kill frida-server processes
fsm kill

# Kill specific process by PID
fsm kill -p 12345

# Kill processes by name
fsm kill -n frida-server

Options

• -v, --verbose: Enable verbose output
• -h, --help: Show help message

Requirements

• Python 3.6 or higher
• ADB (Android Debug Bridge) installed on your system
• An Android device connected via USB with USB debugging enabled

Development

Project Structure

This project uses modern Python packaging with pyproject.toml configuration:

[build-system]
requires = ["setuptools>=61.0", "wheel"]
build-backend = "setuptools.build_meta"

Building from Source

# Clone the repository
git clone https://github.com/KingJem/frida-server-manger.git
cd frida-server-manger

# Install in development mode
pip install -e .

# Build distribution packages
python -m build

Installation for Development

# Install development dependencies
pip install -e ".[dev]"

# Run tests
python -m pytest tests/

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

中文说明

一个用于在Android设备上管理frida-server的命令行工具。

功能特性

• 在Android设备上安装frida-server
• 使用自定义选项运行frida-server
• 列出设备上的frida-server文件并显示增强的版本检测
• 根据名称筛选frida-server文件
• 检查frida版本和兼容性
• 易用的命令行界面

安装方法

pip install fsm

使用方法

基本命令

检查ADB连接

fsm

安装frida-server

# 安装最新版本
fsm install

# 安装特定版本
fsm install 16.1.4

# 使用自定义仓库安装（owner/repo格式）
fsm install -r frida/frida

# 使用自定义名称安装
fsm install -n my-frida-server

# 保持原始名称安装
fsm install -k

# 从自定义URL安装
  fsm install --url https://example.com/frida-server.xz

# 使用代理安装
fsm install -p http://127.0.0.1:7890

运行frida-server

# 使用默认设置运行
fsm run

# 使用自定义目录和参数运行
fsm run -d /custom/path -p "-D"

# 运行特定版本
fsm run -V 16.1.4

# 使用自定义名称运行
fsm run -n my-frida-server

# 强制运行指定版本（先停止所有现有进程）
fsm run -V 16.1.4 -f

列出frida-server文件

# 列出默认目录中的frida-server文件
fsm list

# 列出自定义目录中的frida-server文件
fsm list -d /custom/path

# 根据名称列出特定的frida-server文件
fsm list -n frida-server-16.1.4

进程管理

# 列出运行的frida-server进程
fsm ps

# 列出特定进程
fsm ps -n com.example.app

# 终止frida-server进程
fsm kill

# 根据PID终止特定进程
fsm kill -p 12345

# 根据名称终止进程
fsm kill -n frida-server

选项

• -v, --verbose: 启用详细输出
• -h, --help: 显示帮助信息

系统要求

• Python 3.6或更高版本
• 系统上已安装ADB（Android Debug Bridge）
• 通过USB连接的Android设备，并已启用USB调试模式

开发指南

项目结构

本项目使用现代化的Python打包方式，采用pyproject.toml配置文件：

[build-system]
requires = ["setuptools>=61.0", "wheel"]
build-backend = "setuptools.build_meta"

从源码构建

# 克隆仓库
git clone https://github.com/KingJem/frida-server-manger.git
cd frida-server-manger

# 以开发模式安装
pip install -e .

# 构建分发包
python -m build

开发环境安装

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
python -m pytest tests/

许可证

本项目采用MIT许可证 - 详情请查看LICENSE文件。

使用示例

检查设备连接

运行以下命令可以检查是否有设备通过ADB连接：

fsm

如果设备已连接，您将看到类似以下输出：

Success: 1 device(s) connected

安装特定版本的frida-server

要安装特定版本的frida-server，可以使用版本号作为参数：

fsm install 16.1.4

安装成功后，您将看到类似以下输出：

Successfully installed frida-server 16.1.4 on arm64 device at /data/local/tmp/frida-server-16.1.4
To run this specific version, use: fsm run --dir /data/local/tmp --params '/data/local/tmp/frida-server-16.1.4'

后台运行frida-server

要在后台运行frida-server，可以使用-D参数：

fsm run --params "-D"

命令格式

该工具支持以下命令格式：

1. 直接使用fsm命令：fsm [options] {install,run} [arguments]
2. 使用Python模块方式：python -m fsm [options] {install,run} [arguments]

故障排除

常见问题

1. ADB未找到

   • 确保ADB已正确安装并添加到系统PATH中
   • 尝试使用绝对路径运行ADB命令确认其可访问性

2. 设备未连接

   • 确保USB调试已启用
   • 尝试重新连接USB线缆
   • 运行adb devices命令确认设备是否被识别

3. 权限错误

   • 确保您有足够的权限运行ADB命令
   • 尝试以管理员/root权限运行命令

贡献

欢迎提交问题和改进建议！如果您有任何问题或需要帮助，请在项目仓库中创建Issue。