BloatwareHatao is a unified Android package management and device optimization toolkit built with a high-performance Rust core and an asynchronous execution engine. It provides a case-driven TUI workspace alongside a clean CLI, enabling users to perform package inspection, safety scoring, batch debloating, custom presets management, and wireless ADB configurations from a single modular terminal environment.
The platform integrates advanced capabilities including a local database of 5,000+ package definitions, OEM classification filters, granular rescue and restore points, real-time device health metrics, and modern Android safety ratings. BloatwareHatao supports modern Android ecosystems, including system package disablement constraints, OEM-specific behavior, and wireless debugging connections.
With a growing ecosystem of package categories and safety ratings, BloatwareHatao enables developers and power users to orchestrate complex Android debloating operations and restore devices to a clean, performant state within one unified environment.
Connect your device and begin optimizing your Android system.
- Rust Primitives: Rust powers the entire application from CLI option parsing to terminal drawing.
- Async Engine: High-performance asynchronous ADB orchestration keeps the UI responsive during long device scans.
- Local Registry: Bundles a rich, offline-first JSON registry detailing 5,000+ package profiles, categories, and safety ratings.
macOS Apple Silicon is distributed through the Homebrew tap. The formula installs Android platform-tools automatically.
brew tap ImKKingshuk/tap
brew install bloatwarehataoWindows x64 is distributed through the Scoop bucket. Install Android platform-tools separately if you need ADB-driven workflows.
scoop bucket add imkkingshuk https://github.com/ImKKingshuk/scoop-bucket
scoop install imkkingshuk/bloatwarehataobloatwarehatao# Print connected device information
bloatwarehatao --device-info
# List installed packages
bloatwarehatao --list-packagesbloatwarehatao --dry-run- TUI is the main product and default experience. Use
bloatwarehataofor day-to-day investigations, interactive package browsing, profile preset selection, and operator-guided debloating. - Headless CLI is the secondary surface. Use
bloatwarehatao --list-packagesorbloatwarehatao --device-infofor quick checks, scripting, automation, and headless environments.
| Action | Keys |
|---|---|
| Navigate | Arrow keys, j, k |
| Select/confirm | Enter |
| Back/quit current screen | q, Esc |
| Search packages | / |
| Clear search | c |
| Toggle package selection | Space |
| Refresh package list | r |
| Page navigation | PgUp, PgDn, g, G |
| Help | ? |
| Force quit | Ctrl + C |
| Mode | Best for | Command |
|---|---|---|
| TUI (primary) | Interactive package selection, batch uninstalls, preset reviews, backup restoration, and configuration editing | bloatwarehatao |
| CLI / headless (secondary) | Quick device posture checks, pipeline automation, scripting, and offline queries | bloatwarehatao --list-packages |
BloatwareHatao is designed as a guided operator workspace that spans classification, batch processing, safety safeguards, and device metrics. The tools below are still valuable, but they solve narrower slices of the Android debloating workflow.
| Tool | Primary strength | Main surface | Best at | Gaps relative to BloatwareHatao |
|---|---|---|---|---|
| BloatwareHatao | Unified terminal workspace for device audits, package classification, and batch operations | Terminal TUI + CLI | Managing package uninstalls, safety ratings, custom presets, and rescue logs from a single terminal interface | N/A |
| UAD | Cross-platform desktop GUI for debloating | Desktop GUI (GTK/Qt) | Normalizing debloat lists into an easy-to-use desktop application | No TUI interface, no integrated CLI for headless checks, lacks built-in terminal wireless ADB configs |
| ADB CLI | Low-level command-line execution | CLI shell | Raw uninstalls (pm uninstall) and low-level debugging |
No package database, no safety ratings, no visual selection UI, no safety nets (automatic rescue points) |
| Android Settings | Built-in system management UI | Mobile touchscreen | Basic user app deletion and cache clearing | Cannot uninstall system packages, tedious one-by-one flow, no batch debloating, no preset profiles |
| Capability | BloatwareHatao | UAD | ADB CLI | Android Settings |
|---|---|---|---|---|
| Terminal TUI operator dashboard | ✅ Native | ❌ | ❌ | ❌ |
| Headless CLI automation / scripting | ✅ | ❌ | ✅ | ❌ |
| Bundled database of 5,000+ package records | ✅ | ✅ | ❌ | ❌ |
| Safety Ratings classification (Recommended to Danger) | ✅ | ✅ | ❌ | ❌ |
| Automatic rescue point & removal session history | ✅ | ❌ | ❌ | |
| Real-time device health metrics (RAM, storage, temp) | ✅ | ❌ | ||
| Custom Profile & Preset imports/exports | ✅ | ✅ | ❌ | ❌ |
| Wireless ADB configuration helper | ✅ | ❌ |
| Icon | Status | Meaning |
|---|---|---|
| ✅ | production-ready |
Stable core workflow with strong local/offline behavior |
| 🔧 | functional |
Useful and working, with practical constraints |
| 🔬 | best-effort |
Works in some environments, but highly device/app/version dependent |
| 🚧 | experimental |
Early workflow with notable limitations |
| 🔑 | dependency-gated |
Requires optional extras, external tools, or credentials |
- ✅ High-performance Rust binary orchestrating the CLI and terminal workspace.
- ✅ Full-screen interactive TUI built with Ratatui and Crossterm for all-round operators.
- ✅ Structured configuration management loading from
config.toml. - ✅ Built-in safety guards with dry-run support, automatic backups, and removal confirmations.
- ✅ Platform-appropriate configurations for Linux, macOS, and Windows.
- ✅ Clean error handling with project-specific diagnostics and structured logging.
- ✅ Asynchronous command execution loops for high-speed ADB communication.
- ✅ High-speed package name mapping and OEM classification engine.
- ✅ Multi-select buffer management for smooth batch uninstalls and restores.
- ✅ Dynamic memory allocation for package records with robust safety checks.
- 🔧 Async ADB checks and serial number targeting (
bloatwarehatao --device <serial>). - 🔧 Real-time Android device status detection (ready, unauthorized, offline, recovery).
- 🔧 Device OEM extraction to tailor database categorization.
- 🔧 Wireless ADB configuration helper with automated IP scanning.
- ✅ Current-user system package uninstalls (
pm uninstall --user 0). - ✅ Package disablement (
pm disable-user) and enablement (pm enable). - 🔧 Package data clearing (
pm clear) to regain storage. - ✅ Bulk/batch execution on selected rows.
- ✅ Reinstallation of uninstalled system apps (
cmd package install-existing).
- ✅ 5,089 unique package records bundled directly.
- ✅ 36 categories covering major OEMs (Samsung, Google, Xiaomi, Huawei, OnePlus, Oppo, Vivo, Motorola, etc.) and subsystems (Carrier, Chipset, AOSP, Ads).
- ✅ Safety ratings ranging from Recommended to Danger.
- ✅ Live search and categorization filtering within the TUI.
- 🔧 Built-in presets for Privacy, Performance, De-Google, and Social Media cleanup.
- 🔧 Custom profile creation, editing, and deletion.
- 🔧 JSON preset import and export for sharing optimization templates.
- ✅ Automatic rescue point generation before starting batch removals.
- ✅ Removed session logs detailing timestamp, operation type, and package status.
- ✅ Dynamic restoration from rescue logs or package lists.
- 🔧 Real-time battery status, level, and temperature checks.
- 🔧 Active RAM memory usage (Free, Used, Total) representation.
- 🔧 Storage partition space (System, Data) utilization.
- 🔬 Wireless TCP/IP mode activation on port 5555.
- 🔬 Automated local IP detection and connecting workflows.
| Rating | Meaning |
|---|---|
| User Installed | App installed by the user. Safe to remove if desired. |
| Recommended | Safe to remove. Intended for common bloatware with no known critical dependencies. |
| Advanced | May affect certain device features. Review description before removing. |
| Unsafe | Can break basic system functionality. Only for experienced users. |
| Danger | Critical system component. Avoid removal unless you know exactly what you are doing. |
- OS: macOS, Linux, or Windows.
- ADB: Android platform-tools (
adb) installed and available on systemPATH. - Device: Android device with USB debugging enabled and computer authorized.
- Rust: Required to build from source (stable toolchain).
- No Telemetry: BloatwareHatao operates entirely offline. No data is collected, and no network calls are made.
- Local Action: Device interaction is restricted to local ADB commands executed on the host machine.
- Non-Destructive Defaults: Includes dry-run support, removal confirmations, and automatic rescue points before uninstalls.
- Authorization: Only authorize ADB connections from hosts you fully trust. Keep USB debugging disabled when not in use.
BloatwareHatao : The Ultimate Android Bloatware Removal Tool is developed for research, customization, and educational purposes. It should be used responsibly and in compliance with all applicable laws and regulations. The developer of this tool is not responsible for any misuse, bricked devices, data loss, or illegal activities conducted with this tool.
Removing system packages can impact device stability and safety updates. Ensure proper backups are created and review package safety ratings before initiating bulk operations. Always adhere to best device management practices.
This project is licensed under the GPL-3.0-only License. See LICENSE for details.