https://github.com/friskisgit/debloater-for-android
CLI tool to remove bloated packages from Android systems
https://github.com/friskisgit/debloater-for-android
Last synced: 4 months ago
JSON representation
CLI tool to remove bloated packages from Android systems
- Host: GitHub
- URL: https://github.com/friskisgit/debloater-for-android
- Owner: FriskIsGit
- License: unlicense
- Created: 2022-05-21T22:23:39.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-08-31T23:24:42.000Z (9 months ago)
- Last Synced: 2025-09-01T00:29:16.356Z (9 months ago)
- Language: Java
- Homepage:
- Size: 125 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Desktop package manager for android
Root privileges are not required for the uninstaller to work
Most packages in the list are from google, xiaomi and samsung.
### Requirements:
```
- JDK 8 or higher
- adb (Android Debug Bridge, part of platform tools)
```
### Platform tools download links:
From:
https://developer.android.com/studio/releases/platform-tools
- Windows: https://dl.google.com/android/repository/platform-tools-latest-windows.zip
- Linux: https://dl.google.com/android/repository/platform-tools-latest-linux.zip
- Mac: https://dl.google.com/android/repository/platform-tools-latest-darwin.zip
**Important:**
>
> Before running make sure that your device has USB debugging enabled (found in developer options),
> the device will prompt for authorization, check `Always allow from this computer` and select `OK`
>
> If you've done this correctly your device should appear in the list of connected devices (run `adb devices`)
>
> If your system does not have proper drivers to communicate with or recognize an Android device
> you can download them from this website: https://developer.android.com/studio/run/win-usb
## How to run from terminal
```bash
# Clone this repository
$ git clone https://github.com/FriskIsGit/debloater-for-android
# Navigate to project's root
$ cd debloater-for-android
# On Linux run to compile & run
$ ./rerun.sh
# On Windows run to compile & run
$ rerun.bat
```
## Debloat commands
All the apps uninstalled in the process will be dumped to a file,
so the operation can be reversed by running `debloat-undo`
```
debloat Uninstalls packages listed in packages.txt
debloat-full "debloat" but also deletes package data
debloat-undo "debloat" but reversed
```
## Exports/Imports
Exporting all user apps to directory `apps`
```shell
./run export --type user --dir apps
```
importing from directory
```shell
./run import --dir apps
```
It's possible to export app data (both ADB root and SU are supported)
```shell
./run export-data com.package.name
```
and import with
```shell
./run import-data com.package.name
```
but the use is limited if the app uses (hardware-backed) Android Keystore.
Simply clearing app's data from settings causes the OS to reset the data for this app in the keystore as well,
making the backup useless.
## ADB compatibility
Refer to release notes: https://developer.android.com/tools/releases/platform-tools
You can download specific versions of platforms tools by modifying this url:
https://dl.google.com/android/repository/platform-tools_r34.0.4-windows.zip
version 34.0.5 (October 2023) and above come bundled with new DbC interface for ChromeOS
which may cause adb to crash on older systems