# IIAB-oA Controller

**IIAB-oA Controller** is a specialized infrastructure component for the **Internet-in-a-Box (IIAB)** ecosystem on Android. It acts as a "Walled Garden" and persistent "Watchdog" designed to keep the Termux environment alive and accessible, even on devices with aggressive power management (e.g., Oppo/ColorOS, MIUI).

## Core Capabilities

### 🛡️ Master Watchdog (Supervision Layer)
An independent foreground service dedicated to environment stability:

*   **CPU & Wi-Fi Shield**: Prevents the system from putting Termux into Doze mode or disabling the Wi-Fi radio.
*   **Heartbeat Pulse**: Sends a regulated API signal every 20 seconds to maintain process priority.
*   **Zero-Config Protection**: Works independently of the VPN tunnel.

### 🌐 Safe Pocket Web (Network Layer)
A high-performance VPN tunnel based on the tun2socks engine:

*   **Friendly URLs**: Routes traffic through internal IIAB services seamlessly.
*   **Walled Garden**: Ensures a secure, filtered browsing environment.
*   **Per-App Routing**: Granular control over which applications use the secure tunnel.

### 🔒 Built-in Security
*   **Biometric/PIN Lock**: Authentication is strictly required before the Watchdog or VPN can be disabled.
*   **Safety Check**: Prevents activation if the device lacks a secure lock method (PIN/Pattern/Fingerprint), ensuring the user is never "locked out" of their own settings.

## Acknowledgments
This project is a heavily customized spin-off of **[SocksTun](https://github.com/heiher/sockstun)** created by **[heiher](https://github.com/heiher)**. 
All credit for the core native tunneling engine goes to the original author. This derivative has been re-architected to meet the specific requirements of the IIAB project.

## Technical Details
*   **Current Version**: v0.1.12alpha
*   **License**: **MIT License** (See [LICENSE](LICENSE) for details).
*   **Compatibility**: Android 8.0 (API 26) and above.

## Disclaimer
This is a preview and demo published in the hope that it will be useful, but WITHOUT ANY WARRANTY.

---
*Maintained by IIAB Contributors - 2026*
