Termux/Android 的真实浏览器自动化。不需要 root 权限。

Xvfb上的Firefox（默认）或Chromium——完全可以在手机上运行。 Firefox 通过 TLS 指纹原生通过 Cloudflare 传输。Chromium 的应用 CDP隐形。两者都使用真实设备硬件信息。

特色

• 持久守护进程 — 浏览器持续运行，命令秒以下
• Pass Cloudflare — Firefox：即时基于TLS的通行证;Chromium：Turnstile handler
• 无自动化框架 — Firefox通过xdotool + clipboard JS执行控制
• AI友好 — 所有命令中都标记--json，用于结构化输出
• 真实设备指纹 — 自动检测屏幕、GPU、CPU、拱形、型号
• 类人输入 — 贝塞尔曲线鼠标，逼真的输入，剪贴板粘贴
• 会话持久性 — 自动保存/加载 Cookie 于重启之间
• Cookie 管理 — 获取/设置/保存/加载，Netscape格式导入/导出
• 网络跟踪 — 捕获所有请求URL、类型、大小（仅限Chromium）
• 截图 — 视口或全页PNG，PDF导出
• 无障碍树 — ARIA 角色与名称
• 跨设备 — 自动适应任何安卓设备的真实配置

Termux Browser Pilot v0.17.1

Real browser automation for Termux/Android. No root required.

Firefox (default) or Chromium on Xvfb — runs entirely on your phone. Firefox passes Cloudflare natively via TLS fingerprint. Chromium uses CDP stealth. Both use real device hardware info.

Features

• Persistent daemon — browser stays running, sub-second commands
• Passes Cloudflare — Firefox: instant TLS-based pass; Chromium: Turnstile handler
• No automation framework — Firefox controlled via xdotool + clipboard JS execution
• AI-friendly — --json flag on all commands for structured output
• Real device fingerprint — auto-detects screen, GPU, CPU, arch, model
• Human-like input — Bezier curve mouse, realistic typing, clipboard paste
• Session persistence — auto-save/load cookies across restarts
• Cookie management — get/set/save/load, Netscape format import/export
• Network tracking — capture all request URLs, types, sizes (Chromium only)
• Screenshots — viewport or full page PNG, PDF export
• Accessibility tree — ARIA roles and names
• Cross-device — auto-adapts to any Android device’s real specs
• Smart element targeting — find clickable elements by visible text
• Idle timeout — auto-shutdown daemon after configurable inactivity
• Tab management — open, close, switch between browser tabs
• Proxy support — HTTP/SOCKS5 proxy for Firefox and Chromium
• Request interception — block URLs/domains via JS fetch/XHR hooks
• Multi-step macros — chain commands into reusable JSON scripts
• Console log capture — capture console.log/warn/error/info output
• Download management — auto-download files to ~/.tbp/downloads/
• Network request log — capture URLs, types, durations, sizes
• DOM mutation observer — watch for element changes in real-time
• Element screenshot — capture specific elements by CSS selector
• Drag and drop — smooth mouse drag between elements or by offset
• Iframe support — list, eval, text, click inside same-origin iframes
• File upload — set files on input[type=file] via JS DataTransfer
• Geolocation spoofing — override navigator.geolocation coordinates
• User agent switching — optional override (default: real browser UA)
• Cookie injection — set cookies with domain, path, secure, SameSite
• Local/session storage — get, set, remove, clear, list items
• Clipboard access — read/write Xvfb system clipboard
• Form auto-fill — fill all form fields from JSON spec
• Lightweight — no Puppeteer/Playwright dependency

Quick Start

Install

bash setup.sh

# Or manually:
pkg install tur-repo x11-repo
pkg install firefox xorg-server-xvfb xdotool xclip openbox python3
pip install websockets  # only needed for Chromium mode

CLI (Daemon Mode — Recommended)

Browser starts once, stays running. Commands are instant.

# Navigate (auto-starts daemon on first command)
tbp goto https://example.com