Logo

Termux-Playwright

v1.61.3 (Dual Engine)
PyPI (Python) npm (Node.js) 💖 Sponsor GitHub Repository

Android 12~14+ Phantom Process Killer: Technical Guide

Android 12+ limits background apps to 32 child processes. Exceeding this limit causes Android to kill Termux with SIGKILL (signal 9).

Solution 1: In-App Single-Process Mode (No Root / No ADB Required)

Simply enable single_process=True (Python) or singleProcess: true (Node.js) when launching the browser:

Python:

browser = await launch(p, headless=True, single_process=True)

Node.js:

const browser = await launch({ headless: true, singleProcess: true });

Solution 2: Permanent ADB Disable (One-Time Setup)

Connect your phone to a PC via USB Debugging or Wireless ADB, and run this command once:

adb shell "/system/bin/device_config put activity_manager max_phantom_processes 2147483647"
adb shell "/system/bin/device_config set_sync_disabled_for_tests persistent"