ADB App Manager & Cleaner

A lightning-fast, visually appealing Terminal UI (TUI) to manage and clean up Android applications via ADB.

---

🚀 Overview

ADB App Manager provides an interactive, beautiful Terminal UI for managing apps installed on your Android device. It intelligently identifies third-party applications, pulls real-time usage statistics (identifying apps you haven't used in months), and dynamically fetches friendly, human-readable app names covering thousands of popular apps on the Play Store.

Alternatively, use the CLI Cleaner (DeviceCleanerAndroid.py) to quickly detect and uninstall unused apps automatically.

✨ Features

• 📊 Smart Usage Tracking: Instantly flags apps that haven't been opened for months (or never used!).
• 🏷️ Dynamic Friendly Names: Resolves cryptic package names (e.g., com.zhiliaoapp.musically) into human-readable app names (TikTok) via a vast internal dictionary and dynamic Play Store lookup.
• 🎨 Beautiful TUI: Built with textual to provide a fast, mouse-friendly, responsive interface in your terminal.
• 🛡️ Safe by Default: Explicitly ignores system/core Android packages to prevent accidental damage.
• 📦 Batch Operations: Select multiple apps and uninstall them safely with a single keystroke.

🛠️ Installation

Prerequisites

• Python 3.10+
• adb (Android Debug Bridge) installed and added to your system PATH
• An Android device with USB Debugging enabled

Via Homebrew (macOS / Linux)

brew tap ZahinTapadar/tap
brew install adb-app-manager

Note: Homebrew automatically manages ADB (android-platform-tools) and seamlessly configures the Python environment for you.

Manual Installation

git clone https://github.com/ZahinTapadar/adb-app-manager.git
cd adb-app-manager
pip install -r requirements.txt

🎮 Usage

Make sure your Android device is connected and authorized (adb devices).

1. The Interactive TUI (Recommended)

Launch the beautifully designed interactive textual interface via the Homebrew command:

adb-app-manager

Keybindings:

• Space: Toggle selection of the highlighted app
• A: Select all apps that have NEVER been used
• Ctrl+A: Deselect all apps
• U: Uninstall selected apps
• R: Reload the app list
• Q: Quit

2. The CLI Cleaner

If you prefer a fast, automated approach that detects apps unused for over 90 days:

python DeviceCleanerAndroid.py

Note: For safety, the script will output a confirmation prompt before performing any uninstallation.

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page if you want to contribute.

📄 License

This project is MIT licensed.