A modern web-based tool for safely removing bloatware from Android devices using ADB (Android Debug Bridge). Built with FastAPI and Bootstrap 5, providing a user-friendly interface for package management.
- 🔌 Easy Device Connection: Simple ADB pairing with IP address and port
- 📦 Package Management: View all installed packages on your device
- ⚡ Bulk Operations: Select multiple packages for disable/uninstall actions
- 🛡️ Safe Operations: Built-in warnings and confirmation for system packages
- 📱 Responsive Design: Modern Bootstrap 5 interface that works on all devices
- 🔍 Real-time Status: Live feedback on operation success/failure
- 🎨 Beautiful UI: Clean, professional interface with Bootstrap components
Users can directly download the binaries from the release page and do the following steps. Our project has been downloaded 
chmod +x ./bloatware-remover
./bloatware-removerIf you see “App is damaged or can’t be opened” / “Developer cannot be verified”:
-
Method A (recommended):
- Right-click the app (or binary) → Open
- Click “Open”
- Or go to System Settings → Privacy & Security → scroll to “Security” → click “Allow Anyway”, then run again
-
Method B (terminal):
xattr -d com.apple.quarantine ./bloatware-remover
./bloatware-remover- Enable Developer Options on your Android device
- Enable USB Debugging and Wireless Debugging
- Note your device's IP address and port from the wireless debugging settings
- Enter the IP address, port, and pairing code in the web interface
- Click "Connect to Device"
- Once connected, you'll see a list of all installed packages
- Select actions for each package:
- No action: Leave package unchanged
- Disable: Disable the package (can be re-enabled later)
- Uninstall: Remove the package completely
- Use bulk action buttons for quick selection
- Click "Apply Actions" to execute your changes
- View operation results and any failed actions
- Navigate back to package management or connection
No environment variables are required for basic usage. The application uses default settings suitable for most use cases.
Ensure ADB is properly configured:
# Check if ADB is available
adb version
# Start ADB server
adb start-server- Android devices with ADB support
- Devices running Android 4.0+ (API level 14+)
- Both USB and wireless debugging connections
- System Packages: Be careful when disabling system packages as they may be essential for device functionality
- Backup: Consider backing up your device before making changes
- Research: Research packages before disabling/uninstalling to avoid breaking system functionality
- Requires ADB access to the device
- Some packages may be protected and cannot be modified
- Wireless debugging requires device and computer on same network
- Python 3.8 or higher
- ADB (Android Debug Bridge) installed and in your PATH
- Android device with USB debugging enabled
- Device connected to the same network as your computer
-
Clone the repository
git clone https://github.com/prithvitewatia/bloatware-remover.git cd bloatware-remove -
Create a virtual environment
python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
-
Install dependencies
pip install -r requirements.txt
-
Run the application
python -m uvicorn src.main:app --reload --host 0.0.0.0 --port 8000
-
Open your browser Navigate to
http://localhost:8000
bloatware-remove/
├── src/
│ ├── main.py # FastAPI application entry point
│ ├── routes.py # API routes and request handling
│ ├── bloatware_removal.py # Core business logic
│ └── templates/ # HTML templates with Bootstrap 5
│ ├── base.html # Base template with navigation
│ ├── connect.html # Device connection interface
│ ├── packages.html # Package management interface
│ ├── status.html # Operation status display
│ └── components/ # Reusable template components
├── tests/ # Test files
└── requirements.txt # Python dependencies
- ConnectionManager: Handles ADB device pairing
- PackageManager: Manages package operations (list, disable, uninstall)
- CommandManager: Executes ADB commands safely
- Web Interface: Modern Bootstrap 5 templates with responsive design
- FastAPI: Modern web framework for building APIs
- Uvicorn: ASGI server for running FastAPI applications
- Jinja2: Template engine for HTML rendering
- python-multipart: Form data parsing
We welcome contributions! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- FastAPI for the excellent web framework
- Bootstrap for the beautiful UI components
- Android Debug Bridge for device communication
If you encounter any issues or have questions:
- Check the Issues page
- Create a new issue with detailed information
- Include your device model, Android version, and error messages
If you find this tool helpful, consider supporting its development:
- GitHub Sponsors: Sponsor @prithvitewatia
- PayPal: Donate via PayPal
- Apple Developer License ($99/year) - Remove macOS Gatekeeper warnings
- Build and ship new and exciting features
Disclaimer: This tool is provided as-is. Use at your own risk. The authors are not responsible for any damage to your device or data loss.