This is a simple script, written in Python, which is supposed to safely remove bloatware from Xiaomi's HyperOS ROM using adb.
I do not assume responsibility for any side effects resulting from the app. While it is designed to perform all functions safely and enables the removal of only a minimal portion of packages generally recognized as safe to delete, I cannot guarantee how a device will respond.
Microsoft Defender and a few other antivirus programs might mistakenly identify this app as a virus. It's important to note that this app is not a virus and you can look up the whole code in this repo. The potential cause for this false detection could be related to the app's use of ADB (Android Debug Bridge).
Before running the script, make sure that you're phone is connected to the PC via USB cable, the USB debugging is enabled in the settings, and if you authorized your PC to use USB debugging with your phone. You can check if your phone is being detected, by using adb devices.
On Debian-based distros, you can install adb using sudo apt install adb.
On Arch-based distros, you can install adb using sudo pacman -S android-tools
On Windows, you'll have to manually download adb software and usb android drivers.
While running the script for the first time, it will create the config.json file. you can modify the file, to include as many packages as you want.
To enable USB debugging in Hyper OS, firstly you have to enable developer options. To do that, go to settings > about phone and click 7 times on "OS version". Then, go back to the settings main page, and go to advanced settings. Scroll down, and you should see developer options. Open developer options, and scroll down to "USB debugging" option. Enable it.
Just download the file from the releases page, run ./hos-debloater on your Linux distro.
WARNING! Don't run the file by doubleclicking it, since it won't start in CLI mode, and you won't be able to do anything, but the program will be running in the background.
Just download the .exe file from the releases page, and run it.
In case you're getting some errors on Linux, check whether 'adb' is installed, and whether the user you're using to run this script is inside a Linux plugdev group. In case it isn't, you can add your user to this group by running sudo usermod -aG plugdev username.
If such a group doesn't exist, you can also try rebooting the system.
