FIRERPA Android ｜ AI-Powered Automation

FIRERPA is an all-in-one Android device control platform. The server runs directly on the device with no extra runtime dependencies; it supports multiple generations of Android and works with or without root. On the PC side, the Python client library orchestrates UI automation, remote operations, traffic capture, Hook-based reverse engineering, network proxying, distributed networking, AI agents, and MCP through a single service and API. Compared with stitching together Appium, mitmproxy, frida-server, adb, uiautomator2, and ad-hoc scripts and ops tools, FIRERPA offers one source of capabilities, unified configuration, connected workflows, and a stack built for multi-device, long-running, production use.

Remote Desktop & Live Streaming

FIRERPA provides a browser-based remote desktop: view and control the device in real time without installing a dedicated PC client, over LAN or across networks. Streaming supports both MJPEG and H.264, with software and hardware encoding backends. Frame rate (up to 60fps), resolution scale, bitrate, and quality can be tuned to device capability and network conditions—reducing bandwidth and improving smoothness on weak links. WebRTC is also supported, with configurable STUN/TURN servers for better NAT traversal and lower end-to-end latency in public or cross-region setups.

The remote desktop supports multi-user concurrent access for collaborative debugging, demos, and training. Bidirectional clipboard sharing and live audio (Android 10+) are included, along with an integrated terminal, drag-and-drop uploads, and browser-based file browsing and downloads—all over a single port. Built-in visual layout inspection highlights elements, supports Tab traversal, shows coordinates and RGB values, and exports the XML layout tree so you can validate selectors and automation logic in the same UI, shortening the loop from screen to script.

Remote desktop and RPC support end-to-end TLS and service-certificate access control, with optional custom WebUI login passwords to reduce exposure on public networks. Remote desktop capabilities can also be embedded into your own web apps over WebSocket (live video, touch, terminal, keys, etc.), with allow_origin for cross-origin integration—suitable for productizing real-device control.

UI Automation

FIRERPA provides a full selector-based automation system: text, resourceId, description, scrollable, and other common matchers, plus child / sibling chaining for duplicate elements, deep hierarchies, or controls without distinctive attributes. At the element level: screenshots, wait for appear/disappear, corner/center coordinates, exists checks, Unicode input, stepped swipes, fling scrolling, scroll-to-end, and more. It can coexist with other accessibility services on Android 8.0+ and improves WebView node discovery for hybrid apps.

The UI Watcher listens for UI changes in real time and runs clicks, key events, or counters when conditions match—useful for auto-dismissing agreements, update prompts, ads, and other interruptions. Multiple selector conditions and per-event enable/disable are supported; transient screens can be counted.

Virtual Display is a differentiator: create isolated background displays on the device and run apps and automation there without affecting the main screen—e.g. auto-reply on a virtual display while you use the phone normally. The virtual-display API mirrors the main device API (d.xxx → vd.xxx); Watchers can be scoped to a virtual display. The WebUI supports multi-display view and switching in remote desktop—ideal for background tasks, parallel work, and human-in-the-loop plus machine automation.

For scenes without a standard view tree (games, custom-drawn UI), FIRERPA offers OCR and image matching. OCR supports paddleocr, easyocr, and custom HTTP backends; in clusters, recognition can run centrally instead of loading models on every PC, with GPU acceleration and flexible text matching. Image matching runs on the device (template or SIFT), without consuming PC resources; SIFT is robust to rotation, scale, and lighting. Multi-touch supports recording, replay, programmatic construction, and binary persistence for complex gestures and pressure.

Architecturally, FIRERPA uses a client/server model—better for centralized scheduling, versioning, and fleet control than on-device script runners like AutoJS; lighter than Appium; more stable than uiautomator2 in multi-device scenarios. The docs position it as a functional superset of common Android automation stacks—automation, capture, Hook, and ops can be chained in code on one platform without switching tools.

Packet Capture & MITM

FIRERPA offers one-click MITM capture: automatic system root CA install, proxy setup, handling of Android version differences, and automatic network restore on exit—no manual cert or proxy toggling. Global capture, per-package capture, live request/response editing, shared mitmweb, and upstream HTTP proxy for international traffic are supported. Built-in QUIC downgrade reduces QUIC interference. Capture still works when PC and device only share a single FIRERPA port (e.g. ADB connect or frp forwarding).

Beyond one-click scripts, MITM is fully API-driven: install/uninstall system CAs compatible with mitmproxy, Fiddler, Charles, etc.; embed capture in automation pipelines alongside UI steps and Frida hooks. A Windows startmitm.exe is available without a Python install.

Network, Proxy & Connectivity

On the device, FIRERPA provides full proxy support: HTTP / HTTPS / SOCKS5 / Shadowsocks (multiple ciphers), per-app proxy (including multi-user clones), DNS proxy, UDP proxy, LAN bypass, coexistence with OpenVPN, and auto-connect to configured proxies at startup. Proxies support IPv6 and UDP for complex networks.

Device HTTP bridge proxy (tunnel2) provides reverse-proxy capability: point your PC or browser HTTP proxy at the phone and traffic is forwarded through the phone’s network egress; the outbound IP matches the phone. Wi‑Fi or cellular (rmnet) can be chosen as the egress interface—useful for joint debugging, international apps, and multi-device IP pools.

A built-in OpenVPN client supports certificate, username/password, and mixed auth, alongside system proxy; an OpenVPN Docker image and config generators produce device-side code and autostart settings. A built-in frp client forwards device services to a public server via fwd.*, with encryption and TLS.

mDNS discovery enables {device_id}.local access to remote desktop and other services, with optional TXT metadata (model, ABI, device ID) for LAN fleet discovery.

Frida & Reverse Engineering

FIRERPA bundles the latest Frida—no separate frida-server. Use frida tooling from the remote desktop terminal without -U, -H, etc. Built-in hiding patches (open-source plus in-house) are maintained against detection; connections use token auth over the FIRERPA port. objection patches and Frida 17.x java-bridge helpers ease migration.

Persistent Frida scripts re-inject after app crash or exit; YAML offline persistence with directory watch and hot reload. Frida RPC maps to Python methods and HTTP + JSON-RPC 2.0 remote calls on JVM, UI main, or pure JS threads. Script emit data can go to HTTP / Redis / RabbitMQ (MQTT) with device/app metadata, zlib compression, HTTP retries, and MQTT TLS.

ADB, SSH & Built-in Terminal

FIRERPA includes a standalone built-in ADB—wireless high-privilege ADB without enabling system Developer Options, useful when apps detect developer mode. Magisk modules can preinstall adb_keys for default authorization. Built-in SSH plus ssh.sh / scp.sh for remote shell and file transfer.

The built-in terminal ships with strace, ltrace, tcpdump, scapy, fsmon, frida-tools, MemDumper, and Python stacks such as Crypto, cv2, unicorn, capstone, keystone, redis, and grpc. sqlite3 supports wxsqlite / sqlcipher / sqlcrypto for reading encrypted databases from apps such as WeChat, WeCom, and Alibaba-family clients. One environment across remote desktop, SSH, and ADB—analyze and control on-device with less PC shuttling.

Distributed & Multi-Device Management

FIRERPA StarLink Platform (Hub + hub-bridge) provides centralized multi-device access for local and remote devices with unified management and P2P access—ideal for “device at home, operator elsewhere” and multi-device collaboration. hub v3 uses SAPI for unified requests to local and remote devices. Besides Hub, frp forwarding and OpenVPN mesh are also supported as self-hosted options, with full documentation a