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