CodeMirror/universal-android-debloater
1
0
Fork 0
mirror of https://gitlab.com/W1nst0n/universal-android-debloater.git synced 2024-05-20 06:52:20 +12:00
Code Issues Releases Wiki Activity

README Overhaul

Browse source
This commit is contained in:
w1nst0n 2020-02-06 17:36:36 +01:00
parent 888df67571
commit beb2b17e98
1 changed files with 45 additions and 34 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

79
README.md
View file

@ -1,58 +1,63 @@
# Universal Android Debloater
**DISCLAIMER** : Use this script at your own risk. I am not responsible for anything that could happen to you. Don't eat it ! It is not comestible.
**DISCLAIMER**: Use this script at your own risk. I am not responsible for anything that could happen to your phone.
But don't worry. This script *should* be safe as long as you only use my default apps selection and the last stable release. The worse thing which could happen is preventing an essential system process to be loaded during boot causing then an unfortunate bootloop. After about 5 failed system boots, the phone will automatically reboot in recovery mode and you'll have to perform a FACTORY RESET.
## Summary
I try to provide and maintain a universal tool which remove bloatwares on any unrooted Android phones.
The main goal is to improve battery performance and privacy by limiting the tracking from preinstalled apps. The script has a menu that lets you choose what debloat list you want to use. I strongly encourage you to take a look at the lists because some apps are commented out by default. All packages are as well documented as possible in order to provide the a better understanding of what you can delete or not.
This script *should* be safe with the default selection. The worse thing which could happen is preventing an essential system process to be loaded during boot causing then an unfortunate bootloop. After about 5 failed system boots, the phone will automatically reboot in recovery mode and you'll have to perform a FACTORY RESET.
In any case, you can NOT brick your device with this script ! That's the main thing, right ? :smiley:
**Don't forget to backup importants things before doing anything ! You can never be too careful !**
## Features :
## Features
* [X] Quick search among all the packages of your phone
* [X] Uninstall any system/user package
* [X] Reinstall system packages
* [X] ADB backup (see FAQ)
* [X] device brand detection and auto-selection of the appropriate debloat list
* [X] Uninstallation of system/user packages (manually or with the debloat lists)
* [X] Reinstallation of system packages
* [X] ADB backup (not really reliable, see the FAQ)
* [X] Device brand detection and auto-selection of the appropriate manufacturer debloat list
* [X] Logs in `debloated_packages.txt` and `remaining_packages.txt`.
* [ ] Installation of alternative open-source apps replacing stock apps (list in the WIKI section) (WIP)
NB : It is not a real uninstallation for system apps (see the [FAQ](https://gitlab.com/W1nst0n/universal-android-debloater/-/wikis/FAQ))
NB : It is NOT a real uninstallation for system apps (see the [FAQ](https://gitlab.com/W1nst0n/universal-android-debloater/-/wikis/FAQ))
## Universal debloat lists :
## Universal debloat lists
* [X] GFAM (Google/Facebook/Amazon/Microsoft)
* [X] Manufacturer bloat
* [X] AOSP bloat
* [X] Manufacturers bloat
* [X] Mobile carriers bloat
* [X] Miscellaneous bloat
## Manufacturers debloat lists:
## Manufacturers debloat lists
* [ ] Archos
* [X] Asus
* [X] LG
* [X] Google
* [ ] HTC
* [X] Huawei
* [ ] Motorola
* [X] Motorola
* [X] Nokia
* [ ] OnePlus
* [X] OnePlus
* [X] Samsung
* [X] Sony
* [ ] Wiko
* [X] Xiaomi
* [ ] ZTE
## Phone carriers debloat lists :
- France
* [ ] Free
* [ ] SFR
* [ ] Orange
* [ ] Bouygues Telecom
- USA
* [X] T-Mobile
* [X] Verizon
* [ ] AT&T
## Mobile carriers debloat lists
## How to use it :
|**France** | **USA** |**Germany** |
|:---------------:|:--------:|:----------:|
| Orange | T-Mobile | Telekom |
| SFR | Verizon | |
| Free | Sprint | |
| Bouygues / Sosh | AT&T | |
## How to use it
- **Read the [FAQ](https://gitlab.com/W1nst0n/universal-android-debloater/-/wikis/FAQ) !!**
- **Do a proper backup of your data ! You can never be too careful !**
- Enable *Developer Options* on your smartphone.
- Turn on *USB Debugging*.
@ -61,24 +66,30 @@ NB : It is not a real uninstallation for system apps (see the [FAQ](https://gitl
Debian Base :
```console
apt-get install android-sdk-platform-tools
apt-get install android-sdk-platform-tools
```
Arch-Linux Base :
```console
pacman -S android-tools
```
- Go to the release section and download the .zip file.
- Execute *debloat_script.sh* et voilà !
```
- Go to the release section, download the lastest release and enjoy :
```
bash debloat_script.sh
```
### WINDOWS
- Install [WSL (Windows Subsystem for Linux)](https://itsfoss.com/install-bash-on-windows/) in order to be able to use bash script.
- Install [ADB](https://dl.google.com/android/repository/platform-tools-latest-windows.zip). If you want ADB support everywhere on your PC, you need to add the path of ADB folder in the system variables (see [this](https://www.xda-developers.com/adb-fastboot-any-directory-windows-linux/)).
- Go to the release section and download the .zip file.
- Execute *debloat_script.sh* from the Ubuntu bash shell et voilà !
- Go to the release section and download the lastest release.
- Execute the script from the Ubuntu bash shell et voilà !
```
bash debloat_script.sh
```
- **Don't forget to check the debloat lists to see what are my default choices and to avoid any bad surprises.**