frida-server-manager 0.5.1

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 from GitHub or custom URLs
• Run frida-server with custom options and parameters
• Enhanced list command with visual highlighting and fuzzy matching
• Support for multiple frida-related server files (frida-server, florida-server, etc.)
• Filter frida-server files by name with wildcard support
• Process management (list, kill) with name and PID filtering
• Proxy support for network operations
• Force run option to stop existing processes before starting new ones
• Enhanced output formatting with Rich library
• Custom URL support with filename preservation
• Support for various compression formats (xz, gz, tar.gz)
• 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 17.2.15

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

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

# Install keeping original name
fsm install -k 17.2.15

# Install from custom URL (supports xz, gz, tar.gz)
fsm install --url https://example.com/frida-server.xz

# Install from custom URL with proxy and keep original name
fsm install --url https://github.com/Ylarod/Florida/releases/download/17.5.2/florida-server-17.5.2-android-arm64.gz --proxy http://127.0.0.1:7890 --keep-name

# Install with proxy (short option)
fsm install -p http://127.0.0.1:7890 17.2.15

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-related server files in default directory with highlighting
fsm list

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

# List files with name containing specific keyword (fuzzy matching)
fsm list -n 17.2

# List specific version files
fsm list -n frida-server-17.2.15

# List florida-server files
fsm list -n florida-server

# List all files containing "frida" in their name
fsm list -n frida

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的命令行工具。

功能特性

• 从GitHub或自定义URL在Android设备上安装frida-server
• 使用自定义选项和参数运行frida-server
• 增强的list命令，支持视觉高亮和模糊匹配
• 支持多种frida相关的服务器文件（frida-server, florida-server等）
• 支持通配符的名称筛选功能
• 进程管理（列出、终止），支持按名称和PID筛选
• 网络操作的代理支持
• 强制运行选项，可在启动新进程前停止现有进程
• 使用Rich库增强输出格式
• 自定义URL支持，保留原始文件名
• 支持多种压缩格式（xz, gz, tar.gz）
• 检查frida版本和兼容性
• 易用的命令行界面

安装方法

pip install fsm

使用方法

基本命令

检查ADB连接

fsm

安装frida-server

# 安装最新版本
fsm install

# 安装特定版本
fsm install 17.2.15

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

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

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

# 从自定义URL安装（支持xz, gz, tar.gz格式）
fsm install --url https://example.com/frida-server.xz

# 从自定义URL安装，使用代理并保留原始文件名
fsm install --url https://github.com/Ylarod/Florida/releases/download/17.5.2/florida-server-17.5.2-android-arm64.gz --proxy http://127.0.0.1:7890 --keep-name

# 使用代理安装（短选项）
fsm install -p http://127.0.0.1:7890 17.2.15

运行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相关服务器文件，带有高亮效果
fsm list

# 列出自定义目录中的frida相关服务器文件
fsm list -d /custom/path

# 列出名称包含特定关键字的文件（模糊匹配）
fsm list -n 17.2

# 列出特定版本的文件
fsm list -n frida-server-17.2.15

# 列出florida-server文件
fsm list -n florida-server

# 列出名称中包含"frida"的所有文件
fsm list -n frida

进程管理

# 列出运行的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。